HFP (Hands-free Profile),让蓝牙设备(如蓝牙耳机)可以控制电话,如接听、挂断、拒接、语音拨号等,拒接、语音拨号要看蓝牙耳机及电话是否支持。
HFP定义了音频网关(AG)和免提组件(HF)两个角色:
音频网关(AG) – 该设备为音频(特别是手机)的输入/输出网关。
免提组件(HF) – 该设备作为音频网关的远程音频输入/输出机制,并可提供若干遥控功能。
| 2 手机音频连接 |
对于手机音频的使用,首先连接的蓝牙设备需要支持hfp协议,并且需要与该设备进行配对,如何进行蓝牙配对这里就不细说了,可以参照我的其他文章。主要分析下其连接过程。
对于系统自带应用Settings中已配对的蓝牙设备界面(如下图所示),
其对应文件路径:
packages/apps/Settings/src/com/android/settings/bluetooth/DeviceProfilesSettings.java
点击手机音频进行连接,调用onPreferenceChange。
-
public boolean onPreferenceChange(Preference preference, Object newValue) { -
if (preference == mDeviceNamePref) { //重命名 -
mCachedDevice.setName((String) newValue); -
} else if (preference instanceof CheckBoxPreference) {//check box -
LocalBluetoothProfile prof = getProfileOf(preference); //获取对应的profile -
onProfileClicked(prof, (CheckBoxPreference) preference); -
return false; // checkbox will update from onDeviceAttributesChanged() callback -
} else { -
return false; -
} -
return true; -
}
接着看onProfileClicked()函数处理
-
private void onProfileClicked(LocalBluetoothProfile profile, CheckBoxPreference profilePref) { -
BluetoothDevice device = mCachedDevice.getDevice(); //获取配对的蓝牙设备 -
int status = profile.getConnectionStatus(device); //获取profile的连接状态 -
boolean isConnected = -
status == BluetoothProfile.STATE_CONNECTED; -
if (isConnected) { //如果是连接状态则断开连接 -
askDisconnect(getActivity(), profile); -
} else { //没有连接 -
if (profile.isPreferred(device)) { //获取profile是否是首选 -
// profile is preferred but not connected: disable auto-connect -
profile.setPreferred(device, false); //设置对应profile的PRIORITY 为off,防止自动连接 -
refreshProfilePreference(profilePref, profile); //刷新check box状态 -
} else { -
profile.setPreferred(device, true); //设置对应profile的PRIORITY 为on -
mCachedDevice.connectProfile(profile); //连接指定profile -
} -
} -
}
接着查看CachedBluetoothDevice中的connectProfile函数连接某一profile。
-
void connectProfile(LocalBluetoothProfile profile) { -
mConnectAttempted = SystemClock.elapsedRealtime(); -
// Reset the only-show-one-error-dialog tracking variable -
mIsConnectingErrorPossible = true; -
connectInt(profile); //连接profile -
refresh(); // 刷新ui -
} -
synchronized void connectInt(LocalBluetoothProfile profile) { -
//查看是否配对,如果没有配对则进行配对,配对后进行连接, -
//如果配对则直接连接 -
if (!ensurePaired()) { -
return; -
} -
if (profile.connect(mDevice)) {//连接 -
return; -
} -
}
connectProfile() ——>connectInt()
connectInt()函数中会先判断是否配对,如果没有配对则开始配对,配对成功后连接profile。
如果已经配对则直接连接profile。
对于profile.connect(mDevice)会根据profile调用各自对应的connect方法。(如手机音频则对应HeadsetProfile,媒体音频对应A2dpProfile)。这里查看手机音频的连接HeadsetProfile。
-
public boolean connect(BluetoothDevice device) { -
if (mService == null) return false; -
//获取连接hfp的设备 -
List<BluetoothDevice> sinks = mService.getConnectedDevices(); -
if (sinks != null) { -
for (BluetoothDevice sink : sinks) { -
mService.disconnect(sink); //断开连接 -
} -
} //连接hfp。 -
return mService.connect(device); -
}
HeadsetProfile.java中的connect()方法,mService是通过getProfileProxy获取的BluetoothHeadset代理对象,通过其进行hfp相关操作。
mService.connect跳到Bluetooth应用中,
代码路径:packages/apps/Bluetooth/src/com/android/bluetooth/hfp/HeadsetService.java
先调用到内部类BluetoothHeadsetBinder的connect方法。
-
public boolean connect(BluetoothDevice device) { -
HeadsetService service = getService(); -
if (service == null) return false; -
return service.connect(device); -
}
该方法中很明显是去调用HeadsetService的connect方法。
-
public boolean connect(BluetoothDevice device) { -
enforceCallingOrSelfPermission(BLUETOOTH_ADMIN_PERM, -
"Need BLUETOOTH ADMIN permission"); -
if (getPriority(device) == BluetoothProfile.PRIORITY_OFF) { -
return false; //检查priority -
} -
int connectionState = mStateMachine.getConnectionState(device); -
if (connectionState == BluetoothProfile.STATE_CONNECTED || -
connectionState == BluetoothProfile.STATE_CONNECTING) { -
return false; //检查连接状态 -
} -
mStateMachine.sendMessage(HeadsetStateMachine.CONNECT, device); -
return true; -
}
HeadsetService的connect()函数会对priority和连接状态进行必要的检查,不符合条件则返回false。符合条件则向状态机发送消息HeadsetStateMachine.CONNECT。
此时HeadsetStateMachine中状态应该是Disconnected,所以查看Disconnected state中的处理
-
BluetoothDevice device = (BluetoothDevice) message.obj; -
//发送广播,正在连接hfp -
broadcastConnectionState(device, BluetoothProfile.STATE_CONNECTING, -
BluetoothProfile.STATE_DISCONNECTED); -
//连接远端设备。 -
if (!connectHfpNative(getByteAddress(device)) ) { -
//连接失败,向外发送连接失败广播 -
broadcastConnectionState(device, BluetoothProfile.STATE_DISCONNECTED, -
BluetoothProfile.STATE_CONNECTING); -
break; -
} -
synchronized (HeadsetStateMachine.this) { -
mTargetDevice = device; -
transitionTo(mPending); //切换到pending状态 -
} -
sendMessageDelayed(CONNECT_TIMEOUT, 30000);
HeadsetStateMachine调用connectHfpNative()函数来进行手机音频的连接。connectHfpNative是native方法,跳转到com_android_bluetooth_hfp.cpp中,调用对应的方法connectHfpNative
-
static jboolean connectHfpNative(JNIEnv *env, jobject object, jbyteArray address) { -
jbyte *addr; -
bt_status_t status; -
if (!sBluetoothHfpInterface) return JNI_FALSE; -
addr = env->GetByteArrayElements(address, NULL); -
if (!addr) { -
jniThrowIOException(env, EINVAL); -
return JNI_FALSE; -
} -
if ((status = sBluetoothHfpInterface->connect((bt_bdaddr_t *)addr)) != BT_STATUS_SUCCESS) { -
ALOGE("Failed HF connection, status: %d", status); -
} -
env->ReleaseByteArrayElements(address, addr, 0); -
return (status == BT_STATUS_SUCCESS) ? JNI_TRUE : JNI_FALSE; -
}
其中sBluetoothHfpInterface->connect会跳到蓝牙协议栈进行连接,协议栈就先不进行分析了。
| 3 连接状态 |
当协议栈连接状态改变会回调com_android_bluetooth_hfp.cpp中的方法connection_state_callback()。
-
static void connection_state_callback(bthf_connection_state_t state, bt_bdaddr_t* bd_addr) { -
jbyteArray addr; -
CHECK_CALLBACK_ENV -
addr = sCallbackEnv->NewByteArray(sizeof(bt_bdaddr_t)); -
if (!addr) { -
checkAndClearExceptionFromCallback(sCallbackEnv, __FUNCTION__); -
return; -
} -
sCallbackEnv->SetByteArrayRegion(addr, 0, sizeof(bt_bdaddr_t), (jbyte*) bd_addr); -
sCallbackEnv->CallVoidMethod(mCallbacksObj, method_onConnectionStateChanged, -
(jint) state, addr); -
checkAndClearExceptionFromCallback(sCallbackEnv, __FUNCTION__); -
sCallbackEnv->DeleteLocalRef(addr); -
}
在connection_state_callback方法中会从cpp层调用到java层,对应于HeadsetStateMachine中的onConnectionStateChanged函数
-
private void onConnectionStateChanged(int state, byte[] address) { -
StackEvent event = new StackEvent(EVENT_TYPE_CONNECTION_STATE_CHANGED); -
event.valueInt = state; -
event.device = getDevice(address); -
sendMessage(STACK_EVENT, event); -
}
onConnectionStateChanged函数中发送消息STACK_EVENT(携带状态和蓝牙地址),此时是Pending state,收到该消息调用processConnectionEvent。
正常连接成功应该会先收到HeadsetHalConstants.CONNECTION_STATE_CONNECTING状态,然后收到HeadsetHalConstants.CONNECTION_STATE_CONNECTED状态。
-
//发送广播,连接成功 -
broadcastConnectionState(mTargetDevice, BluetoothProfile.STATE_CONNECTED, -
BluetoothProfile.STATE_CONNECTING); -
synchronized (HeadsetStateMachine.this) { -
mCurrentDevice = mTargetDevice; //mCurrentDevice表示已连接的设备 -
mTargetDevice = null; //mTargetDevice表示要连接的设备 -
transitionTo(mConnected); //切换到Connected状态 -
}
收到HeadsetHalConstants.CONNECTION_STATE_CONNECTED状态,后向外发送连接成功的广播,状态机切换到Connected状态
-
private void broadcastConnectionState(BluetoothDevice device, int newState, int prevState) { -
/* Notifying the connection state change of the profile before sending the intent for -
connection state change, as it was causing a race condition, with the UI not being -
updated with the correct connection state. */ -
mService.notifyProfileConnectionStateChanged(device, BluetoothProfile.HEADSET,newState, prevState); -
Intent intent = new Intent(BluetoothHeadset.ACTION_CONNECTION_STATE_CHANGED); -
intent.putExtra(BluetoothProfile.EXTRA_PREVIOUS_STATE, prevState); -
intent.putExtra(BluetoothProfile.EXTRA_STATE, newState); -
intent.putExtra(BluetoothDevice.EXTRA_DEVICE, device); -
mService.sendBroadcast(intent, HeadsetService.BLUETOOTH_PERM); -
}
在mService.notifyProfileConnectionStateChanged中会将手机音频的proirty设置为auto_connect,并且向外发送BluetoothAdapter.ACTION_CONNECTION_STATE_CHANGED广播。
在其他应用中可以通过广播接收者注册BluetoothHeadset.ACTION_CONNECTION_STATE_CHANGED该广播,用来监听hfp的连接状态。
| 4 更新ui |
当手机音频连接成功后,Settings应用中会更新ui界面。
LocalBluetoothProfileManager中会对所有的profile进行管理,其将hfp的profile添加到BluetoothEventManager中,BluetoothEventManager会注册蓝牙状态改变、各profile状态改变等广播。
当BluetoothEventManager收到BluetoothHeadset.ACTION_CONNECTION_STATE_CHANGED广播后,会根据action获取对应的handler,调用对应handler的onReceive方法。
接收到该广播跳到LocalBluetoothProfileManager内部类StateChangedHandler.onReceive->CachedBluetoothDevice.onProfileStateChanged ->refresh ->dispatchAttributesChanged
接着跳到DeviceProfilesSettings中的onDeviceAttributesChanged ->refresh.这里会对界面进行更新,显示其连接状态信息。
hfp连接过程已经分析完了,而断开连接到过程和连接整体相差不多,就不再细说了。
来源:oschina
链接:https://my.oschina.net/u/920274/blog/2998995