安卓蓝牙开发API文档（中文版） - CSDN文库

4星 · 超过85%的资源需积分: 10 159 浏览量更新于2023-06-14 5 收藏 437KB PDF 举报

身份认证购VIP最低享 7 折!

领优惠券(最高得80元）

资源详情

资源推荐

Android.bluetooth

android.bluetooth

提供了皆如扫描设备、连接设备以及对设备间的数据传输进行管理的类，这些类对蓝牙设备进行功能性管

理。

蓝牙模块 API 提供的应用包括了：

●扫描其它蓝牙设备

●通过查询本地蓝牙适配器来匹配蓝牙设备

●建立 RFCOMM（无线射频通信协议）的通道/端口

●从其他的蓝牙设备中连接到指定的端口

●传输数据到其他设备，或者从其他设备中接收数据

如需运用这些 API 来执行蓝牙通信，应用程序必须声明 BLUETOOTH 许可。对于皆如寻找设备请求等的

一些附加功能，也同样需要 BLUETOOTH_ADMIN 许可。

如需要使用蓝牙 API 的更详细的指引，参看 Bluetooth Dev Guide topic.

Classes

BluetoothAdapter

代表本地的蓝牙适配器设备

BluetoothClass

代表一个描述了设备通用特性和功能的蓝牙类

BluetoothClass.Device

定义了所有设备类的常量

BluetoothClass.Device.Major

定义了所有主要设备类的常量

BluetoothClass.Service

定义了所有服务类的常量

BluetoothDevice

代表一个远程的蓝牙设备

BluetoothServerSocket

监听蓝牙服务的端口

BluetoothSocket

一个双向连接的蓝牙端口

public final class

Constants

public static final String ACTION_DISCOVERY_FINISHED

Since: API Level 5

广播事件：本地蓝牙适配器已经完成设备的搜寻过程。Requires BLUETOOTH to receive.

常量值: "android.bluetooth.adapter.action.DISCOVERY_FINISHED"

public static final String ACTION_DISCOVERY_STARTED

Since: API Level 5

广播事件：本地蓝牙适配器已经开始对远程设备的搜寻过程。

它通常牵涉到一个大概需时 12 秒的查询扫描过程，紧跟着是一个对每个获取到自身蓝牙名称的新设备的页

面扫描。

Register for ACTION_FOUND to be notified as remote Bluetooth devices are found.

用户会发现一个把 ACTION_FOUND 常量通知为远程蓝牙设备的注册。

设备查找是一个重量级过程。当查找正在进行的时候，用户不能尝试对新的远程蓝牙设备进行连接，同时

存在的连接将获得有限制的带宽以及高等待时间。用户可用 cencelDiscovery()类来取消正在执行的查找进

程。

需要 BLUETOOTH 类来接收。

常量名："android.bluetooth.adapter.action.DISCOVERY_STARTED"

public static final String ACTION_LOCAL_NAME_CHANGED

Since: API Level 5

广播事件：本地蓝牙适配器已经更改了它的蓝牙名称。

该名称对远程蓝牙设备是可见的。

它总是包含了一个带有名称的 EXTRA_LOCAL_NAME 附加域。

它需要请求 BLUETOOTH 类去获取这个名字。

常量值: "android.bluetooth.adapter.action.LOCAL_NAME_CHANGED"

public static final String ACTION_REQUEST_DISCOVERABLE

Since: API Level 5

活动事件：显示一个请求被搜寻模式的系统活动。如果蓝牙模块当前未打开，该活动也将请求用户打开蓝

牙模块。

被搜寻模式和 SCAN_MODE_CONNECTABLE_DISCOVERABLE 等价。当远程设备执行查找进程的时候，

它允许其发现该蓝牙适配器。

从隐私安全考虑，Android 不会将被搜寻模式设置为默认状态。

该意图的发送者可以选择性地运用 EXTRA_DISCOVERABLE_DURATION 这个附加域去请求发现设备的

持续时间。普遍来说，对于每一请求，默认的持续时间为 120 秒，最大值则可达到 300 秒。

Android 运用 onActivityResult(int, int, Intent)回收方法来传递该活动结果的通知。被搜寻的时间（以秒为单

位）将通过 resultCode 值来显示，如果用户拒绝被搜寻，或者设备产生了错误，则通过

RESULT_CANCELED 值来显示。

每当扫描模式变化的时候，应用程序可以为通过 ACTION_SCAN_MODE_CHANGED 值来监听全局的消

息通知。比如，当设备停止被搜寻以后，该消息可以被系统通知給应用程序。

剩余44页未读，继续阅读

江海汇

粉丝: 10
资源: 13

会员权益专享

图片转文字

全年可省5，000元立即开通

最新资源

资源上传下载、课程学习等过程中有任何疑问或建议，欢迎提出宝贵意见哦~我们会及时处理！点击此处反馈