最近在做一个「搖動手機觸發某個功能」的需求。上網搜了一下,發現低品質的文章不少,大量轉抄卻沒把原理講清楚。與其花時間篩選,不如直接翻開發文件,其實很快就能解決。
iOS SDK 早就把 shake 事件整合進事件系統了。它不是額外的 API,而是 motion event 的一個 subtype——就像 UITouch 系列事件一樣,透過 responder chain 傳遞。因此你只要讓自己的視圖控制器成為「第一響應者」,就能收到通知。
系統會依狀態自動呼叫三個方法:
- (void)motionCancelled:(UIEventSubtype)motion withEvent:(UIEvent *)event
- (void)motionBegan:(UIEventSubtype)motion withEvent:(UIEvent *)event
- (void)motionEnded:(UIEventSubtype)motion withEvent:(UIEvent *)event
多數情境只需要在 motionEnded: 裡寫你要的功能即可。
- (BOOL)canBecomeFirstResponder {
return YES;
}
- (void)viewDidAppear:(BOOL)animated {
[super viewDidAppear:animated];
[self becomeFirstResponder];
}
這裡有個常被寫錯的地方:範例常看到 [self canBecomeFirstResponder],但那是「詢問能不能」的查詢方法,它不會真的把自己設為第一響應者。正確做法是呼叫 becomeFirstResponder。另外記得要在 viewWillDisappear: 裡呼叫 resignFirstResponder,否則離開頁面後仍可能收到事件。
#pragma mark - Motion Shake Event
- (void)motionBegan:(UIEventSubtype)motion withEvent:(UIEvent *)event {
// 搖動開始,可在此播放音效或觸發視覺回饋
}
- (void)motionEnded:(UIEventSubtype)motion withEvent:(UIEvent *)event {
if (motion == UIEventSubtypeMotionShake) {
NSLog(@"Shake!!!!!!!!!!!");
// 在這裡實作你的功能
}
}
- (void)motionCancelled:(UIEventSubtype)motion withEvent:(UIEvent *)event {
// 手勢被中斷(例如來電),可在此復原狀態
}
務必檢查 motion == UIEventSubtypeMotionShake。少了這個判斷,其他 motion subtype 也會觸發同一段程式碼。
模擬器不支援真實搖動。 在模擬器上測試時,可用 Hardware → Shake Gesture 選單模擬,但真實的加速度變化只能透過實機驗證。
容易誤觸。 使用者打字、拿手機時都可能晃動。實務上會加上節流:記錄上次觸發時間,兩秒內不重複回應。
- (void)motionEnded:(UIEventSubtype)motion withEvent:(UIEvent *)event {
if (motion != UIEventSubtypeMotionShake) return;
NSTimeInterval now = [[NSDate date] timeIntervalSince1970];
if (now - _lastShakeTime < 2.0) return; // 兩秒節流
_lastShakeTime = now;
// 執行功能
}
若要更精細的控制,改用 Core Motion。 motion event 無法自訂靈敏度。若你需要「搖兩下」「搖的方向」這類判斷,應該改用 CMMotionManager 直接讀取加速度計資料,自行設定閾值與判斷邏輯。