和配件進(jìn)行通訊
在iPhone OS 3.0及之后的系統(tǒng)上,External Accessory框架(ExternalAccessory.framework
)提供了一種管道機(jī)制,使應(yīng)用程序可以和iPhone或iPod touch設(shè)備的配件進(jìn)行通訊。通過這種管道,應(yīng)用程序開發(fā)者可以將配件級(jí)別的功能集成到自己的程序中。
請(qǐng)注意:下面部分將向您展示iPhone應(yīng)用程序如何連接配件。如果您有興趣成為iPhone或iPod touch配件的開發(fā)者,可以在http://developer.apple.com網(wǎng)站上找到相應(yīng)的信息。
為了使用External Accessory框架的接口,您必須將ExternalAccessory.framework
加入到Xcode工程,并連接到相應(yīng)的目標(biāo)中。此外,還需要在相應(yīng)的源代碼文件的頂部包含一個(gè)#import <ExternalAccessory/ExternalAccessory.h>
語(yǔ)句,才能訪問該框架的類和頭文件。有關(guān)如何為工程添加框架的更多信息,請(qǐng)參見Xcode工程管理指南中的工程中的文件部分;有關(guān)External Accessory框架中類的一般信息,請(qǐng)參見External Accessory框架參考。
配件的基礎(chǔ)
在和配件進(jìn)行通訊之前,需要與配件的制造商緊密合作,理解配件提供的服務(wù)。制造商必須在配件的硬件中加入顯式的支持,才能和iPhone OS進(jìn)行通訊。作為這種支持的一部分,配件必須支持至少一種命令協(xié)議,也就是支持一種定制的通訊模式,使配件和應(yīng)用程序之間可以進(jìn)行數(shù)據(jù)傳輸。蘋果并不維護(hù)一個(gè)協(xié)議的注冊(cè)表,支持何種協(xié)議及是否使用其他制造商支持的定制或標(biāo)準(zhǔn)協(xié)議是由制造商自行決定的。
作為和配件制造商通訊的一部分,您必須找出給定的配件支持什么協(xié)議。為了避免名字空間發(fā)生沖突,協(xié)議的名稱由反向的DNS字符串來指定,形式是com.apple.myProtocol
。這使得每個(gè)配件制造商都可以根據(jù)自己的需要定義協(xié)議,以支持不同的配件產(chǎn)品線。
應(yīng)用程序通過打開一個(gè)使用指定協(xié)議的會(huì)話來和配件進(jìn)行通訊。打開會(huì)話的方法是創(chuàng)建一個(gè)EASession
類的實(shí)例,該類中包含NSInputStream
和NSOutputStream
對(duì)象,可以和配件進(jìn)行通訊。通過這些流對(duì)象,應(yīng)用程序可以向配件發(fā)送未經(jīng)加工的數(shù)據(jù)包,以及接收來自配件的類似數(shù)據(jù)包。因此,您必須按照期望的協(xié)議來理解每個(gè)數(shù)據(jù)包的格式。
聲明應(yīng)用程序支持的協(xié)議
能夠和配件通訊的應(yīng)用程序應(yīng)該在其Info.plist
文件中聲明支持的協(xié)議,使系統(tǒng)知道在相應(yīng)的配件接入時(shí),該應(yīng)用程序可以被啟動(dòng)。如果當(dāng)前沒有應(yīng)用程序可以支持接入的配件,系統(tǒng)可以選擇啟動(dòng)App Store并指向支持該設(shè)備的應(yīng)用程序。
為了聲明支持的協(xié)議,您必須在應(yīng)用程序的Info.plist
文件中包含UISupportedExternalAccessoryProtocols
鍵。該鍵包含一個(gè)字符串數(shù)組,用于標(biāo)識(shí)應(yīng)用程序支持的通訊協(xié)議。您的應(yīng)用程序可以在這個(gè)列表中以任意順序包含任意數(shù)量的協(xié)議。系統(tǒng)并不使用這個(gè)列表來確定應(yīng)用程序應(yīng)該選擇哪個(gè)協(xié)議,而只是用它來確定應(yīng)用程序是否能夠和相應(yīng)的配件進(jìn)行通訊。您的代碼需要在開始和配件進(jìn)行對(duì)話時(shí)選擇適當(dāng)?shù)耐ㄓ崊f(xié)議。
在運(yùn)行時(shí)連接配件
在配件接入系統(tǒng)并做好通訊準(zhǔn)備之前,通過External Accessory框架無法看到配件。當(dāng)配件變?yōu)榭梢姇r(shí),您的應(yīng)用程序就可以獲取相應(yīng)的配件對(duì)象,然后用其支持的一或多個(gè)協(xié)議打開會(huì)話。
共享的EAAccessoryManager
對(duì)象為應(yīng)用程序?qū)ふ遗c之通訊的配件提供主入口點(diǎn)。該類包含一個(gè)已經(jīng)接入的配件對(duì)象的數(shù)組,您可以對(duì)其進(jìn)行枚舉,看看是否存在應(yīng)用程序支持的配件。EAAccessory
對(duì)象中的絕大多數(shù)信息(比如名稱、制造商、和型號(hào)信息)都只是用于顯示。如果您要確定應(yīng)用程序是否可以連接一個(gè)配件,必須看配件的協(xié)議,確認(rèn)應(yīng)用程序是否支持其中的某個(gè)協(xié)議。
請(qǐng)注意:多個(gè)配件對(duì)象支持同一協(xié)議是可能的。如果發(fā)生這種情況,您的代碼必須負(fù)責(zé)選擇使用哪個(gè)配件對(duì)象。
對(duì)于給定的配件對(duì)象,每次只能有一個(gè)指定協(xié)議的會(huì)話。EAAccessory
對(duì)象的protocolStrings
屬性包含一個(gè)字典,字典的鍵是配件支持的協(xié)議。如果您試圖用一個(gè)已經(jīng)在使用的協(xié)議創(chuàng)建會(huì)話,External Accessory框架就會(huì)產(chǎn)生錯(cuò)誤。
程序清單8-1展示了如何檢查接入配件的列表并從中取得應(yīng)用程序支持的第一個(gè)配件。它為指定的協(xié)議創(chuàng)建一個(gè)會(huì)話,并對(duì)會(huì)話的輸入和輸出流進(jìn)行配置。在這個(gè)方法返回會(huì)話對(duì)象時(shí),已經(jīng)完成和配件的連接,并可以開始發(fā)送和接收數(shù)據(jù)了。
程序清單8-1 創(chuàng)建和配件的通訊會(huì)話
- (EASession *)openSessionForProtocol:(NSString *)protocolString{
NSArray *accessories = [[EAAccessoryManager sharedAccessoryManager]
connectedAccessories];
EAAccessory *accessory = nil;
EASession *session = nil;
for (EAAccessory *obj in accessories) {
if ([[obj protocolStrings] containsObject:protocolString]) {
accessory = obj;
break;
}
}
if (accessory) {
session = [[EASession alloc] initWithAccessory:accessory
forProtocol:protocolString];
if (session) {
[[session inputStream] setDelegate:self];
[[session inputStream] scheduleInRunLoop:[NSRunLoop currentRunLoop]
forMode:NSDefaultRunLoopMode];
[[session inputStream] open];
[[session outputStream] setDelegate:self];
[[session outputStream] scheduleInRunLoop:[NSRunLoop currentRunLoop]
forMode:NSDefaultRunLoopMode];
[[session outputStream] open];
[session autorelease];
}
}
return session;
}
在配置好輸入輸出流之后,最好一步就是處理和流相關(guān)的數(shù)據(jù)了。程序清單8-2展示了在委托方法中處理流事件的基本代碼結(jié)構(gòu)。清單中的方法可以響應(yīng)來自配件輸入輸出流的事件。當(dāng)配件向應(yīng)用程序發(fā)送數(shù)據(jù)時(shí),事件發(fā)生表示有數(shù)據(jù)可供讀取;類似地,當(dāng)配件準(zhǔn)備好接收應(yīng)用程序數(shù)據(jù)時(shí),也通過事件來表示(當(dāng)然,您并不一定要等到這個(gè)事件發(fā)生才向流寫出數(shù)據(jù),應(yīng)用程序也可以調(diào)用流的hasBytesAvailable
方法來確認(rèn)配件是否還能夠接收數(shù)據(jù))。有關(guān)流及如何處理流事件的更多信息,請(qǐng)參見Cocoa流編程指南。
程序清單8-2 處理流事件
// Handle communications from the streams.
- (void)stream:(NSStream*)theStream handleEvent:(NSStreamEvent)streamEvent{
switch (streamEvent){
case NSStreamHasBytesAvailable:
// Process the incoming stream data.
break;
case NSStreamEventHasSpaceAvailable:
// Send the next queued command.
break;
default:
break;
}
}
監(jiān)控與配件有關(guān)的事件
當(dāng)配件接入或斷開時(shí),External Accessory框架都可以發(fā)送通告。但是這些通告并不自動(dòng)發(fā)送,如果您的應(yīng)用程序感興趣,必須調(diào)用EAAccessoryManager類的registerForLocalNotifications方法來顯式請(qǐng)求。當(dāng)配件接入、認(rèn)證、并準(zhǔn)備好和應(yīng)用程序進(jìn)行交互時(shí),框架可以發(fā)出一個(gè)EAAccessoryDidConnectNotification
通告;而當(dāng)配件斷開時(shí),框架則可以發(fā)送一個(gè)EAAccessoryDidDisconnectNotification
通告。您可以通過缺省的NSNotificationCenter
來注冊(cè)接收這些通告。兩種通告都包含受影響的配件的信息。
除了通過缺省的通告中心接收通告之外,當(dāng)前正在和配件進(jìn)行交互的應(yīng)用程序可以為相應(yīng)的EAAccessory
對(duì)象分配一個(gè)委托,使它在發(fā)生變化的時(shí)候得到通知。委托對(duì)象必須遵循EAAccessoryDelegate
協(xié)議,該協(xié)議目前包含名為accessoryDidDisconnect:
的可選方法,您可以通過這個(gè)方法來接收配件斷開通告,而不需要事先配置通告觀察者。
有關(guān)如何注冊(cè)接收通告的更多信息,請(qǐng)參見Cocoa通告編程主題。