您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發基礎

iOS ExternalAccessory 框架入門:與 Lightning 與藍牙配件通訊

編輯:iOS 開發基礎

顧名思義,External 是「外部的」,Accessory 是「配件」,ExternalAccessory 就是負責跟外部硬體打交道的那個框架。

它能做什麼

這個框架讓 App 能與 Lightning 介面的硬體,或藍牙 2.1 裝置建立連線並通訊(30-pin 介面的裝置理論上也支援,只是現在幾乎看不到了)。

舉例來說,如果你手上有一副 Lightning 耳機(iPhone 7/7 Plus 那種),或一台藍牙 2.1 的音箱,想寫一個 App 去控制它,要用的就是 ExternalAccessory。實際案例包括藍牙音箱的燈光音效控制 App,以及 Lightning 耳機的簡單控制與固件升級工具。

核心類別

ExternalAccessory 主要提供一條管道,讓週邊裝置能與 iOS 裝置溝通。三個關鍵類別是:

  • EAAccessory:代表你連接的那台裝置。
  • EAAccessoryManager:重要屬性是 connectedAccessories,用來取得已連接的裝置。
  • EASession:建立通道,讓 App 與裝置之間可以傳送與接收資料。

裝置的連接與斷開

連接與斷開其實都由系統自動完成。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>
  • 在 Info.plist 加入 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,等於打開傳輸通道:

  • 遵守 NSStreamDelegate 協議,例如 @interface YourClass () <NSStreamDelegate>
  • 建立 EASession 並開啟輸入、輸出串流。
- (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 界面上除錯,雖是權宜之計,卻意外好用。若內容有誤,歡迎指正。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved