Chinaunix首页 | 论坛 | 博客
  • 博客访问: 1278200
  • 博文数量: 129
  • 博客积分: 1449
  • 博客等级: 上尉
  • 技术积分: 3048
  • 用 户 组: 普通用户
  • 注册时间: 2012-07-24 18:36
文章分类

全部博文(129)

文章存档

2015年(3)

2014年(20)

2013年(65)

2012年(41)

分类: 项目管理

2014-02-20 09:22:49

本文摘录于andriod中文翻译组, 感谢他们的辛勤工作

首先,要操作蓝牙,先要在 AndroidManifest.xml 里加入权限


然后,看下api ,Android 所有关于蓝牙开发的类都在android.bluetooth 包下,有8个类, 一般我们需要用到有如下4个类:


1.BluetoothAdapter 顾名思义,蓝牙适配器,直到我们建立bluetoothSocket 连接之前,都要不断操作它
BluetoothAdapter 里的方法很多,常用的有以下几个:
cancelDiscovery() 根据字面意思,是取消发现,也就是说当我们正在搜索设备的时候调用这个方法将不再继续搜索
disable() 关闭蓝牙
enable() 打开蓝牙,这个方法打开蓝牙不会弹出提示,更多的时候我们需要问下用户是否打开,一下这两行代码同样是打开蓝牙,不过会提示用户:
Intemt enabler=new Intent(BluetoothAdapter.ACTION_REQUEST_ENABLE);
startActivityForResult(enabler,reCode);// 同startActivity(enabler);
getAddress() 获取本地蓝牙地址
getDefaultAdapter() 获取默认BluetoothAdapter ,实际上,也只有这一种方法获取BluetoothAdapter
getName() 获取本地蓝牙名称
getRemoteDevice(String address) 根据蓝牙地址获取远程蓝牙设备
getState() 获取本地蓝牙适配器当前状态(感觉可能调试的时候更需要)
isDiscovering() 判断当前是否正在查找设备,是返回true
isEnabled() 判断蓝牙是否打开,已打开返回true ,否则,返回false
listenUsingRfcommWithServiceRecord(String name,UUID uuid) 根据名称,UUID 创建并返回BluetoothServerSocket ,这是创建BluetoothSocket 服务器端的第一步
startDiscovery() 开始搜索,这是搜索的第一步

2.BluetoothDevice 看名字就知道,这个类描述了一个蓝牙设备
createRfcommSocketToServiceRecord(UUID uuid) 根据UUID 创建并返回一个BluetoothSocket
这个方法也是我们获取BluetoothDevice 的目的——创建BluetoothSocket
这个类其他的方法,如getAddress(),getName(), 同BluetoothAdapter

3.BluetoothServerSocket 如果去除了Bluetooth 相信大家一定再熟悉不过了,既然是Socket ,方法就应该都差不多,这个类一种只有三个方法
两个重载的accept(),accept(int timeout) 两者的区别在于后面的方法指定了过时时间,需要注意的是,执行这两个方法的时候,直到接收到了客户端的请求(或是过期之后),都会阻塞线程,应该放在新线程里运行!
还有一点需要注意的是,这两个方法都返回一个BluetoothSocket ,最后的连接也是服务器端与客户端的两个BluetoothSocket 的连接
close() 这个就不用说了吧,翻译一下——关闭!

4.BluetoothSocket, 跟BluetoothServerSocket 相对,是客户端. 一共5 个方法,不出意外,都会用到
close(), 关闭
connect() 连接
getInptuStream() 获取输入流
getOutputStream() 获取输出流
getRemoteDevice() 获取远程设备,这里指的是获取bluetoothSocket 指定连接的那个远程蓝牙设备.




BluetoothAdapter

类概述

代表本地的蓝牙适配器设备。BluetoothAdapter类让用户能执行基本的蓝牙任务。例如: 初始化设备的搜索,查询可匹配的设备集,使用一个已知的MAC地址来初始化一个BluetoothDevice类,创建一个 BluetoothServerSocket类以监听其它设备对本机的连接请求等。

为了得到这个代表本地蓝牙适配器的 BluetoothAdapter类,调用getDefaultAdapter()这一静态方法。这是所有蓝牙动作使用的第一步。当拥有本地适配器以后, 用户可以获得一系列的BluetoothDevice对象,这些对象代表所有拥有getBondedDevice()方法的已经匹配的设备;用 startDiscovery()方法来开始设备的搜寻;或者创建一个BluetoothServerSocket类,通过 listenUsingRfcommWithServiceRecord(String, UUID)方法来监听新来的连接请求。

Note:大部分方法需要BLUETOOTH权限,一些方法同时需要BLUETOOTH_ADMIN权限。

常量

         String      ACTION_DISCOVERY_FINISHED   

广播事件:本地蓝牙适配器已经完成设备的搜寻过程。

需要BLUETOOTH权限接收。

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

 

String      ACTION_DISCOVERY_STARTED    

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

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

         用户会发现一个把ACTION_FOUND常量通知为远程蓝牙设备的注册。
设备查找是一个重量级过程。当查找正在进行的时候,用户不能尝试对新的远程蓝牙设备进行连接,同时存在的连接将获得有限制的带宽以及高等待时间。用户可用cancelDiscovery()类来取消正在执行的查找进程。

需要BLUETOOTH权限接收。

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

 

String      ACTION_LOCAL_NAME_CHANGED      

广播活动:本地蓝牙适配器已经更改了它的蓝牙名称。

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

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

需要BLUETOOTH权限接收。

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

 

String      ACTION_REQUEST_DISCOVERABLE      

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

被搜寻模式和SCAN_MODE_CONNECTABLE_DISCOVERABLE等价。当远程设备执行查找进程的时候,它允许其发现该蓝牙适配器。

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

该意图的发送者可以选择性地运用EXTRA_DISCOVERABLE_DURATION这个附加域去请求发现设备的持续时间。普遍来说,对于每一请求,默认的持续时间为120秒,最大值则可达到300秒。

Android 运用onActivityResult(int, int, Intent)回收方法来传递该活动结果的通知。被搜寻的时间(以秒为单位)将通过resultCode值来显示,如果用户拒绝被搜寻,或者设备产生了错 误,则通过RESULT_CANCELED值来显示。

每当扫描模式变化的时候,应用程序可以为通过ACTION_SCAN_MODE_CHANGED值来监听全局的消息通知。比如,当设备停止被搜寻以后,该消息可以被系统通知給应用程序。

需要BLUETOOTH权限

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

 

String      ACTION_REQUEST_ENABLE

Activity活动:显示一个允许用户打开蓝牙模块的系统活动。

当蓝牙模块完成打开工作,或者当用户决定不打开蓝牙模块时,系统活动将返回该值。

Android 运用onActivityResult(int, int, Intent)回收方法来传递该活动结果的通知。如果蓝牙模块被打开,将通过resultCodeRESULT_OK来显示;如果用户拒绝该请求,或者设备产生了错误,则通过RESULT_CANCELED值来显示。

         每当蓝牙模块被打开或者关闭,应用程序可以为通过ACTION_STATE_CHANGED值来监听全局的消息通知。

需要BLUETOOTH权限

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

 

String      ACTION_SCAN_MODE_CHANGED        

广播活动:指明蓝牙扫描模块或者本地适配器已经发生变化

它总是包含EXTRA_SCAN_MODEEXTRA_PREVIOUS_SCAN_MODE。这两个附加域各自包含了新的和旧的扫描模式。

需要BLUETOOTH权限

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

 

String      ACTION_STATE_CHANGED   

广播活动:本来的蓝牙适配器的状态已经改变。

例如:蓝牙模块已经被打开或者关闭。

它总是包含EXTRA_STATEEXTRA_PREVIOUS_STATE。这两个附加域各自包含了新的和旧的状态。

需要BLUETOOTH权限接收

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

 

int   ERROR   

标记该类的错误值。确保和该类中的任意其它整数常量不相等。它为需要一个标记错误值的函数提供了便利。例如:

Intent.getIntExtra(BluetoothAdapter.EXTRA_STATE, BluetoothAdapter.ERROR)

常量值: -2147483648 (0x80000000)

 

String      EXTRA_DISCOVERABLE_DURATION     

试图在ACTION_REQUEST_DISCOVERABLE常量中作为一个可选的整型附加域,来为短时间内的设备发现请求一个特定的持续时间。默认值为120秒,超过300秒的请求将被限制。这些值是可以变化的。

常量值: "android.bluetooth.adapter.extra.DISCOVERABLE_DURATION"

 

String      EXTRA_LOCAL_NAME   

试图在ACTION_LOCAL_NAME_CHANGED常量中作为一个字符串附加域,来请求本地蓝牙的名称。

常量值: "android.bluetooth.adapter.extra.LOCAL_NAME"

 

String      EXTRA_PREVIOUS_SCAN_MODE  

试图在ACTION_SCAN_MODE_CHANGED常量中作为一个整型附加域,来请求以前的扫描模式。可能值有: SCAN_MODE_NONE, SCAN_MODE_CONNECTABLE, SCAN_MODE_CONNECTABLE_DISCOVERABLE

常量值: "android.bluetooth.adapter.extra.PREVIOUS_SCAN_MODE"

 

String      EXTRA_PREVIOUS_STATE      

试图在ACTION_STATE_CHANGED常量中作为一个整型附加域,来请求以前的供电状态。 可能值有: STATE_OFF, STATE_TURNING_ON, STATE_ON, STATE_TURNING_OFF

常量值: "android.bluetooth.adapter.extra.PREVIOUS_STATE"

 

String      EXTRA_SCAN_MODE     

试图在ACTION_SCAN_MODE_CHANGED常量中作为一个整型附加域,来请求当前的扫描模式.可能值有: SCAN_MODE_NONE, SCAN_MODE_CONNECTABLE, SCAN_MODE_CONNECTABLE_DISCOVERABLE

常量值: "android.bluetooth.adapter.extra.SCAN_MODE"

 

String      EXTRA_STATE         

试图在ACTION_STATE_CHANGED常量中作为一个整型附加域,来请求当前的供电状态。 可能值有: STATE_OFF, STATE_TURNING_ON, STATE_ON, STATE_TURNING_OFF

常量值: "android.bluetooth.adapter.extra.STATE"

 

int   SCAN_MODE_CONNECTABLE       

指明在本地蓝牙适配器中,查询扫描功能失效,但页面扫描功能有效。因此该设备不能被远程蓝牙设备发现,但如果以前曾经发现过该设备,则远程设备可以对其进行连接。

常量值: 21 (0x00000015)

 

int   SCAN_MODE_CONNECTABLE_DISCOVERABLE    

指明在本地蓝牙适配器中,查询扫描功能和页面扫描功能都有效。因此该设备既可以被远程蓝牙设备发现,也可以被其连接。

常量值: 23 (0x00000017)

 

int   SCAN_MODE_NONE      

指明在本地蓝牙适配器中,查询扫描功能和页面扫描功能都失效. 因此该设备既不可以被远程蓝牙设备发现,也不可以被其连接。

常量值: 20 (0x00000014)

 

int   STATE_OFF     

指明本地蓝牙适配器模块已经关闭

常量值: 10 (0x0000000a)

 

int   STATE_ON      

指明本地蓝牙适配器模块已经打开,并且准备被使用。

常量值: 12 (0x0000000c)

 

int   STATE_TURNING_OFF   

指明本地蓝牙适配器模块正在关闭。本地客户端可以立刻尝试友好地断开任意外部连接。

常量值: 13 (0x0000000d)

 

int   STATE_TURNING_ON    

指明本地蓝牙适配器模块正在打开. 然而本地客户在尝试使用这个适配器之前需要为STATE_ON状态而等待。

常量值: 11 (0x0000000b)

 

公共方法

public boolean cancelDiscovery ()

取消当前的设备发现查找进程

需要BLUETOOTH_ADMIN权限。

因为对蓝牙适配器而言,查找是一个重量级的过程,因此这个方法必须在尝试连接到远程设备前使用用connect()方法进行调用。发现的过程不会由活动来进行管理,但是它会作为一个系统服务来运行,因此即使它不能直接请求这样的一个查询动作,也必需取消该搜索进程。

如果蓝牙状态不是STATE_ON,这个API将返回false。蓝牙打开后,等待ACTION_STATE_CHANGED更新成STATE_ON

返回值

成功则返回true,有错误则返回false

 

public static boolean checkBluetoothAddress (String address)

验证皆如"00:43:A8:23:10:F0"之类的蓝牙地址。

字母必须为大写才有效。

参数

address 字符串形式的蓝牙模块地址

返回值

地址正确则返回true,否则返回false

 

public boolean disable ()

关闭本地蓝牙适配器不能在没有明确关闭蓝牙的用户动作中使用。

这个方法友好地停止所有的蓝牙连接,停止蓝牙系统服务,以及对所有基础蓝牙硬件进行断电。

没有用户的直接同意,蓝牙永远不能被禁止。这个disable()方法只提供了一个应用,该应用包含了一个改变系统设置的用户界面(例如“电源控制”应用)。

这 是一个异步调用方法:该方法将马上获得返回值,用户要通过监听ACTION_STATE_CHANGED值来获取随后的适配器状态改变的通知。如果该调用 返回true值,则该适配器状态会立刻从STATE_ON转向STATE_TURNING_OFF,稍后则会转为STATE_OFF或者 STATE_ON。如果该调用返回false,那么系统已经有一个保护蓝牙适配器被关闭的问题比如该适配器已经被关闭了。

需要BLUETOOTH_ADMIN权限。

                   返回值

如果蓝牙适配器的停止进程已经开启则返回true,如果产生错误则返回false

 

public boolean enable ()

         打开本地蓝牙适配器不能在没有明确打开蓝牙的用户动作中使用。

该方法将为基础的蓝牙硬件供电,并且启动所有的蓝牙系统服务。

没有用户的直接同意,蓝牙永远不能被禁止。如果用户为了创建无线连接而打开了蓝牙模块,则其需要ACTION_REQUEST_ENABLE值,该值将提出 一个请求用户允许以打开蓝牙模块的会话。这个enable()值只提供了一个应用,该应用包含了一个改变系统设置的用户界面(例如“电源控制”应用)。

这是一个异步调用方法:该方法将马上获得返回值,用户要通过监听ACTION_STATE_CHANGED值来获取随后的适配器状态改变的通知。如果该调用 返回true值,则该适配器状态会立刻从STATE_OFF转向STATE_TURNING_ON,稍后则会转为STATE_OFF或者 STATE_ON。如果该调用返回false,那么说明系统已经有一个保护蓝牙适配器被打开的问题比如飞行模式,或者该适配器已经被打开。

需要BLUETOOTH_ADMIN权限。

返回值    

如果蓝牙适配器的打开进程已经开启则返回true,如果产生错误则返回false

 

public String getAddress ()

返回本地蓝牙适配器的硬件地址

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

需要BLUETOOTH权限。

返回值    

字符串形式的蓝牙模块地址

 

public Set getBondedDevices ()

返回已经匹配到本地适配器的BluetoothDevice类的对象集合

如果蓝牙状态不是STATE_ON,这个API将返回false。蓝牙打开后,等待ACTION_STATE_CHANGED更新成STATE_ON

需要BLUETOOTH权限。

返回值

未被修改的BluetoothDevice类的对象集合,如果有错误则返回null

 

public static synchronized BluetoothAdapter getDefaultAdapter ()

获取对默认本地蓝牙适配器的的操作权限。

目前Andoird只支持一个蓝牙适配器,但是API可以被扩展为支持多个适配器。该方法总是返回默认的适配器。

返回值

返回默认的本地适配器,如果蓝牙适配器在该硬件平台上不能被支持,则返回null

 

public String getName ()

获取本地蓝牙适配器的蓝牙名称

这个名称对于外界蓝牙设备而言是可见的。

需要BLUETOOTH权限。

返回值

该蓝牙适配器名称,如果有错误则返回null

 

public BluetoothDevice getRemoteDevice (String address)

为给予的蓝牙硬件地址获取一个BluetoothDevice对象。

         合法的蓝牙硬件地址必须为大写,格式类似于"00:11:22:33:AA:BB"checkBluetoothAddress(String)方法可以用来验证蓝牙地址的正确性。

BluetoothDevice类对于合法的硬件地址总会产生返回值,即使这个适配器从未见过该设备。

参数

address 合法的蓝牙MAC地址

异常

IllegalArgumentException      如果地址不合法

 

public int getScanMode ()

获取本地蓝牙适配器的当前蓝牙扫描模式

蓝牙扫描模式决定本地适配器可连接并且/或者可被远程蓝牙设备所连接。

可能值有: SCAN_MODE_NONE, SCAN_MODE_CONNECTABLE, SCAN_MODE_CONNECTABLE_DISCOVERABLE.

如果蓝牙状态不是STATE_ON,这个API将返回false。蓝牙打开后,等待ACTION_STATE_CHANGED更新成STATE_ON

需要BLUETOOTH权限。

         返回值

扫描模式

 

public int getState ()

获取本地蓝牙适配器的当前状态

可能值有 STATE_OFF, STATE_TURNING_ON, STATE_ON, STATE_TURNING_OFF.
需要BLUETOOTH

需要BLUETOOTH权限。

                   返回值

current state of Bluetooth adapter

 

public boolean isDiscovering ()

如果当前蓝牙适配器正处于设备发现查找进程中,则返回真值

设备查找是一个重量级过程。当查找正在进行的时候,用户不能尝试对新的远程蓝牙设备进行连接,同时存在的连接将获得有限制的带宽以及高等待时间。用户可用cencelDiscovery()类来取消正在执行的查找进程。

应用程序也可以为ACTION_DISCOVERY_STARTED或者ACTION_DISCOVERY_FINISHED进行注册,从而当查找开始或者完成的时候,可以获得通知。

如果蓝牙状态不是STATE_ON,这个API将返回false。蓝牙打开后,等待ACTION_STATE_CHANGED更新成STATE_ON

需要BLUETOOTH权限。

                   返回值

如果正在查找,则返回true

 

public boolean isEnabled ()

如果蓝牙正处于打开状态并可用,则返回真值

getBluetoothState()==STATE_ON 等价

需要BLUETOOTH权限。

                   返回值

如果本地适配器已经打开,则返回true

 

public BluetoothServerSocket listenUsingRfcommWithServiceRecord (String name, UUID uuid)

创建一个正在监听的安全的带有服务记录的无线射频通信(RFCOMM)蓝牙端口。

一个对该端口进行连接的远程设备将被认证,对该端口的通讯将被加密。

使用accpet()方法可以获取从监听BluetoothServerSocket处新来的连接

该系统分配一个未被使用的无线射频通信通道来进行监听。

该系统也将注册一个服务探索协议(SDP)记录,该记录带有一个包含了特定 的通用唯一识别码(Universally Unique IdentifierUUID),服务器名称和自动分配通道的本地SDP服务。远程蓝牙设备可以用相同的UUID来查询自己的SDP服务器,并搜寻连接 到了哪个通道上。如果该端口已经关闭,或者如果该应用程序异常退出,则这个SDP记录会被移除。

使用createRfcommSocketToServiceRecord(UUID)从另一使用相同UUID的设备来连接到这个端口

需要BLUETOOTH权限。

参数

name       SDP记录下的服务器名

uuid         SDP记录下的UUID

                   返回值

一个正在监听的无线射频通信蓝牙服务端口

异常

IOException    产生错误,比如蓝牙设备不可用,或者许可无效,或者通道被占用。

 

public boolean setName (String name)

设置蓝牙或者本地蓝牙适配器的昵称.

这个名字对于外界蓝牙设备而言是可见的。

合法的蓝牙名称最多拥有248UTF-8字符,但是很多外界设备只能显示前40个字符,有些可能只限制前20个字符。

如果蓝牙状态不是STATE_ON,这个API将返回false。蓝牙打开后,等待ACTION_STATE_CHANGED更新成STATE_ON

需要BLUETOOTH_ADMIN权限。

参数

name       一个合法的蓝牙名称

返回值

如果该名称已被设定,则返回true,否则返回false

 

public boolean startDiscovery ()

开始对远程设备进行查找的进程

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

这是一个异步调用方法:该方法将马上获得返回值,注册ACTION_DISCOVERY_STARTED and ACTION_DISCOVERY_FINISHED意图准确地确定该探索是处于开始阶段或者完成阶段。注册ACTION_FOUND以活动远程蓝牙设备 已找到的通知。

设备查找是一个重量级过程。当查找正在进行的时候,用户不能尝试对新的远程蓝牙设备进行连接,同时存在的连接将获得有限制的带宽以 及高等待时间。用户可用cencelDiscovery()类来取消正在执行的查找进程。发现的过程不会由活动来进行管理,但是它会作为一个系统服务来运 行,因此即使它不能直接请求这样的一个查询动作,也必需取消该搜索进程。

设备搜寻只寻找已经被连接的远程设备。许多蓝牙设备默认不会被搜寻到,并且需要进入到一个特殊的模式当中。

如果蓝牙状态不是STATE_ON,这个API将返回false。蓝牙打开后,等待ACTION_STATE_CHANGED更新成STATE_ON

需要BLUETOOTH_ADMIN权限。

返回值

成功返回true,错误返回false

BluetoothDevice

结构

继承关系

public final 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附加域

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

需要BLUETOOTH权限接收

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

                                                  

String ACTION_ACL_DISCONNECTED     

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

总是包含EXTRA_DEVICE附加域

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

需要BLUETOOTH权限接收

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

 

String ACTION_ACL_DISCONNECT_REQUESTED    

广播活动:指明一个为远程设备提出的低级别(ACL)的断开连接请求,并即将断开连接。

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

总是包含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_DEVICEEXTRA_BOND_STATE这些附加域。

需要BLUETOOTH权限接收

  参见

     ERROR(BluetoothClass} /{@link BluetoothClass})

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

 

String ACTION_FOUND    

广播活动:发现远程设备

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

总是包含EXTRA_DEVICEEXTRA_CLASS这些附加域。如果可用的话,也可包含EXTRA_NAME/EXTRA_RSSI这些附加域。

需要BLUETOOTH权限接收

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

 

String ACTION_NAME_CHANGED  

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

总是包含EXTRA_DEVICEEXTRA_NAME这些附加域

需要BLUETOOTH权限接收

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

 

int        BOND_BONDED    

指明远程设备已经匹配。

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

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

常量值: 12 (0x0000000c)

 

int        BOND_BONDING  

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

常量值: 11 (0x0000000b)

 

int        BOND_NONE          

指明远程设备未被匹配。

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

     常量值: 10 (0x0000000a)

 

Creator         CREATOR        

 

int        ERROR   

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

常量值: -2147483648 (0x80000000)

 

String EXTRA_BOND_STATE     

作为一个ACTION_BOND_STATE_CHANGED的整型附加域。包含了远程设备的匹配状态。

可能值有: BOND_NONE, BOND_BONDING, BOND_BONDED.

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

 

String EXTRA_CLASS         

作为一个ACTION_FOUNDACTION_CLASS_CHANGEDParcelabe BluetoothClass附加域。

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

 

String EXTRA_DEVICE      

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

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

 

String EXTRA_NAME        

作为ACTION_NAME_CHANGEDACTION_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 BluetoothSocket createRfcommSocketToServiceRecord (UUID uuid)

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

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

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

     提示:如果你正试图连接蓝牙串口,那么使用众所周知的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 equals 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 hashCode method

返回值

该对象的哈希值

 

     public String toString ()

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

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

返回值

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

 

     public void writeToParcel (Parcel out, int flags)

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

参数

out 对象需要被写入的Parcel

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



BluetoothServerSocket

结构

继承关系

public final class BluetoothServerSocket extends Object implements Closeable        

java.lang.Object

android.bluetooth.BluetoothServerSocket

 

类概述

         一个蓝牙监听端口。

         蓝牙端口监听接口和TCP端口类似:SocketServerSocket类。在服务器端,使用BluetoothServerSocket类来创建一个 监听服务端口。当一个连接被BluetoothServerSocket所接受,它会返回一个新的BluetoothSocket来管理该连接。在客户 端,使用一个单独的BluetoothSocket类去初始化一个外接连接和管理该连接。

         最通常使用的蓝牙端口是RFCOMM,它是被Android API支持的类型。RFCOMM是一个面向连接,通过蓝牙模块进行的数据流传输方式,它也被称为串行端口规范(Serial Port ProfileSPP)。

         为了创建一个对准备好的新来的连接去进行监听BluetoothServerSocket类,使用 BluetoothAdapter.listenUsingRfcommWithServiceRecord()方法。然后调用accept()方法去监 听该链接的请求。在连接建立之前,该调用会被阻断,也就是说,它将返回一个BluetoothSocket类去管理该连接。每次获得该类之后,如果不再需 要接受连接,最好调用在BluetoothServerSocket类下的close()方法。关闭BluetoothServerSocket类不会关 闭这个已经返回的BluetoothSocket类。

         BluetoothSocket类线程安全。特别的,close()方法总会马上放弃外界操作并关闭服务器端口。

         注意:需要BLUETOOTH权限。

         参见

                   BluetoothSocket

 

公共方法

public BluetoothSocket accept (int timeout)

         阻塞直到超时时间内的连接建立。

         在一个成功建立的连接上返回一个已连接的BluetoothSocket类。

         每当该调用返回的时候,它可以在此调用去接收以后新来的连接。

         close()方法可以用来放弃从另一线程来的调用。

                   参数

                            timeout    (译者注:阻塞超时时间)

                   返回值

                            已连接的 BluetoothSocket

                   异常

                            IOException     出现错误,比如该调用被放弃,或者超时。

 

public BluetoothSocket accept ()

         阻塞直到一个连接已经建立。(译者注:默认超时时间设置为-1,见源码)

         在一个成功建立的连接上返回一个已连接的BluetoothSocket类。

         每当该调用返回的时候,它可以在此调用去接收以后新来的连接。

         close()方法可以用来放弃从另一线程来的调用。

                   返回值

                            已连接的 BluetoothSocket

                   异常

                            IOException     出现错误,比如该调用被放弃,或者超时。

 

         public void close ()

马上关闭端口,并释放所有相关的资源。

在其他线程的该端口中引起阻塞,从而使系统马上抛出一个IO异常。

关闭BluetoothServerSocket不会关闭接受自accept()的任意BluetoothSocket

异常

IOException




BluetoothSocket

 

结构

继承关系

public final class BluetoothSocket extends Object implements Closeable

        

java.lang.Object

android.bluetooth.BluetoothSocket

 

类概述

         已连接或连接到蓝牙套接字(socket)

         蓝牙端口监听接口和TCP端口类似:SocketServerSocket类。在服务器端,使用BluetoothServerSocket类来创建一个 监听服务端口。当一个连接被BluetoothServerSocket所接受,它会返回一个新的BluetoothSocket来管理该连接。在客户 端,使用一个单独的BluetoothSocket类去初始化一个外接连接和管理该连接。

最通常使用的蓝牙端口是RFCOMM,它是被Android API支持的类型。RFCOMM是一个面向连接,通过蓝牙模块进行的数据流传输方式,它也被称为串行端口规范(Serial Port ProfileSPP)。

为了创建一个BluetoothSocket去连接到一个已知设备,使用方法 BluetoothDevice.createRfcommSocketToServiceRecord()。然后调用connect()方法去尝试一个 面向远程设备的连接。这个调用将被阻塞指导一个连接已经建立或者该链接失效。

为了创建一个BluetoothSocket作为服务端(或者主机),查看BluetoothServerSocket文档。

每当该端口连接成功,无论它初始化为客户端,或者被接受作为服务器端,通过getInputStream()getOutputStream()来打开IO流,从而获得各自的InputStreamOutputStream对象

BluetoothSocket类线程安全。特别的,close()方法总会马上放弃外界操作并关闭服务器端口。

注意:需要BLUETOOTH权限。

参见

         BluetoothServerSocket

    InputStream

    OutputStream

 

公共方法

    public void close ()

马上关闭该端口并且释放所有相关的资源。

在其它线程的该端口中引起阻塞,从而使系统马上抛出一个IO异常。

异常

IOException

 

    public void connect ()

尝试连接到远程设备。

该方法将阻塞,指导一个连接建立或者失效。如果该方法没有返回异常值,则该端口现在已经建立。

当设备查找正在进行的时候,创建对远程蓝牙设备的新连接不可被尝试。在蓝牙适配器上,设备查找是一个重量级过程,并且肯定会降低一个设备的连接。使用 cancelDiscovery()方法去取消一个外界的查询。查询并不由活动所管理,而作为一个系统服务来运行,所以即使它不能直接请求一个查询,应用 程序也总会调用cancelDiscovery()方法。

close()方法可以用来放弃从另一线程而来的调用。

异常

IOException     一个错误,例如连接失败。

 

    public InputStream getInputStream ()

通过连接的端口获得输入数据流

即使该端口未连接,该输入数据流也会返回。不过在该数据流上的操作将抛出异常,直到相关的连接已经建立。

返回值

输入流

异常

IOException

 

    public OutputStream getOutputStream ()

通过连接的端口获得输出数据流

即使该端口未连接,该输出数据流也会返回。不过在该数据流上的操作将抛出异常,直到相关的连接已经建立。

返回值

输出流

异常

IOException

 

    public BluetoothDevice getRemoteDevice ()

获得该端口正在连接或者已经连接的远程设备。

返回值

远程设备




阅读(1295) | 评论(0) | 转发(0) |
给主人留下些什么吧!~~