觸摸事件包含一個或多個觸摸(touches),每個觸摸由一個 UITouch 物件表示。當觸摸發生時,系統會透過觸摸處理邏輯找到合適的 responder,並把 UIEvent 物件傳遞過去;responder 則透過 touchesBegan:withEvent: 等方法來接收該物件。
晃動設備等動作會觸發這類事件。
主要來自外部輔助設備或耳機的遠程命令,例如調整音量、切換上下一首。
/**
下面四個方法的共同參數:
@param (NSSet<UITouch *> *)touches 觸摸點集合(依觸摸點個數可判斷是幾指操作)
@param event 事件物件,記錄事件產生的時刻與類型
(下面四個方法傳入的是同一個物件)
*/
// 手指開始觸摸 view 時,系統自動呼叫
- (void)touchesBegan:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event {
}
// 手指在 view 上移動時呼叫(隨移動持續觸發)
- (void)touchesMoved:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event {
}
// 一根手指離開 view 時呼叫
- (void)touchesEnded:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event {
}
// 觸摸尚未結束,但被系統事件打斷時呼叫(例如來電)
- (void)touchesCancelled:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event {
}
UITouch 物件
- 我們用手指觸摸螢幕時,系統會建立一個與觸摸點關聯的 UITouch 物件,每個觸摸點對應一個 UITouch 實例。
- 這個物件保存了與觸摸相關的資訊:位置、時間、階段。
- 觸摸點改變(手指移動)時,系統會更新對應的 UITouch 物件,即時記錄最新狀態。
- 觸摸結束時,UITouch 物件被銷毀。
UITouch 常用方法
- 回傳當前觸摸點在 view 上的位置;傳入 nil 時位置相對於 UIWindow。
- (CGPoint)locationInView:(UIView *)view;- 回傳上一個觸摸點在 view 上的位置,常用於計算位移。
- (CGPoint)previousLocationInView:(UIView *)view;
// 開始搖晃
- (void)motionBegan:(UIEventSubtype)motion withEvent:(UIEvent *)event {
}
// 搖晃結束
- (void)motionEnded:(UIEventSubtype)motion withEvent:(UIEvent *)event {
}
// 搖晃取消
- (void)motionCancelled:(UIEventSubtype)motion withEvent:(UIEvent *)event {
}
準備工作:
先在 targets → Build Phases → Link Binary With Libraries 中加入 AudioToolbox.framework。播放音效會用到 AudioServicesPlaySystemSound 函數,它有幾個限制:
另外要注意它的局限性:無法循環播放,也無法控制立體聲效果。但可以設定一個回調函數,在音頻播放結束時被呼叫,用來清理音頻物件並通知程式播放結束。
在模擬器中測試時,可以透過「Hardware」→「Shake Gesture」來模擬搖一搖。
1. 導入音頻標頭檔
#import <AudioToolbox/AudioToolbox.h>
2. 定義播放結束的回調函數
// 音頻播放完畢時會呼叫這個函數
// 完成處理程序標籤存在 data 中,取值時需要用到 __bridge
static void SoundFinished(SystemSoundID soundID, void *data) {
/* 播放全部結束,因此釋放所有資源 */
AudioServicesDisposeSystemSoundID(soundID);
NSLog(@"%s ---> %@", __func__, (__bridge UIViewController *)data);
}
3. 開啟搖一搖功能並設定第一響應者
// 允許搖一搖功能 [UIApplication sharedApplication].applicationSupportsShakeToEdit = YES; // 設置第一響應者 [self becomeFirstResponder];
4. 在搖晃開始時播放音效
// 註冊系統音頻 ID SystemSoundID soundID; // 取得聲音檔案路徑 NSString *path = [[NSBundle mainBundle] pathForResource:@"59" ofType:@"m4a"]; NSURL *soundUrl = [NSURL fileURLWithPath:path]; // 根據路徑建立系統聲音 AudioServicesCreateSystemSoundID((__bridge CFURLRef)soundUrl, &soundID); /* 參數說明: * 1、剛剛播放完成自定義系統聲音的 ID * 2、回調函數(playFinished)執行的 run loop,NULL 表示 main run loop * 3、回調函數執行所在的 run loop mode,NULL 表示預設 mode * 4、需要回調的函數 * 5、傳入的參數,此參數會被傳入回調函數中 */ AudioServicesAddSystemSoundCompletion(soundID, NULL, NULL, SoundFinished, (__bridge void *)self); // 開始播放 AudioServicesPlaySystemSound(soundID); return;
- (void)motionCancelled:(UIEventSubtype)motion withEvent:(UIEvent *)event {
NSLog(@"取消搖動");
return;
}
- (void)motionEnded:(UIEventSubtype)motion withEvent:(UIEvent *)event {
if (event.subtype == UIEventSubtypeMotionShake) {
// 判斷是否是搖動結束
NSLog(@"搖動結束");
}
return;
}
// 依傳入的 event 進行判斷,並執行相應操作即可
- (void)remoteControlReceivedWithEvent:(UIEvent *)event {
}
還有一點實務上容易忽略:要接收到遠程控制事件,同樣需要把接收者設為第一響應者;而搖一搖能否生效,也取決於 applicationSupportsShakeToEdit 是否為 YES 以及第一響應者鏈是否正確。
文章轉自 雲之君兮鵬 的簡書