如果要安装该附加库，可以通过使用 SDK Manager 安装 Google API Android API 10 软件包。有关安装附加库的更多信息，请参阅 Installing the Google APIs Add-on。

Class	Description
UsbManager	允许枚举以及与已连接 USB 配件通讯
UsbAccessory	表示USB 配件，包含访问其标识信息的方法

附加库和平台 APIs 的使用差别

UsbManager manager = UsbManager.getInstance(this);

如果没在使用附加库，必须以下列方式获取 UsbManager：

UsbManager manager = (UsbManager) getSystemService(Context.USB_SERVICE);

当您使用 intent filter 过滤连接的配件时，UsbAccessory 对象包含在传递给应用程序的 intent 内。 如果正在使用附加库，则必须以下列方式获取 UsbAccessory 对象：

UsbAccessory accessory = UsbManager.getAccessory(intent);

如果没在使用附加库，必须以下列方式获取 UsbAccessory：

UsbAccessory accessory = (UsbAccessory) intent.getParcelableExtra(UsbManager.EXTRA_ACCESSORY);

安卓 Manifest 要求

以下列表描述了在使用 USB accessory API 之前需要添加到应用程序的 manifest 文件中的内容。manifest and resource file examples 展示了如何声明这些项目：

1. 因为并非所有 Android 设备被授权支持 USB accessory API，因此包含一个 <uses-feature> 元素，声明您的应用程序使用 android.hardware.usb.accessory 功能。

2. 如果您正在使用附加库，请添加指定 com.android.future.usb.accessory 的 <uses-library> 元素。

3. 如果您正在使用附加库，请将应用程序的最小 SDK 设置为 API Level 10，如果使用的是android.hardware.usb 包，则将其设置为12。

4. 如果您希望应用程序在 USB 配件连接时收到通知，请在主要活动中为 android.hardware.usb.action.USB_ACCESSORY_ATTACHED 意图指定 <intent-filter> 和 <meta-data> 元素对。<meta-data> 元素指向一个外部XML资源文件，它声明了您想检测的配件的标识信息。

在XML资源文件中，为要过滤的配件声明 <usb-accessory> 元素。每个 <usb-accessory> 可以具有以下属性：

• manufacturer

• model

• version

将资源文件保存在 res/xml/ 目录中。资源文件名（不含 .xml 扩展名）必须与您在 <meta-data> 元素中指定的文件名相同。 XML资源文件的格式也展示在下面的 example 中。

Manifest 和 资源文件示例

以下示例展示了一个 manifest 样例及相应的资源文件：

<manifest ...><uses-feature android:name="android.hardware.usb.accessory" /><uses-sdk android:minSdkVersion="<version>" />...<application><uses-library android:name="com.android.future.usb.accessory" /><activity ...>...<intent-filter><action android:name="android.hardware.usb.action.USB_ACCESSORY_ATTACHED" /></intent-filter><meta-data android:name="android.hardware.usb.action.USB_ACCESSORY_ATTACHED"android:resource="@xml/accessory_filter" /></activity></application>
</manifest>

<?xml version="1.0" encoding="utf-8"?><resources><usb-accessory model="DemoKit" manufacturer="Google" version="1.0"/>
</resources>

使用配件

当用户将 USB 配件连接到 Android 设备时，Android 系统可以决定您的应用程序是否对连接的配件感兴趣。 如果是这样，如果需要，您可以设置与附件的通信。如果是这样，您可以根据需要建立与设备的通信。为此，您的应用程序必须：

1. 通过使用 intent filter 过滤配件连接事件来发现配件或通过枚举已连接的配件找到正确的配件。

2. 请求用户连接 USB 配件的权限，如果尚未获得。

3. 在正确的接口端点上读写数据与 USB 配件进行通信。

应用程序可以通过使用 intent filter 在用户连接配件时收到通知或通过枚举已连接的 USB 配件来发现 USB 配件。如果您希望能够让应用程序自动检测到所需的配件，则使用 intent filter 非常有用。 如果要获取所有连接的配件列表，或者您的应用程序没有为 intent 进行过滤，则枚举已连接的 USB 配件的方法非常有用。

使用 intent filter（意图过滤器）

要使您的应用程序发现一个特定的 USB peijia，可以指定一个 intent filter 来过滤 android.hardware.usb.action.USB_ACCESSORY_ATTACHED intent。 除了此 intent filter，您还需要指定一个资源文件，该资源文件指定 USB 配件的属性，如 manufacturer、model 和 version。 当用户连接与 accessory filter 匹配的配件时，

以下示例展示如何声明 intent filter：

<activity ...>...<intent-filter><action android:name="android.hardware.usb.action.USB_ACCESSORY_ATTACHED" /></intent-filter><meta-data android:name="android.hardware.usb.action.USB_ACCESSORY_ATTACHED"android:resource="@xml/accessory_filter" />
</activity>

以下示例展示如何声明相应资源文件，其指定了感兴趣的 USB 配件：

<?xml version="1.0" encoding="utf-8"?><resources><usb-accessory manufacturer="Google, Inc." model="DemoKit" version="1.0" />
</resources>

在你的活动中，你可以像这样从 intent 中获取表示连接附件的 UsbAccessory（使用附加库）：

UsbAccessory accessory = UsbManager.getAccessory(intent);

或者像这样（使用平台 APIs）：

UsbAccessory accessory = (UsbAccessory)intent.getParcelableExtra(UsbManager.EXTRA_ACCESSORY);

枚举配件

当应用程序运行时，可以让应用程序枚举已经标识自己的配件。

使用 getAccessoryList() 方法获取所有已连接 USB 配件的数组：

UsbManager manager = (UsbManager) getSystemService(Context.USB_SERVICE);
UsbAccessory[] accessoryList = manager.getAcccessoryList();

Note：同一时间只可以支持一个已连接配件。

与配件通信

您可以使用 UsbManager 与配件通信，以获取文件描述符，您可以配置输入和输出流来读取和写入数据到描述符。 数据流表示配件的输入和输出批量端点。 您应该在另一个线程中建立设备和配件之间的通信，因而不会阻塞主UI线程。 以下示例展示如何打开配件进行通信：

UsbAccessory mAccessory;
ParcelFileDescriptor mFileDescriptor;
FileInputStream mInputStream;
FileOutputStream mOutputStream;...private void openAccessory() {Log.d(TAG, "openAccessory: " + accessory);mFileDescriptor = mUsbManager.openAccessory(mAccessory);if (mFileDescriptor != null) {FileDescriptor fd = mFileDescriptor.getFileDescriptor();mInputStream = new FileInputStream(fd);mOutputStream = new FileOutputStream(fd);Thread thread = new Thread(null, this, "AccessoryThread");thread.start();}
}

在线程的 run() 方法中，可以使用 FileInputStream 或 FileOutputStream 对象来读写配件。 使用 FileOutputStream 对象从配件读取数据时，请确保使用的缓冲区足够大以存储 USB 数据包数据。 Android 配件协议支持高达16384字节的数据包缓冲区，因此为了简单起见，您可以选择始终声明缓冲区为此大小。

Note：注意：在较低级别，USB 全速配件的数据包为64字节，USB 高速配件为512字节。 为了简单起见，Android 配件协议将两个速度的数据包捆绑在一起成为一个逻辑数据包。

有关在 Android 中使用线程的更多信息，请参阅 Processes and Threads。