顧名思義,External 是「外部的」,Accessory 是「配件」,ExternalAccessory 就是負責跟外部硬體打交道的那個框架。
這個框架讓 App 能與 Lightning 介面的硬體,或藍牙 2.1 裝置建立連線並通訊(30-pin 介面的裝置理論上也支援,只是現在幾乎看不到了)。
舉例來說,如果你手上有一副 Lightning 耳機(iPhone 7/7 Plus 那種),或一台藍牙 2.1 的音箱,想寫一個 App 去控制它,要用的就是 ExternalAccessory。實際案例包括藍牙音箱的燈光音效控制 App,以及 Lightning 耳機的簡單控制與固件升級工具。
ExternalAccessory 主要提供一條管道,讓週邊裝置能與 iOS 裝置溝通。三個關鍵類別是:
連接與斷開其實都由系統自動完成。EAAccessoryManager 的 connectedAccessories 是一個陣列,裡頭就裝著所有已連接的週邊裝置;裝置名稱、製造商、硬體型號、固件版本等資訊,都能從 EAAccessory 物件上讀到。
不過框架不會自動幫你監控狀態變化,想拿到回調就得自己寫:
// 註冊通告
[[EAAccessoryManager sharedAccessoryManager] registerForLocalNotifications];
// 監聽連接事件
[[NSNotificationCenter defaultCenter] addObserverForName:EAAccessoryDidConnectNotification
object:nil queue:nil usingBlock:^(NSNotification * _Nonnull note) {
// 從已連接的週邊裝置中找出我們的裝置
[self searchOurAccessory];
}];
// 監聽斷開事件
[[NSNotificationCenter defaultCenter] addObserverForName:EAAccessoryDidDisconnectNotification
object:nil queue:nil usingBlock:^(NSNotification * _Nonnull note) {
// 在這裡處理斷開後的清理工作
}];
除了通告,框架也提供了 Delegate 方式:遵守 EAAccessoryDelegate 協議並實作 accessoryDidDisconnect:,同樣能收到斷連回調。
既然裝置可能同時接了好幾台,怎麼知道哪一台才是自己的?蘋果把這個辨識用的識別碼稱為「協議」,本質上就是一個反向網域格式的字串,例如 com.apple.myProtocol。這串字串由硬體製造商定義,App 開發者需要向廠商索取。
因此要做三件事:
#import <ExternalAccessory/ExternalAccessory.h>UISupportedExternalAccessoryProtocols 這個 key,值設為協議名稱(實際上是陣列,可支援多個協議且不分順序)。- (void)searchOurAccessory {
NSMutableString *info = [[NSMutableString alloc] init];
for (EAAccessory *accessory in [EAAccessoryManager sharedAccessoryManager].connectedAccessories) {
if ([kSPKLightingHeadphoneProtocolString isEqualToString:[accessory.protocolStrings firstObject]] == YES) {
// 協議吻合,這就是我們要找的裝置
for (NSString *proStr in accessory.protocolStrings) {
[info appendFormat:@"protocolString = %@\n", proStr];
}
[info appendFormat:@"\n"];
[info appendFormat:@"manufacturer = %@\n", accessory.manufacturer];
[info appendFormat:@"name = %@\n", accessory.name];
[info appendFormat:@"modelNumber = %@\n", accessory.modelNumber];
[info appendFormat:@"serialNumber = %@\n", accessory.serialNumber];
[info appendFormat:@"firmwareRevision = %@\n", accessory.firmwareRevision];
[info appendFormat:@"hardwareRevision = %@\n", accessory.hardwareRevision];
// Log...
}
}
}
補充一個小技巧:連接通告的 Block 參數 note 本身就帶著 EAAccessory 物件,可以透過 EAAccessoryKey 直接取出來比對協議字串,不必再遍歷整個 connectedAccessories 陣列。
App 與裝置之間的資料流,靠的是 NSInputStream 與 NSOutputStream,而這兩者正是 EASession 的屬性。所以要先建立 EASession,等於打開傳輸通道:
@interface YourClass () <NSStreamDelegate>- (BOOL)openSession {
self.session = [[EASession alloc] initWithAccessory:self.accessory
forProtocol:kSPKLightingHeadphoneProtocolString];
if (self.session != nil) {
self.session.inputStream.delegate = self;
[self.session.inputStream scheduleInRunLoop:[NSRunLoop mainRunLoop] forMode:NSDefaultRunLoopMode];
[self.session.inputStream open];
self.session.outputStream.delegate = self;
[self.session.outputStream scheduleInRunLoop:[NSRunLoop mainRunLoop] forMode:NSDefaultRunLoopMode];
[self.session.outputStream open];
} else {
NSLog(@"Failed to create session");
}
return (nil != self.session);
}
接著用 delegate 回調判斷何時該讀、何時可寫:
- (void)stream:(NSStream *)aStream handleEvent:(NSStreamEvent)eventCode {
switch (eventCode) {
case NSStreamEventHasBytesAvailable:
// 裝置傳來資料了,依協議定義解析
[self readFromDevice];
break;
case NSStreamEventHasSpaceAvailable:
// 可以往裝置寫資料了
[self writeToDevice];
break;
case NSStreamEventErrorOccurred:
case NSStreamEventEndEncountered:
default:
break;
}
}
其中 HasBytesAvailable 代表串流裡有資料待讀(裝置發資料給 App),HasSpaceAvailable 代表可以寫入(App 發資料給裝置)。不過並非每次都得等這個回調,你也可以直接判斷屬性:
BOOL isAvailable = self.session.outputStream.hasSpaceAvailable;
if (isAvailable == YES) {
[self writeToDevice];
}
實際的讀寫方法很單純:
// 送出 [self.session.outputStream write:[self.writeData bytes] maxLength:self.writeDataLen]; // 接收 [self.session.inputStream read:buffer maxLength:SPK_INPUT_DATA_BUFFER_LEN];
開發 Lightning 配件的 App 時有個死結:手機接了硬體就沒法接電腦除錯,接了電腦就沒法測硬體。論壇與 Stack Overflow 都沒有好解法,最後我把要輸出的日誌收集起來,用一個 TextView 顯示在 App 上充當除錯面板。

把 Log 搬到 App 界面上除錯,雖是權宜之計,卻意外好用。若內容有誤,歡迎指正。