蓝牙开发这部分主要以 APP 端调用功能接口为开始,到 Framework 端的调用流程,最后到调用状态机结束,不涉及蓝牙协议栈的开发分析。
一、BluetoothAdapter
1、APP获取适配器
蓝牙权限
<mainifest>
<uses-permission android:name="android.permission.BLUETOOTH"/>
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN"/>
</mainifest>
获取蓝牙适配器
所有的蓝牙 Activity 都是需要 BluetoothAdapter 的。获取 BluetoothAdapter 调用BluetoothAdapter 的静态方法 getDefaultAdapter() 方法。会返回一个表示设备自身的蓝牙适配器(蓝牙无线装置)的 BluetoothAdapter。如果返回 null 则说明该设备不支持蓝牙。
BluetoothAdapter btAdapter = BluetoothAdapter.getDefaultAdapter();
此时可以调用 BluetoothAdapter 中的各种方法实现蓝牙的基本操作了。
2、源码分析
BluetoothAdapter 创建及获取
public static final String BLUETOOTH_MANAGER_SERVICE = "bluetooth_manager";
private final IBluetoothManager mManagerService;
public static synchronized BluetoothAdapter getDefaultAdapter() {
if (sAdapter == null) {
sAdapter = createAdapter(BluetoothManager.resolveAttributionSource(null));
}
return sAdapter;
}
public static BluetoothAdapter createAdapter(AttributionSource attributionSource) {
IBinder binder = ServiceManager.getService(BLUETOOTH_MANAGER_SERVICE);
if (binder != null) {
return new BluetoothAdapter(IBluetoothManager.Stub.asInterface(binder), attributionSource);
} else {
Log.e(TAG, "Bluetooth binder is null");
return null;
}
}
BluetoothAdapter(IBluetoothManager managerService, AttributionSource attributionSource) {
mManagerService = Objects.requireNonNull(managerService);
mAttributionSource = Objects.requireNonNull(attributionSource);
synchronized (mServiceLock.writeLock()) {
mService = getBluetoothService(mManagerCallback);
}
mLeScanClients = new HashMap<LeScanCallback, ScanCallback>();
mToken = new Binder(DESCRIPTOR);
}
可以看到首先在我们调用的 getDefaultAdapter 方法里去创建 Adapter,然后在 BluetoothAdapter 的构造方法里去调用 getBluetoothService 方法得到 mService,且 mService 的类型为 IBluetooth,这是一个 aidl 的接口,他的实现实在 AdapterService.java 中。
源码位置:
/system/bt/service/common/android/bluetooth/IBluetooth.aidl
/packages/apps/Bluetooth/src/com/android/bluetooth/btservice/AdapterService.java
继续查看 BluetoothAdapter 源码,很多功能都是通过 mService 去调用 AdapterService 中的方法实现的。
常用方法
方法名 | 描述 |
---|---|
enable | 打开蓝牙功能 |
disable | 关闭蓝牙功能 |
isEnable | 判断蓝牙功能是否打开 |
startDiscovery | 开始搜索周围的蓝牙设备 |
cancelDiscovery | 取消搜索操作 |
isDiscovering | 判断当前是否正在搜索设备 |
getBondedDevices | 获取己绑定的设备列表 |
setName | 设置本机的蓝牙名称 |
getName | 获取本机的蓝牙名称 |
getAddress | 获取本机的蓝牙地址 |
getRemoteDevice | 根据蓝牙地址获取远程的蓝牙设备 |
getState | 获取本地蓝牙适配器的状态 |
Adapter属性变更
协议栈蓝牙属性发生变化,通过 AdapterProperties.java 中 adapterPropertyChangedCallback 回调函数通知上来。(此变更为车机侧属性变更)
static final int BT_PROPERTY_BDNAME = 0x01; // 车机蓝牙设备名称修改
static final int BT_PROPERTY_BDADDR = 0x02; // 车机蓝牙设备地址修改
static final int BT_PROPERTY_UUIDS = 0x03; // 车机蓝牙设备支持的协议更新
static final int BT_PROPERTY_CLASS_OF_DEVICE = 0x04; // 不常用
static final int BT_PROPERTY_ADAPTER_SCAN_MODE = 0x07; // 车机蓝牙设备可见性更新
static final int BT_PROPERTY_ADAPTER_BONDED_DEVICES = 0x08; // 返回车机蓝牙设备当前有多少配对成功的设备
static final int BT_PROPERTY_ADAPTER_DISCOVERABLE_TIMEOUT = 0x09; // 不常用
二、蓝牙开关On/Off
1、APP调用流程
1、BtSettings App:蓝牙配置和连接管理应用,包括蓝牙界面加载、蓝牙搜索、蓝牙连接、蓝牙重命名等管理功能。
2、BluetoothAdapter:车机侧蓝牙适配器,App 调用 FW 的主要接口文件,提供基本的蓝牙任务接口,例如:启动/取消设备扫描、查询/绑定/移除配对设备、实例化 BluetoothDevice等。
3、BluetoothManagerService:管理蓝牙开关和服务的状态,例如:屏蔽多次点击开关,同步蓝牙状态变更等。
4、AdapterService:BluetoothAdapter 的实现类,FW核心业务逻辑类。实现提供给App的接口。
2、代码流程解析
通过上面的分析,蓝牙 Activity 都是通过调用 BluetoothAdapter 中的方法实现对应功能,所以我们直接从 BluetoothAdapter 开始分析。
1)BluetoothAdapter.enable()
通过 BluetoothAdapter 调用蓝牙开关接口,实现蓝牙开关功能,这里以打开蓝牙的代码为例。
public boolean enable() {
if (isEnabled()) {
if (DBG) {
Log.d(TAG, "enable(): BT already enabled!");
}
return true;
}
try {
return mManagerService.enable(mAttributionSource);
} catch (RemoteException e) {
Log.e(TAG, "", e);
}
return false;
}
可以看到最后调用的是 mManagerService.enable(),通过代码可以看到mManagerService为IBluetoothManager.aidl 接口,所以实际调用的是 BluetoothManagerService.java 的 enable()。
2)BluetoothManagerService.enable()
class BluetoothManagerService extends IBluetoothManager.Stub {
public boolean enable(AttributionSource attributionSource) throws RemoteException {
final String packageName = attributionSource.getPackageName();
if (!checkBluetoothPermissions(attributionSource, "enable", true)) {
return false;
}
final int callingUid = Binder.getCallingUid();
final boolean callerSystem = UserHandle.getAppId(callingUid) == Process.SYSTEM_UID;
if (!callerSystem && !isEnabled() && mWirelessConsentRequired
&& startConsentUiIfNeeded(packageName,
callingUid, BluetoothAdapter.ACTION_REQUEST_ENABLE)) {
return false;
}
synchronized (mReceiver) {
mQuietEnableExternal = false;
mEnableExternal = true;
// waive WRITE_SECURE_SETTINGS permission check
sendEnableMsg(false,
BluetoothProtoEnums.ENABLE_DISABLE_REASON_APPLICATION_REQUEST, packageName);
}
return true;
}
}
这里通过 sendEnableMsg 最终会走到 handleEnable 方法,而 handleEnable 方法我们在蓝牙服务启动流程 中分析最终会调用 AdapterService 中对应的方法。
3)AdapterService.enable()
@Override
public boolean enable(boolean quietMode, AttributionSource attributionSource) {
AdapterService service = getService();
if (service == null || !callerIsSystemOrActiveUser(TAG, "enable") || !Utils.checkConnectPermissionForDataDelivery(
service, attributionSource, "AdapterService enable")) {
return false;
}
return service.enable(quietMode);
}
public synchronized boolean enable(boolean quietMode) {
mQuietmode = quietMode;
mAdapterStateMachine.sendMessage(AdapterState.BLE_TURN_ON);
return true;
}
可以看到 AdapterService enable() 最后调用了 AdapterState 状态机。
4)AdapterState 状态机迁移流程
源码位置:packages\apps\Bluetooth\src\com\android\bluetooth\btservice\AdapterState.java
蓝牙On时,状态机迁移流程: off -> TurningBleOn -> BleOn -> TurningOn -> On
蓝牙Off时,状态机迁移流程:On -> TurningOff -> BleOn -> TurningBleOff -> Off