Android 中文API （70） —— BluetoothDevice[蓝牙]

淡淡的烟草味﹌ 2022-01-09 12:21 192阅读 0赞

前言

本章内容是 android.bluetooth.BluetoothDevice，为Android蓝牙部分的章节翻译。蓝牙设备类，代表了蓝牙通讯国足中的远端设备。版本为 Android 2.3 r1，翻译来自中山大学的"Android Club SYSU"，欢迎访问他们的WIKI：[http://www.android-wiki.net][http_www.android-wiki.net]，再次感谢"Android Club SYSU"！期待你一起参与Android中文API的翻译，联系我 over140@gmail.com。

声明

欢迎转载，但请保留文章原始出处:)

Android Club SYSU：[http://www.android-wiki.net][http_www.android-wiki.net]

博客园：[http://www.cnblogs.com/][http_www.cnblogs.com]

Android中文翻译组：[http://code.taobao.org/project/view/404/][http_code.taobao.org_project_view_404]

正文

一、结构

public static class BluetoothDevice extends Object implements Parcelable

java.lang.Object

android.bluetooth.BluetoothDevice

二、概述

代表一个远程蓝牙设备。让你创建一个带有各自设备的BluetoothDevice或者查询其皆如名称、地址、类和连接状态等信息。

对于蓝牙硬件地址而言，这个类仅仅是一个瘦包装器。这个类的对象是不可改变的。这个类上的操作会使用这个用来创建BluetoothDevice类的BluetoothAdapter类执行在远程蓝牙硬件上。

为了获得BluetoothDevice,类，使用BluetoothAdapter.getRemoteDevice(String)方法去创建一个表示 已知MAC地址的设备（用户可以通过带有BluetoothAdapter类来完成对设备的查找）或者从一个通过 BluetoothAdapter.getBondedDevices()得到返回值的有联系的设备集合来得到该设备。

注意：需要[BLUETOOTH][]权限

参见

[BluetoothAdapter][]

[BluetoothSocket][]

三、常量

String ACTION\_ACL\_CONNECTED

广播活动：指明一个与远程设备建立的低级别（ACL）连接。

总是包含[EXTRA\_DEVICE][EXTRA_DEVICE]附加域

ACL连接通过Android蓝牙栈自动进行管理

需要[BLUETOOTH][]权限接收

常量值: "android.bluetooth.device.action.ACL\_CONNECTED"

String ACTION\_ACL\_DISCONNECTED

广播活动：指明一个来自于远程设备的低级别（ACL）连接的断开

总是包含[EXTRA\_DEVICE][EXTRA_DEVICE]附加域

ACL连接通过Android蓝牙栈自动进行管理

需要[BLUETOOTH][]权限接收

常量值: "android.bluetooth.device.action.ACL\_DISCONNECTED"

String ACTION\_ACL\_DISCONNECT\_REQUESTED

广播活动：指明一个为远程设备提出的低级别（ACL）的断开连接请求，并即将断开连接。

对于友好的断开连接，该常量是有作用的。应用程序可以用它作为暗示去马上中断对远程设备的高级别的连接（RFCOMM,L2CAP,或者其它连接）。

总是包含[EXTRA\_DEVICE][EXTRA_DEVICE]附加域

需要[BLUETOOTH][]权限接收

常量值: "android.bluetooth.device.action.ACL\_DISCONNECT\_REQUESTED"

String ACTION\_BOND\_STATE\_CHANGED

广播活动：指明一个远程设备的连接状态的改变。比如，当一个设备已经被匹配。

总是包含EXTRA\_DEVICE, EXTRA\_BOND\_STATE和 EXTRA\_PREVIOUS\_BOND\_STATE.这些附加域。

需要[BLUETOOTH][]权限接收

常量值: "android.bluetooth.device.action.BOND\_STATE\_CHANGED"

String ACTION\_CLASS\_CHANGED

广播活动：一个已经改变的远程设备的蓝牙类。

总是包含EXTRA\_DEVICE和EXTRA\_BOND\_STATE这些附加域。

需要[BLUETOOTH][]权限接收

参见

[ERROR(BluetoothClass\} /\{@link BluetoothClass\})][ERROR_BluetoothClass_ _link BluetoothClass]

常量值: "android.bluetooth.device.action.CLASS\_CHANGED"

String ACTION\_FOUND

广播活动：发现远程设备

当一个远程设备在查找过程中被发现时，发送该常量值。

总是包含[EXTRA\_DEVICE][EXTRA_DEVICE]和[EXTRA\_CLASS][EXTRA_CLASS]这些附加域。如果可用的话，也可包含[EXTRA\_NAME][EXTRA_NAME]和/或[EXTRA\_RSSI][EXTRA_RSSI]这些附加域。

需要[BLUETOOTH][]权限接收

常量值: "android.bluetooth.device.action.FOUND"

String ACTION\_NAME\_CHANGED

广播活动：指明一个远程设备的昵称第一次找到，或者自从最后一次找到该昵称开始已经改变。

总是包含EXTRA\_DEVICE和EXTRA\_NAME这些附加域

需要[BLUETOOTH][]权限接收

常量值: "android.bluetooth.device.action.NAME\_CHANGED"

int        BOND\_BONDED

指明远程设备已经匹配。

一个共享的连接键为了远程设备而存在于本地，因而设备间的通讯可以被认证和加密。

和远程设备的匹配并不意味着设备间已经成功连接。它只意味着匹配过程已经在稍早之前完成，并且连接键已经存储在本地，准备在下次连接的时候使用。

常量值: 12 (0x0000000c)

int        BOND\_BONDING

指明和远程设备的匹配正在进行中

常量值: 11 (0x0000000b)

int        BOND\_NONE

指明远程设备未被匹配。

不存在为了远程设备而已经共享的连接键，因而设备间的通讯（如果完全被允许）不可被认证和加密。

常量值: 10 (0x0000000a)

Creator<BluetoothDevice>         CREATOR

int        ERROR

该 类的错误标志值. 标记该类的错误值。确保和该类中的任意其它整数常量不相等。它为需要一个标记错误值的函数提供了便利。例如：Intent.getIntExtra(BluetoothAdapter.EXTRA\_STATE, BluetoothAdapter.ERROR)

常量值: -2147483648 (0x80000000)

String EXTRA\_BOND\_STATE

作为一个[ACTION\_BOND\_STATE\_CHANGED][ACTION_BOND_STATE_CHANGED]的整型附加域。包含了远程设备的匹配状态。

可能值有: BOND\_NONE, BOND\_BONDING, BOND\_BONDED.

常量值: "android.bluetooth.device.extra.BOND\_STATE"

String EXTRA\_CLASS

作为一个[ACTION\_FOUND][ACTION_FOUND]和[ACTION\_CLASS\_CHANGED][ACTION_CLASS_CHANGED]的Parcelabe [BluetoothClass][]附加域。

常量值: "android.bluetooth.device.extra.CLASS"

String EXTRA\_DEVICE

每次通过该类进行广播时，作为Parcelable BluetoothDevice的附加域。它包含了该常量适用的BluetoothDevice类。

常量值: "android.bluetooth.device.extra.DEVICE"

String EXTRA\_NAME

作为ACTION\_NAME\_CHANGED和ACTION\_FOUND的字符串附加域。它包含了这个蓝牙昵称。

常量值: "android.bluetooth.device.extra.NAME"

String EXTRA\_PREVIOUS\_BOND\_STATE

作为ACTION\_BOND\_STATE\_CHANGED的整型附加域。包含了远程设备以前的匹配状态。

可能值有: BOND\_NONE, BOND\_BONDING, BOND\_BONDED.

常量值: "android.bluetooth.device.extra.PREVIOUS\_BOND\_STATE"

String EXTRA\_RSSI

作为ACTION\_FOUND的可选短整型附加域。包含了被蓝牙硬件通知的远程设备的RSSI(Receive Signal Strength Indication，接收信号强度指示)值。

常量值: "android.bluetooth.device.extra.RSSI"

四、公共方法

public BluetoothSocketcreateRfcommSocketToServiceRecord (UUID uuid)

该方法是为了使用带有listenUsingRfcommWithServiceRecord(String, UUID)方法来进行对等的蓝牙应用而设计的。

使用connect()初始化这个外界连接。它也将执行一个已给与UUID的SDP查找，从而确定连接到哪个通道上。

远程设备将被认证，在这个端口上的通讯会被加密。

提示：如果你正试图连接蓝牙串口，那么使用众所周知的SPP UUID 00001101-0000-1000-8000-00805F9B34FB。但是你如果正试图连接Android设备那么请你生成你自己的专有UUID。

需要[BLUETOOTH][]权限。

参数

uuid 查询RFCOMM通道的服务记录UUID

返回值

一个准备好外界连接的RFCOMM蓝牙服务端口

异常

IOException     出现错误，比如蓝牙模块不可用，或者许可无效。

public int describeContents ()

描述了包含在Parcelable's marshalled representation中的特殊对象的种类。

返回值

一个指示被Parcelabel所排列的特殊对象类型集合的位屏蔽。

public boolean equals (Object o)

比较带有特定目标的常量。如果他们相等则标示出来。 为了保证其相等，o必须代表相同的对象，该对象作为这个使用类依赖比较的常量。通常约定，该比较既需要可复制、相等和可传递。另外，没有对象引用的时候null等于null。

默认实现是返回ture，仅当this == o。如果你想实现你自己的equals方法，参见[Writing a correct ][Writing a correct][equals][Writing a correct] method。

当且仅当o是一个作为接收器（使用==操作符来做比较）的精确相同的对象是，这个对象的实现才返回true值。子类通常实现equals(Object)方法，这样它才会重视这两个对象的类型和状态。

通常约定，对于equals(Object)和hashCode() 方法，如果equals对于任意两个对象返回真值，那么hashCode()必须对这些对象返回相同的纸。这意味着对象的子类通常都覆盖或者都不覆盖这两个方法。

参数

o 需要对比常量的对象

返回值

如果指定的对象和该对象相等则返回true，否则返回false。

public String getAddress ()

返回该蓝牙设备的硬件地址

例如： "00:11:22:AA:BB:CC".

返回值

字符串类型的蓝牙硬件地址

public BluetoothClass getBluetoothClass ()

获取远程设备的蓝牙类

需要[BLUETOOTH][]权限。

返回值

蓝牙类对象出错时返回空值

public int getBondState ()

获取远程设备的连接状态。

连接状态的可能值有: BOND\_NONE, BOND\_BONDING, BOND\_BONDED.

需要[BLUETOOTH][]权限。

返回值

连接状态。

public String getName ()

获取远程设备的蓝牙昵称。

当执行设备扫描的时候，本地适配器将自动寻找远程名称。该方法只返回来自存储器中该设备的名称。

需要[BLUETOOTH][]权限。

返回值

蓝牙昵称，如果出现问题则返回null。

public int hashCode ()

返回该对象的一个整型哈希值. 通常约定，如果equals对于任意两个对象返回真值，那么hashCode()必须对这些对象返回相同的值。这意味着对象的子类通常都覆盖或者都不覆盖这两个方法。

注意：除非同等对比信息发生改变，否则哈希码不随时间改变而改变。

如果你想要实现你自己的哈希码方法，参见[Writing a correct ][Writing a correct 1][hashCode][Writing a correct 1] method。

返回值

该对象的哈希值

public String toString ()

返回该蓝牙设备的字符串表达式。

这是一个蓝牙硬件地址，例如"00:11:22:AA:BB:CC".然而，如果用户明确需要蓝牙硬件地址以防以后[toString()][toString]表达式会改变的话，用户总是需要使用[getAddress()][getAddress]方法。

返回值

该蓝牙设备的字符串表达式。

public void writeToParcel (Parcel out, int flags)

将类的数据写入外部提供的Parcel中

参数

out  对象需要被写入的Parcel

flags  和对象需要如何被写入有关的附加标志。可能是0，或者可能是

五、补充

文章精选

[Android][][提高第十二篇之蓝牙传感应用][Android]

[Android][Android 1][提高第十三篇之探秘蓝牙隐藏][Android 1]API

[http_www.android-wiki.net]: http://www.android-wiki.net/index.php?title=Main_Page
[http_www.cnblogs.com]: http://www.cnblogs.com/
[http_code.taobao.org_project_view_404]: http://code.taobao.org/project/view/404/
[BLUETOOTH]: http://developer.android.com/reference/android/Manifest.permission.html#BLUETOOTH
[BluetoothAdapter]: http://developer.android.com/reference/android/bluetooth/BluetoothAdapter.html
[BluetoothSocket]: http://developer.android.com/reference/android/bluetooth/BluetoothSocket.html
[EXTRA_DEVICE]: http://developer.android.com/reference/android/bluetooth/BluetoothDevice.html#EXTRA_DEVICE
[ERROR_BluetoothClass_ _link BluetoothClass]: http://developer.android.com/
[EXTRA_CLASS]: http://developer.android.com/reference/android/bluetooth/BluetoothDevice.html#EXTRA_CLASS
[EXTRA_NAME]: http://developer.android.com/reference/android/bluetooth/BluetoothDevice.html#EXTRA_NAME
[EXTRA_RSSI]: http://developer.android.com/reference/android/bluetooth/BluetoothDevice.html#EXTRA_RSSI
[ACTION_BOND_STATE_CHANGED]: http://developer.android.com/reference/android/bluetooth/BluetoothDevice.html#ACTION_BOND_STATE_CHANGED
[ACTION_FOUND]: http://developer.android.com/reference/android/bluetooth/BluetoothDevice.html#ACTION_FOUND
[ACTION_CLASS_CHANGED]: http://developer.android.com/reference/android/bluetooth/BluetoothDevice.html#ACTION_CLASS_CHANGED
[BluetoothClass]: http://developer.android.com/reference/android/bluetooth/BluetoothClass.html
[Writing a correct]: http://developer.android.com/reference/android/bluetooth/BluetoothDevice.html#writing_equals
[Writing a correct 1]: http://developer.android.com/reference/android/bluetooth/BluetoothClass.html#writing_hashCode
[toString]: http://developer.android.com/reference/android/bluetooth/BluetoothDevice.html#toString%28%29
[getAddress]: http://developer.android.com/reference/android/bluetooth/BluetoothDevice.html#getAddress%28%29
[Android]: http://blog.csdn.net/hellogv/archive/2010/11/26/6036849.aspx
[Android 1]: http://blog.csdn.net/hellogv/archive/2010/11/29/6042091.aspx