Android Bluetooth 蓝牙2.0使用方式¶
2023-03-27 更新文档
- 2023-03-27 更新文档
代码基于 Android L
获取BluetoothAdapter，搜索蓝牙设备，发起socket连接，从外围蓝牙设备中获取到数据。
常用类说明¶
BluetoothAdapter¶
首先调用静态方法getDefaultAdapter()获取蓝牙适配器bluetoothadapter， 如果返回为空，则表明此设备不支持蓝牙。
代表本地蓝牙适配器。BluetoothAdapter 让你进行基础的蓝牙操作，比如初始化搜索设备，对已配对设备进行检索，根据一直MAC地址 实例化一个 BluetoothDevice，建立一个监听其他设备连接请求的 BluetoothServerSocket，启动对蓝牙LE设备的搜索。
这是使用蓝牙的起点。获得了本地适配器后，可以调用getBondedDevices()获得代表配对设备的 BluetoothDevice 对象
startDiscovery()启动搜索蓝牙设备。或者建立一个BluetoothServerSocket ，
调用listenUsingRfcommWithServiceRecord(String, UUID)来监听接入请求
startLeScan(LeScanCallback) 搜索Bluetooth LE 设备
相应的源码 BluetoothAdapter.java (frameworks/base/core/java/android/bluetooth)
/**
* Get a handle to the default local Bluetooth adapter.
* <p>Currently Android only supports one Bluetooth adapter, but the API
* could be extended to support more. This will always return the default
* adapter.
* @return the default local adapter, or null if Bluetooth is not supported
* on this hardware platform
*/
public static synchronized BluetoothAdapter getDefaultAdapter() {
if (sAdapter == null) {
IBinder b = ServiceManager.getService(BLUETOOTH_MANAGER_SERVICE);
if (b != null) {
IBluetoothManager managerService = IBluetoothManager.Stub.asInterface(b);
sAdapter = new BluetoothAdapter(managerService);
} else {
Log.e(TAG, "Bluetooth binder is null");
}
}
return sAdapter;
}
BluetoothSocket¶
一个连接上或连接中的socket 使用BluetoothServerSocket来创建一个监听的服务socket。 对于服务端，当BluetoothServerSocket接收了一个连接，会返回一个新的BluetoothSocket来管理这个连接。 对于客户端，使用一个单独的BluetoothSocket来初始化一个发送连接并管理这个连接。 蓝牙socket最普通的模式是RFCOMM，这是Android API支持的模式。 RFCOMM面向连接，使用流传输。也称为Serial Port Profile (SPP)
建立一个到已知蓝牙设备的BluetoothSocket，使用BluetoothDevice.createRfcommSocketToServiceRecord()
然后调用connect()来连接这个远程设备。调用这个方法会阻塞程序直到建立连接或者连接失败。
一旦socket连接上，不论初始化为客户端或者服务端，调用getInputStream()和getOutputStream()打开IO流来分别接收
输入流和输出流对象。流对象自动连接到socket
BluetoothSocket是线程安全的。特别的是，close()会立刻关闭进行中的操作并关闭socket。
需要 BLUETOOTH 相关权限
BluetoothServerSocket¶
一个监听的蓝牙socket 在服务端，使用BluetoothServerSocket来建立一个监听的服务socket。
使用BluetoothAdapter.listenUsingRfcommWithServiceRecord()来建立一个监听接入连接的BluetoothServerSocket
然后调用accept()监听连接请求。这个调用会阻塞，直到建立连接，并返回一个管理连接的BluetoothSocket
获得了 BluetoothSocket，并且不再需要连接，可以调用close()来关闭掉 BluetoothServerSocket
关闭 BluetoothServerSocket 并不会关闭返回的 BluetoothSocket
BluetoothServerSocket 是线程安全的，特别的是，close()会立刻关闭进行中的操作并关闭服务 socket。
BluetoothDevice¶
代表一个远程蓝牙设备。BluetoothDevice 能让你与其他设备建立连接，或者查询设备信息，比如名称，地址，类别和连接状态等。 这是蓝牙硬件地址的简单包装类。找个类的对象都说不可变的。这个类的操作会在远程蓝牙硬件地址上体现。
通过一个已知的MAC地址（可用BluetoothDevice来发现），或是通过BluetoothAdapter.getBondedDevices()返回的已连接设备
调用BluetoothAdapter.getRemoteDevice(String)来获得一个 BluetoothDevice。
然后就可以打开 BluetoothSocket 来与远程设备建立连接，调用createRfcommSocketToServiceRecord(UUID)
API 说明¶
- 搜索其他蓝牙设备
- 检索匹配到的蓝牙设备
- 建立RFCOMM频道
- 通过发现服务来连接其他设备
- 管理多个连接
Setting Up Bluetooth 设置蓝牙¶
使用蓝牙通信前，确定设备支持蓝牙，并将蓝牙打开
1.获取 BluetoothAdapter
使用静态方法BluetoothAdapter.getDefaultAdapter()获取机器的蓝牙适配器；若返回null，则表示机器不支持蓝牙
BluetoothAdapter mBluetoothAdapter = BluetoothAdapter.getDefaultAdapter();
if (mBluetoothAdapter == null) {
// Device does not support Bluetooth
}
if (!mBluetoothAdapter.isEnabled()) {
Intent enableBtIntent = new Intent(BluetoothAdapter.ACTION_REQUEST_ENABLE);
startActivityForResult(enableBtIntent, REQUEST_ENABLE_BT);
}
可以让应用监听 ACTION_STATE_CHANGED ，当蓝牙状态改变时会发出这个广播。这个广播包括蓝牙原先状态和现在状态，分别装在 EXTRA_PREVIOUS_STATE 和 EXTRA_STATE 里。 状态可能是 STATE_TURNING_ON， STATE_ON， STATE_TURNING_OFF， 和 STATE_OFF
Finding Devices 寻找设备¶
使用 BluetoothAdapter，可以寻找远程蓝牙设备或检索匹配设备
搜索设备是搜索本地区域已开启的蓝牙设备程序。蓝牙设备有可见模式和不可见模式。如果一个设备是可发现的，它会相应搜索请求并 返回一些信息，比如设备名，类别，独立的MAC地址。利用这些信息，设备可以初始化一个到被发现设备的连接。
第一次与其他设备连接建立，会自动弹出一个配对请求给用户。成功配对后，设备的基本信息会被保存下来，并且可以被蓝牙API调用。 使用已知的远程设备的MAC地址，可以在不搜索设备的情况下建立连接。
配对和连接是不同的。配对表示两个设备知道对方的存在，有相互认证的key，能够与对方建立加密的连接。 连接意味着设备目前共享一个RFCOMM频道，并能相互发送数据。目前android蓝牙API要求设备先配对，再进行连接。
注意：Android设备并不是默认蓝牙可见的。用户可以在系统设置中让设备蓝牙可被搜索到。
Querying paired devices 检索已配对的设备¶
搜索设备前，可以调用getBondedDevices()检索一下已配对的设备。这会返回配对设备的BluetoothDevices集合。
例如，你可以检索配对设备并把每个设备信息存入 ArrayAdapter ：
Set<BluetoothDevice> pairedDevices = mBluetoothAdapter.getBondedDevices();
// If there are paired devices
if (pairedDevices.size() > 0) {
// Loop through paired devices
for (BluetoothDevice device : pairedDevices) {
// Add the name and address to an array adapter to show in a ListView
mArrayAdapter.add(device.getName() + "\n" + device.getAddress());
}
}
Discovering devices 搜索设备¶
调用startDiscovery()搜索设备。这个异步进程会立刻返回是否启动成功的boolean值。搜索进程通常是inquiry scan进行12秒，
接下来是每个发现设备的 page scan 。
你的应用必须注册一个广播接收器来监听 ACTION_FOUND ，接收发现的每个设备的信息。每发现一个设备，系统会发送 ACTION_FOUND 这个 Intent 带有 EXTRA_DEVICE 和 EXTRA_CLASS，里面分别包含 BluetoothDevice 和一个 BluetoothClass 例如，注册一个广播接收器来监听被发现设备：
// Create a BroadcastReceiver for ACTION_FOUND
private final BroadcastReceiver mReceiver = new BroadcastReceiver() {
public void onReceive(Context context, Intent intent) {
String action = intent.getAction();
// When discovery finds a device
if (BluetoothDevice.ACTION_FOUND.equals(action)) {
// Get the BluetoothDevice object from the Intent
BluetoothDevice device = intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE);
// Add the name and address to an array adapter to show in a ListView
mArrayAdapter.add(device.getName() + "\n" + device.getAddress());
}
}
};
// Register the BroadcastReceiver
IntentFilter filter = new IntentFilter(BluetoothDevice.ACTION_FOUND);
registerReceiver(mReceiver, filter); // Don't forget to unregister during onDestroy
警告：搜索设备对于蓝牙适配器来说是一个耗费资源的进程。发现目标设备后，一定要在连接前调用cancelDiscovery()停止搜索。
不要在与设备连接时启动搜索。搜索设备会减小连接的带宽。
Enabling discoverability 激活设备蓝牙可见¶
如果想让本地设备对其他设备蓝牙可见，调用startActivityForResult(Intent, int)，传入ACTION_REQUEST_DISCOVERABLE
这会请求激活系统设置。默认激活120秒。可以用EXTRA_DISCOVERABLE_DURATION来请求别的时间。应用可设最长时间是3600秒。
0表示设备永远可见。在0~3600外的数字会被设置为120秒。比如，将时间设置为300秒：
Intent discoverableIntent = new Intent(BluetoothAdapter.ACTION_REQUEST_DISCOVERABLE);
discoverableIntent.putExtra(BluetoothAdapter.EXTRA_DISCOVERABLE_DURATION, 300);
startActivity(discoverableIntent);
onActivityResult()回调，并传回
设置蓝牙可见时间的数值。如果用户点击“No”或出现错误，返回代码会是 RESULT_CANCELED 。
注意：如果设备未开启蓝牙，将设备蓝牙设为可见会自动打开蓝牙
设备会在允许时间内保持沉默。可以注册广播接收器来监听 ACTION_SCAN_MODE_CHANGED 。这个Intent会带着 EXTRA_SCAN_MODE 和 EXTRA_PREVIOUS_SCAN_MODE，分别是新的和旧的状态。可能的状态值会是： SCAN_MODE_CONNECTABLE_DISCOVERABLE， SCAN_MODE_CONNECTABLE， 或 SCAN_MODE_NONE
如果要与远程设备连接，可以不激活设备可见。当应用想要建立服务socket获取接入时，必须打开设备可见。因为远程设备必须要发现 本地设备来建立连接。
Connecting Devices 连接设备¶
服务端设备和客户端设备以不同的方式获取 BluetoothSocket。连接建立时，服务端获取一个 BluetoothSocket。 客户端打开一个RFCOMM时会得到 BluetoothSocket 。
Connecting as a server 在连接中作为服务端¶
当你要连接2个设备，其中一个必须作为服务器并持有一个打开的 BluetoothServerSocket 。服务socket的目的是获取接入请求并
给已连上设备一个 BluetoothSocket 。当从 BluetoothServerSocket 获取到 BluetoothSocket，BluetoothServerSocket
可以关闭掉，除非你想接入更多连接。
1. 调用listenUsingRfcommWithServiceRecord(String, UUID)来获得一个 BluetoothServerSocket
2. 调用accept() 来监听接入请求
3. 如果不需要接入更多连接，调用close()
accept()不应该在UI线程中调用，因为它是阻塞式的。通常在应用中启动新的线程来操作BluetoothServerSocket 或 BluetoothSocket
在另一个线程调用BluetoothServerSocket （或 BluetoothSocket）的close()能跳出阻塞，并立刻返回
例子：
private class AcceptThread extends Thread {
private final BluetoothServerSocket mmServerSocket;
public AcceptThread() {
// Use a temporary object that is later assigned to mmServerSocket,
// because mmServerSocket is final
BluetoothServerSocket tmp = null;
try {
// MY_UUID is the app's UUID string, also used by the client code
tmp = mBluetoothAdapter.listenUsingRfcommWithServiceRecord(NAME, MY_UUID);
} catch (IOException e) { }
mmServerSocket = tmp;
}
public void run() {
BluetoothSocket socket = null;
// Keep listening until exception occurs or a socket is returned
while (true) {
try {
socket = mmServerSocket.accept();
} catch (IOException e) {
break;
}
// If a connection was accepted
if (socket != null) {
// Do work to manage the connection (in a separate thread)
manageConnectedSocket(socket);
mmServerSocket.close();
break;
}
}
}
/** Will cancel the listening socket, and cause the thread to finish */
public void cancel() {
try {
mmServerSocket.close();
} catch (IOException e) { }
}
}
当accept()返回 BluetoothSocket，这个socket已经是连接上的了。因此不必调用connect()（客户端也一样）
manageConnectedSocket()是一个虚构的方法，用来初始化传输数据的线程，在连接管理中来讨论它
监听接入连接结束后通常要立刻关闭 BluetoothServerSocket 。这个例子中，获取 BluetoothSocket 后立刻调用了close()。
可以在线程中写一个公共方法来关闭私有的 BluetoothSocket 。当需要停止监听服务socket时可以使用这个方法。
Connecting as a client 在连接中作为客户端¶
与远程设备（服务端）建立连接，先获取一个代表远程设备的 BluetoothDevice 对象。必须使用 BluetoothDevice 来获取 BluetoothSocket 并初始化连接。
基本流程：
1. 调用BluetoothDevice的createRfcommSocketToServiceRecord(UUID)获取BluetoothSocket
2. 调用connect()来初始化连接
注意：在调用connect()时必须确保设备不在搜索进行中。在搜索设备时，连接尝试会变慢并且很容易失败。
private class ConnectThread extends Thread {
private final BluetoothSocket mmSocket;
private final BluetoothDevice mmDevice;
public ConnectThread(BluetoothDevice device) {
// Use a temporary object that is later assigned to mmSocket,
// because mmSocket is final
BluetoothSocket tmp = null;
mmDevice = device;
// Get a BluetoothSocket to connect with the given BluetoothDevice
try {
// MY_UUID is the app's UUID string, also used by the server code
tmp = device.createRfcommSocketToServiceRecord(MY_UUID);
} catch (IOException e) { }
mmSocket = tmp;
}
public void run() {
// Cancel discovery because it will slow down the connection
mBluetoothAdapter.cancelDiscovery();
try {
// Connect the device through the socket. This will block
// until it succeeds or throws an exception
mmSocket.connect();
} catch (IOException connectException) {
// Unable to connect; close the socket and get out
try {
mmSocket.close();
} catch (IOException closeException) { }
return;
}
// Do work to manage the connection (in a separate thread)
manageConnectedSocket(mmSocket);
}
/** Will cancel an in-progress connection, and close the socket */
public void cancel() {
try {
mmSocket.close();
} catch (IOException e) { }
}
}
cancelDiscovery()。
manageConnectedSocket()是一个虚构的方法，在连接管理中讨论它。
使用完BluetoothSocket，一定要调用close()来结束
Managing a Connection¶
成功连接2个或更多的设备后，每个设备有一个 BluetoothSocket 。设备直接可以共享数据。使用BluetoothSocket传输任意数据
获取处理传输的 InputStream 和 OutputStream，分别调用 getInputStream() 和 getOutputStream()
调用read(byte[]) 和 write(byte[]) 来读写数据
线程的主循环中应该用于专门从InputStream中读数据。线程中要有专门的public方法来写数据到OutputStream
private class ConnectedThread extends Thread {
private final BluetoothSocket mmSocket;
private final InputStream mmInStream;
private final OutputStream mmOutStream;
public ConnectedThread(BluetoothSocket socket) {
mmSocket = socket;
InputStream tmpIn = null;
OutputStream tmpOut = null;
// Get the input and output streams, using temp objects because
// member streams are final
try {
tmpIn = socket.getInputStream();
tmpOut = socket.getOutputStream();
} catch (IOException e) { }
mmInStream = tmpIn;
mmOutStream = tmpOut;
}
public void run() {
byte[] buffer = new byte[1024]; // buffer store for the stream
int bytes; // bytes returned from read()
// Keep listening to the InputStream until an exception occurs
while (true) {
try {
// Read from the InputStream
bytes = mmInStream.read(buffer);
// Send the obtained bytes to the UI activity
mHandler.obtainMessage(MESSAGE_READ, bytes, -1, buffer)
.sendToTarget();
} catch (IOException e) {
break;
}
}
}
/* Call this from the main activity to send data to the remote device */
public void write(byte[] bytes) {
try {
mmOutStream.write(bytes);
} catch (IOException e) { }
}
/* Call this from the main activity to shutdown the connection */
public void cancel() {
try {
mmSocket.close();
} catch (IOException e) { }
}
}
read(byte[])返回数据流，通过handler将数据送往
主activity。然后等待数据流中更多的字节
向外发送数据调用write()
线程的cancel()方法很重要。完成了蓝牙连接的所有操作后，应当cancel掉
参考¶
Android SPP连接蓝牙设备注意事项 :material-bluetooth:
本站说明
一起在知识的海洋里呛水吧。广告内容与本站无关。如果喜欢本站内容，欢迎投喂作者，谢谢支持服务器。如有疑问和建议，欢迎在下方评论~