threads.webrtc

Class RTCBluetoothManager

java.lang.Object

threads.webrtc.RTCBluetoothManager

public class RTCBluetoothManager
extends java.lang.Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	RTCBluetoothManager.State

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	RTCBluetoothManager(android.content.Context context, RTCAudioManager audioManager)

Method Summary

Modifier and Type	Method and Description
protected android.media.AudioManager	getAudioManager(android.content.Context context) Stubs for test mocks.
protected boolean	getBluetoothProfileProxy(android.content.Context context, android.bluetooth.BluetoothProfile.ServiceListener listener, int profile)
RTCBluetoothManager.State	getState() Returns the internal state.
protected boolean	hasPermission(android.content.Context context, java.lang.String permission)
protected void	logBluetoothAdapterInfo(android.bluetooth.BluetoothAdapter localAdapter) Logs the state of the local Bluetooth adapter.
protected void	registerReceiver(android.content.BroadcastReceiver receiver, android.content.IntentFilter filter)
void	start() Activates components required to detect Bluetooth devices and to enable BT SCO (audio is routed via BT SCO) for the headset profile.
boolean	startScoAudio() Starts Bluetooth SCO connection with remote device.
void	stop() Stops and closes all components related to Bluetooth audio.
void	stopScoAudio() Stops Bluetooth SCO connection with remote device.
protected void	unregisterReceiver(android.content.BroadcastReceiver receiver)
void	updateDevice() Use the BluetoothHeadset proxy object (controls the Bluetooth Headset Service via IPC) to update the list of connected devices for the HEADSET profile.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

RTCBluetoothManager

protected RTCBluetoothManager(android.content.Context context,
                              RTCAudioManager audioManager)

Method Detail

getState

public RTCBluetoothManager.State getState()

Returns the internal state.

start

public void start()

Activates components required to detect Bluetooth devices and to enable BT SCO (audio is routed via BT SCO) for the headset profile. The end state will be HEADSET_UNAVAILABLE but a state machine has started which will start a state change sequence where the final outcome depends on if/when the BT headset is enabled. Example of state change sequence when start() is called while BT device is connected and enabled: UNINITIALIZED -- HEADSET_UNAVAILABLE -- HEADSET_AVAILABLE -- SCO_CONNECTING -- SCO_CONNECTED audio is now routed via BT SCO. Note that the RTCAudioManager is also involved in driving this state change.

stop

public void stop()

Stops and closes all components related to Bluetooth audio.

startScoAudio

public boolean startScoAudio()

Starts Bluetooth SCO connection with remote device. Note that the phone application always has the priority on the usage of the SCO connection for telephony. If this method is called while the phone is in call it will be ignored. Similarly, if a call is received or sent while an application is using the SCO connection, the connection will be lost for the application and NOT returned automatically when the call ends. Also note that: up to and including API version JELLY_BEAN_MR1, this method initiates a virtual voice call to the Bluetooth headset. After API version JELLY_BEAN_MR2 only a raw SCO audio connection is established. TODO(henrika): should we add support for virtual voice call to BT headset also for JBMR2 and higher. It might be required to initiates a virtual voice call since many devices do not accept SCO audio without a "call".

stopScoAudio

public void stopScoAudio()

Stops Bluetooth SCO connection with remote device.

updateDevice

public void updateDevice()

Use the BluetoothHeadset proxy object (controls the Bluetooth Headset Service via IPC) to update the list of connected devices for the HEADSET profile. The internal state will change to HEADSET_UNAVAILABLE or to HEADSET_AVAILABLE and |bluetoothDevice| will be mapped to the connected device if available.

getAudioManager

protected android.media.AudioManager getAudioManager(android.content.Context context)

Stubs for test mocks.

registerReceiver

protected void registerReceiver(android.content.BroadcastReceiver receiver,
                                android.content.IntentFilter filter)

unregisterReceiver

protected void unregisterReceiver(android.content.BroadcastReceiver receiver)

getBluetoothProfileProxy

protected boolean getBluetoothProfileProxy(android.content.Context context,
                                           android.bluetooth.BluetoothProfile.ServiceListener listener,
                                           int profile)

hasPermission

protected boolean hasPermission(android.content.Context context,
                                java.lang.String permission)

logBluetoothAdapterInfo

protected void logBluetoothAdapterInfo(android.bluetooth.BluetoothAdapter localAdapter)

Logs the state of the local Bluetooth adapter.