安卓手机APP开发__USB主机和配件概述

目录

概述

USB 配件模式

调试注意事项

选择合适的 USB 配件 API

支持 USB 主机模式

API 概览

清单和资源文件示例

---

概述

Android 通过 USB 配件和 USB 主机两种模式支持各种 USB 外围设备和
Android USB 配件（实现 Android 配件协议的硬件）。在 USB 配件模
式下，外部 USB 硬件充当 USB 主机。配件示例包括：

    机器人控制器
    停放点
    诊断和音乐设备
    自助服务终端
    读卡器

等等。这样，不具备主机功能的 Android 设备就能够与 USB 硬件进行
交互。Android USB 配件必须设计为与 Android 设备兼容，并且必须遵循
Android 配件通信协议。在 USB 主机模式下，Android 设备充当主机。
设备示例包括数码相机、键盘、鼠标和游戏控制器。专为各种应用和
环境设计的 USB 设备仍可与能够与设备正确通信的 Android 应用交互。

USB 配件模式

Android 3.1（API 级别 12）或更高版本的平台直接支持 USB 配件和
主机模式。USB 配件模式还作为插件库向后移植到 Android 2.3.4
（API 级别10），以支持更广泛的设备。设备制造商可以选择是否在设备
的系统映像中包含插件库。

注意：对 USB 主机和配件模式的支持最终取决于设备的硬件，而与平台
级别无关。您可以通过 <uses-feature> 元素过滤出支持 USB 主机和配件
的设备。如需了解详情，请参阅 USB 配件和主机文档。

调试注意事项

调试使用 USB 配件或主机功能的应用时，您很可能已将 USB 硬件连接
到 Android 设备。这样可以阻止您使用 USB 与 Android 设备建立 adb
连接。您仍可通过网络连接访问 adb。如需通过网络连接启用 adb，请
执行以下操作：

    通过 USB 将 Android 设备连接到计算机。
    在 SDK platform-tools/ 目录中，在命令提示符处输入 adb tcpip 5555。
    输入 adb connect <device-ip-address>:5555。您现在应该已连接到 Android 设备，并且可以发出常规的 adb 命令（如 adb logcat）。
    要设置设备来监听 USB，请输入 adb usb。

在 USB 配件模式下，用户可以连接专为 Android 设备设计的 USB 主机硬件。
配件必须遵循 Android 配件开发套件文档中所述的 Android 配件协议。
这样一来，无法充当 USB 主机的 Android 设备仍可与 USB 硬件交互。
当 Android 设备处于 USB 配件模式时，连接的 Android USB 配件会
充当主机，为 USB 总线供电，并枚举已连接的设备。 Android 3.1
（API 级别 12）支持 USB 配件模式，并且该功能还向后移植到了
Android 2.3.4（API 级别 10），以支持更广泛的设备。

选择合适的 USB 配件 API

虽然 USB 配件 API 是在 Android 3.1 中的平台中引入的，但它们在
Android 2.3.4 中也可以通过 Google API 插件库获取。由于这些 API
是使用外部库向后移植的，因此您可以导入两个软件包来支持 USB
配件模式。您可能需要优先使用其中一种设备，具体取决于您想支持
的 Android 设备：

    com.android.future.usb：为了在 Android 2.3.4 中支持 USB
    配件模式，Google API 插件库包含向后移植的 USB 配件 API，
    并且这些 API 包含在此命名空间中。Android 3.1
    还支持导入和调用此命名空间中的类，以支持使用插件库编写的
    应用。此插件库是 android.hardware.usb 配件 API 的瘦封装
    容器，不支持 USB 主机模式。如果您想为各种支持 USB
    配件模式的设备提供支持，请使用插件库并导入此软件包。
    请务必注意，并非所有 Android 2.3.4 设备都需要支持 USB
   配件功能。是否支持此功能由各个设备制造商决定，因此您必须
   在清单文件中声明此功能。
    android.hardware.usb：此命名空间包含在 Android 3.1 中
    支持 USB 配件模式的类。该软件包包含在框架 API 中，
    因此 Android 3.1 无需使用插件库即可支持 USB 配件模式。
    如果您只关心在硬件上支持 USB 配件模式的 Android 3.1
    或更高版本设备，请使用此软件包（您可以在清单文件中声明支持）。

当 Android 设备处于 USB 主机模式时，它会充当 USB 主机，
为总线供电，并枚举连接的 USB 设备。Android 3.1 及更高版本

支持 USB 主机模式

API 概览

在开始前，请务必了解您需要使用的类。下表介绍了
android.hardware.usb 软件包中的 USB 主机 API。

表 1. USB 主机 API
类     说明
UsbManager     您可以枚举连接的 USB 设备并与之通信。
UsbDevice     表示连接的 USB 设备，并包含用于访问其标识信息、接口和端点的方法。
UsbInterface     表示 USB 设备的接口，用于定义设备的一组功能。设备可以具有一个或多个用于通信的接口。
UsbEndpoint     表示接口端点，是此接口的通信通道。一个接口可以有一个或多个端点，并且通常具有用于与设备进行双向通信的输入和输出端点。
UsbDeviceConnection     表示与设备的连接，可在端点上传输数据。该类允许您以同步或异步方式来回发送数据。
UsbRequest     表示通过 UsbDeviceConnection 与设备通信的异步请求。
UsbConstants     定义与 Linux 内核的 linux/usb/ch9.h 中的定义相对应的 USB 常量。

在大多数情况下，在与 USB 设备通信时需要使用所有这些类（只有在进行异步通信时才需要 UsbRequest）。一般来说，您可以通过获取 UsbManager 来检索所需的 UsbDevice。当您有了设备后，需要找到相应的 UsbInterface 和该接口的 UsbEndpoint 来进行通信。获得正确的端点后，打开 UsbDeviceConnection 以与 USB 设备通信。
Android 清单要求

以下列表说明了在使用 USB 主机 API 之前需要向应用的清单文件中添加的内容：

    由于并非所有 Android 设备都保证支持 USB 主机 API，因此，请添加
    <uses-feature> 元素来声明您的应用使用 android.hardware.usb.host 功能。
    将应用的最低 SDK 设置为 API 级别 12 或更高级别。USB 主机 API
    在早期的 API 级别中不存在。
    如果您希望应用接收有关连接的 USB 设备的通知，请为主 Activity 中的
    android.hardware.usb.action.USB_DEVICE_ATTACHED intent
    指定 <intent-filter> 和 <meta-data> 元素对。<meta-data> 元素指向
    一个外部 XML 资源文件，该文件用于声明有关要检测的设备的标识信息。

    在 XML 资源文件中，为要过滤的 USB 设备声明 <usb-device> 元素。以下
    列表介绍了 <usb-device> 的属性。一般来说，如果您想过滤出特定设备，
    请使用供应商 ID 和产品 ID；如果要过滤一组 USB
    设备（例如大容量存储设备或数码相机），请使用类、子类和协议。
    您可以不指定任何属性，也可以指定所有这些属性。如果未指定任何属性，
    则会匹配每个 USB 设备，因此请仅在您的应用需要时才这样做：

        vendor-id
        product-id
        class
        subclass
        protocol（设备或接口）

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

清单和资源文件示例

以下示例展示了一个清单及其相应的资源文件：

<manifest ...><uses-feature android:name="android.hardware.usb.host" /><uses-sdk android:minSdkVersion="12" />...<application><activity ...>...<intent-filter><action android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED" /></intent-filter><meta-data android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED"android:resource="@xml/device_filter" /></activity></application>
</manifest>