Android - An Open Handset Alliance Project

org.bluez
public abstract class

org.bluez.BluetoothServiceNative

java.lang.Object
	android.os.Binder		IBinder
		org.bluez.BluetoothServiceNative	IBluetoothService

Summary

Constants

			Value
String	PUBLISH_NAME		"org.bluez.bluetooth_service"

Constants inherited from interface org.bluez.IBluetoothService

BLUETOOTH_DISABLED_ACTION, BLUETOOTH_ENABLED_ACTION, BONDING_CREATED_ACTION, BONDING_REMOVED_ACTION, DISCOVERY_COMPLETED_ACTION, DISCOVERY_STARTED_ACTION, HEADSET_CONNECTED_ACTION, HEADSET_DISCONNECTED_ACTION, LOCAL_DEVICE_MODE_CHANGED_ACTION, LOCAL_DEVICE_NAME_CHANGED_ACTION, PAIRING_CANCEL_ACTION, PAIRING_REQUEST_ACTION, REMOTE_ALIAS_CHANGED_ACTION, REMOTE_ALIAS_CLEARED_ACTION, REMOTE_CLASS_UPDATED_ACTION, REMOTE_DEVICE_CONNECTED_ACTION, REMOTE_DEVICE_DISAPPEARED_ACTION, REMOTE_DEVICE_DISCONNECTED_ACTION, REMOTE_DEVICE_DISCONNECT_REQUESTED_ACTION, REMOTE_DEVICE_FOUND_ACTION, REMOTE_NAME_FAILED_ACTION, REMOTE_NAME_UPDATED_ACTION, TRANSACT_CANCEL_PIN, TRANSACT_IS_BLUETOOTH_STARTED, TRANSACT_NOTIFY_HEADSET_CONNECTED, TRANSACT_NOTIFY_HEADSET_DISCONNECTED, TRANSACT_SET_PIN, TRANSACT_START_BLUETOOTH, TRANSACT_STOP_BLUETOOTH, descriptor

		Value
String	BLUETOOTH_DISABLED_ACTION	"org.bluez.intent.action.BLUETOOTH_DISABLED"
String	BLUETOOTH_ENABLED_ACTION	"org.bluez.intent.action.BLUETOOTH_ENABLED"
String	BONDING_CREATED_ACTION	"org.bluez.intent.action.BONDING_CREATED"
String	BONDING_REMOVED_ACTION	"org.bluez.intent.action.BONDING_REMOVED"
String	DISCOVERY_COMPLETED_ACTION	"org.bluez.intent.action.DISCOVERY_COMPLETED"
String	DISCOVERY_STARTED_ACTION	"org.bluez.intent.action.DISCOVERY_STARTED"
String	HEADSET_CONNECTED_ACTION	"org.bluez.intent.action.HEADSET_CONNECTED"
String	HEADSET_DISCONNECTED_ACTION	"org.bluez.intent.action.HEADSET_DISCONNECTED"
String	LOCAL_DEVICE_MODE_CHANGED_ACTION	"org.bluez.intent.action.LOCAL_DEVICE_MODE_CHANGED"
String	LOCAL_DEVICE_NAME_CHANGED_ACTION	"org.bluez.intent.action.LOCAL_DEVICE_NAME_CHANGED"
String	PAIRING_CANCEL_ACTION	"org.bluez.intent.action.PAIRING_CANCEL"
String	PAIRING_REQUEST_ACTION	"org.bluez.intent.action.PAIRING_REQUEST"
String	REMOTE_ALIAS_CHANGED_ACTION	"org.bluez.intent.action.REMOTE_ALIAS_CHANGED"
String	REMOTE_ALIAS_CLEARED_ACTION	"org.bluez.intent.action.REMOTE_ALIAS_CLEARED"
String	REMOTE_CLASS_UPDATED_ACTION	"org.bluez.intent.action.REMOTE_CLASS_UPDATED"
String	REMOTE_DEVICE_CONNECTED_ACTION	"org.bluez.intent.action.REMOTE_DEVICE_CONNECTED"
String	REMOTE_DEVICE_DISAPPEARED_ACTION	"org.bluez.intent.action.REMOTE_DEVICE_DISAPPEARED"
String	REMOTE_DEVICE_DISCONNECTED_ACTION	"org.bluez.intent.action.REMOTE_DEVICE_DISCONNECTED"
String	REMOTE_DEVICE_DISCONNECT_REQUESTED_ACTION	"org.bluez.intent.action.REMOTE_DEVICE_DISCONNECT_REQUESTED"
String	REMOTE_DEVICE_FOUND_ACTION	"org.bluez.intent.action.REMOTE_DEVICE_FOUND"
String	REMOTE_NAME_FAILED_ACTION	"org.bluez.intent.action.REMOTE_NAME_FAILED"
String	REMOTE_NAME_UPDATED_ACTION	"org.bluez.intent.action.REMOTE_NAME_UPDATED"
int	TRANSACT_CANCEL_PIN	5	0x00000005
int	TRANSACT_IS_BLUETOOTH_STARTED	3	0x00000003
int	TRANSACT_NOTIFY_HEADSET_CONNECTED	6	0x00000006
int	TRANSACT_NOTIFY_HEADSET_DISCONNECTED	7	0x00000007
int	TRANSACT_SET_PIN	4	0x00000004
int	TRANSACT_START_BLUETOOTH	1	0x00000001
int	TRANSACT_STOP_BLUETOOTH	2	0x00000002
String	descriptor	"org.bluez.IBluetooth"

Constants inherited from interface android.os.IBinder

DUMP_TRANSACTION, FIRST_CALL_TRANSACTION, LAST_CALL_TRANSACTION, PING_TRANSACTION

			Value
int	DUMP_TRANSACTION	IBinder protocol transaction code: dump internal state.	1598311760	0x5f444d50
int	FIRST_CALL_TRANSACTION	The first transaction code available for user commands.	1	0x00000001
int	LAST_CALL_TRANSACTION	The last transaction code available for user commands.	16777215	0x00ffffff
int	PING_TRANSACTION	IBinder protocol transaction code: pingBinder().	1599098439	0x5f504e47

Fields

protected EventLoop mEventLoop

Public Constructors

BluetoothServiceNative()

Public Methods

	void	Cancel(Adapter adapter, String address)
		This method is called during a bonding procedure with a remote device when the remote device cancels the PIN code entry (akin to the remote device doing the equivalent of cancelPin().
	void	Release()
		This method might be obsoleted soon.
	void	Request(Adapter adapter, String address, PasskeyResponse resp)
		This method is called during a bonding procedure with a remote device in order to request a PIN code entry from the user on the local device.
	IBinder	asBinder()
		Retrieve the Binder object associated with this interface.
static	IBluetoothService	asInterface(IBinder obj)
	void	cancelPin(String address)
static	IBluetoothService	getBluetoothService()
	Manager	getManager()
	SDPClient	getSDPClient(Adapter adapter, String address)
	boolean	isBluetoothStarted()
	void	notifyBondingCreated(String address)
		This method is called to notify the user of a successful bonding procedure.
	void	notifyBondingRemoved(String address)
		This method is called to notify the user when a bonding to a remote device is removed.
	void	notifyDiscoveryCompleted()
	void	notifyDiscoveryStarted()
	void	notifyHeadsetConnected(String address)
	void	notifyHeadsetDisconnected(String address)
	void	notifyModeChanged(String adapter, String mode)
		This method is called when the local adapter's mode changes (for example, when the adapter becomes discoverable when it was previously only connectable.) This may occur either in response to the user calling Adapter.setMode(), or in response to a timeout (for example, if the Adapter is set to discoverable mode for 1 minute, then it will revert to connectable mode automatically when a minute goes by, and this method will be called.).
	void	notifyNameChanged(String adapter, String name)
		This method is called when the local adapter's name changes, which is always in response to the user calling Adapter.setName().
	void	notifyRemoteAliasChanged(String address, String alias)
		This method is called when we change a remote device's alias.
	void	notifyRemoteAliasCleared(String address)
		This method is called when we remove a remote device's alias.
	void	notifyRemoteClassUpdated(String address, int nClass)
		This method is called when we learn of a new device's class (a 32-bit value encoding major, minor, and service classes of remove device.)
	void	notifyRemoteDeviceConnected(String address)
		This method is called when a remote device connects to this device.
	void	notifyRemoteDeviceDisappeared(String address)
	void	notifyRemoteDeviceDisconnectRequested(String address)
		This method is called when a remote device is about to disconnect from this device.
	void	notifyRemoteDeviceDisconnected(String address)
		This method is called when a remote device disconnects from this device.
	void	notifyRemoteDeviceFound(String address, int nClass, short nRSSI)
	void	notifyRemoteNameFailed(String address)
		This method is called during remote-device discovery, when we fail to retrieve a remote-device's user-friendly name.
	void	notifyRemoteNameUpdated(String address, String nClass)
		This method is called when we learn of a new device's user-friendly name.
	boolean	onTransact(int code, Parcel data, Parcel reply, int flags)
		Default implementation is a stub that returns false.
	void	setPin(String address, String pin)
	boolean	startBluetooth()
	boolean	stopBluetooth(boolean force)

Protected Methods

abstract void broadcastIntent(Intent intent)

Methods inherited from class android.os.Binder

attachInterface, clearCallingIdentity, dump, finalize, flushPendingCommands, getCallingPid, getCallingUid, getConstantData, getContextObject, getLastGcTime, joinThreadPool, linkToDeath, onTransact, pingBinder, queryLocalInterface, restoreCallingIdentity, transact, unlinkToDeath

		void	attachInterface(IInterface owner, String descriptor)
			Convenience method for associating a specific interface with the Binder.
final	static	long	clearCallingIdentity()
			Reset the identity of the incoming IPC to the local process.
		void	dump(FileDescriptor fd, PrintWriter fout)
			Print the object's state into the given stream.
		void	finalize()
			Called by the virtual machine when there are no longer any (non-weak) references to the receiver.
final	static	void	flushPendingCommands()
			Flush any Binder commands pending in the current thread to the kernel driver.
final	static	int	getCallingPid()
			Return the ID of the process that sent you the current transaction that is being processed.
final	static	int	getCallingUid()
			Return the ID of the user assigned to the process that sent you the current transaction that is being processed.
		int	getConstantData(Parcel outData)
			Default implementation has no constant data.
final	static	IBinder	getContextObject()
			Return the global "context object" of the system.
	static	long	getLastGcTime()
			Return the system time (as reported by {@link SystemClock#uptimeMillis SystemClock.uptimeMillis()) that the last garbage collection occurred in this process.
final	static	void	joinThreadPool()
			Add the calling thread to the IPC thread pool.
		void	linkToDeath(DeathRecipient recipient, int flags)
			Local implementation is a no-op.
		boolean	onTransact(int code, Parcel data, Parcel reply, int flags)
			Default implementation is a stub that returns false.
		boolean	pingBinder()
			Default implementation always returns true -- if you got here, the object is alive.
		IInterface	queryLocalInterface(String descriptor)
			Use information supplied to attachInterface() to return the associated IInterface if it matches the requested descriptor.
final	static	void	restoreCallingIdentity(long token)
			Restore the identity of the incoming IPC back to a previously identity that was returned by clearCallingIdentity().
final		boolean	transact(int code, Parcel data, Parcel reply, int flags)
			Default implementation rewinds the parcels and calls onTransact.
		boolean	unlinkToDeath(DeathRecipient recipient, int flags)
			Local implementation is a no-op.

Methods inherited from class java.lang.Object

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

	Object	clone()
		Answers a new instance of the same class as the receiver, whose slots have been filled in with the values in the slots of the receiver.
	boolean	equals(Object o)
		Compares the argument to the receiver, and answers true if they represent the same object using a class specific comparison.
	void	finalize()
		Called by the virtual machine when there are no longer any (non-weak) references to the receiver.
final	Class	getClass()
		Answers the unique instance of java.lang.Class which represents the class of the receiver.
	int	hashCode()
		Answers an integer hash code for the receiver.
final	void	notify()
		Causes one thread which is `wait` ing on the receiver to be made ready to run.
final	void	notifyAll()
		Causes all threads which are `wait` ing on the receiver to be made ready to run.
	String	toString()
		Answers a string containing a concise, human-readable description of the receiver.
final	void	wait(long time, int frac)
		Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by `notify` or `notifyAll`) or the expiration of the timeout.
final	void	wait(long time)
		Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by `notify` or `notifyAll`) or the expiration of the timeout.
final	void	wait()
		Causes the thread which sent this message to be made not ready to run pending some change in the receiver (as indicated by `notify` or `notifyAll`).

Details

Constants

public static final String PUBLISH_NAME

Constant Value: "org.bluez.bluetooth_service"

Fields

protected EventLoop mEventLoop

Public Constructors

public BluetoothServiceNative()

Public Methods

public void Cancel(Adapter adapter, String address)

This method is called during a bonding procedure with a remote device when the remote device cancels the PIN code entry (akin to the remote device doing the equivalent of cancelPin(). It is a signal to this device to not ask the user to enter a PIN.

Parameters

adapter	Local-device Bluetooth adapter from which the PIN request is made
address	Bluetooth address of remote device with which adapter is pairing

public void Release()

This method might be obsoleted soon. It is called to inform the user when a PasskeyAgent is released, but the definition of "released" is not clearly defined.

public void Request(Adapter adapter, String address, PasskeyResponse resp)

This method is called during a bonding procedure with a remote device in order to request a PIN code entry from the user on the local device. The returned PIN code is communicated through the PasskeyResponse interface, which is an opaque object as far as the user of PasskeyAgent is concerned. The PasskeyResponse object then takes care of sending the PIN code to the remote device.

Parameters

adapter	Local-device Bluetooth adapter from which the PIN request is made
address	Bluetooth address of remote device with which adapter is pairing
resp	Opaque interface through which the user returns the PIN code, or informs the other side that the PIN code entry is canceled.

public IBinder asBinder()

Retrieve the Binder object associated with this interface. You must use this instead of a plain cast, so that proxy objects can return the correct result.

public static IBluetoothService asInterface(IBinder obj)

public void cancelPin(String address)

public static IBluetoothService getBluetoothService()

public Manager getManager()

public SDPClient getSDPClient(Adapter adapter, String address)

public boolean isBluetoothStarted()

public void notifyBondingCreated(String address)

This method is called to notify the user of a successful bonding procedure. Note the similarity with method notifyAuthenticationSucceeded(String). The latter informs the user of a successful authentication, which occurs immediately prior to the completion of bonding.

Parameters

address	Bluetooth address of remote device.

public void notifyBondingRemoved(String address)

This method is called to notify the user when a bonding to a remote device is removed.

Parameters

address	Bluetooth address of remote device.

public void notifyDiscoveryCompleted()

public void notifyDiscoveryStarted()

public void notifyHeadsetConnected(String address)

public void notifyHeadsetDisconnected(String address)

public void notifyModeChanged(String adapter, String mode)

This method is called when the local adapter's mode changes (for example, when the adapter becomes discoverable when it was previously only connectable.) This may occur either in response to the user calling Adapter.setMode(), or in response to a timeout (for example, if the Adapter is set to discoverable mode for 1 minute, then it will revert to connectable mode automatically when a minute goes by, and this method will be called.).

Parameters

adapter	The String representation of the Adapter (e.g., "hci0")
mode	The new Adapter mode. It is one of "discoverable", "connectable", or "off".

public void notifyNameChanged(String adapter, String name)

This method is called when the local adapter's name changes, which is always in response to the user calling Adapter.setName().

Parameters

adapter	The String representation of the Adapter (e.g., "hci0")
name	The new Adapter name.

public void notifyRemoteAliasChanged(String address, String alias)

This method is called when we change a remote device's alias. This is a local operation, so it happens only in response to calling setRemoteAlias(String, String).

Parameters

address	Bluetooth address of remote device.
alias	remote-device alias.

public void notifyRemoteAliasCleared(String address)

This method is called when we remove a remote device's alias. This is a local operation, so it happens only in response to calling clearRemoteAlias(String).

Parameters

address	Bluetooth address of remote device.

public void notifyRemoteClassUpdated(String address, int nClass)

This method is called when we learn of a new device's class (a 32-bit value encoding major, minor, and service classes of remove device.)

Parameters

address	Bluetooth address of remote device.
nClass	remote-device class.

public void notifyRemoteDeviceConnected(String address)

This method is called when a remote device connects to this device. Note that this method does not tell us which adapter the connection arrived on, which is a limitation of the API, and will be fixed soon.

Parameters

address	Bluetooth address of remote device.

public void notifyRemoteDeviceDisappeared(String address)

public void notifyRemoteDeviceDisconnectRequested(String address)

This method is called when a remote device is about to disconnect from this device. The actual disconnect will happen about 2 seconds later; this notification is meant to give higher-level code the ability to react to the coming disconnect.

Parameters

address	Bluetooth address of remote device.

public void notifyRemoteDeviceDisconnected(String address)

This method is called when a remote device disconnects from this device. Note that this method does not tell us which adapter the connection arrived on, which is a limitation of the API, and will be fixed soon.

Parameters

address	Bluetooth address of remote device.

public void notifyRemoteDeviceFound(String address, int nClass, short nRSSI)

public void notifyRemoteNameFailed(String address)

This method is called during remote-device discovery, when we fail to retrieve a remote-device's user-friendly name.

Parameters

address	Bluetooth address of remote device.

public void notifyRemoteNameUpdated(String address, String nClass)

This method is called when we learn of a new device's user-friendly name.

Parameters

address	Bluetooth address of remote device.
nClass	remote-device name.

public boolean onTransact(int code, Parcel data, Parcel reply, int flags)

Default implementation is a stub that returns false. You will want to override this to do the appropriate unmarshalling of transactions. If you want to call this, call transact().

				int	getConstantData(Parcel outData)
					This method allows you to add data that is transported through IPC along with your IBinder pointer.
				void	linkToDeath(DeathRecipient recipient, int flags)
					Register the recipient for a notification if this binder goes away.
				boolean	pingBinder()
					Check to see if the object still exists.
				IInterface	queryLocalInterface(String descriptor)
					Attempt to retrieve a local implementation of an interface for this Binder object.
				boolean	transact(int code, Parcel data, Parcel reply, int flags)
					Perform a generic operation with the object.
				boolean	unlinkToDeath(DeathRecipient recipient, int flags)
					Remove a previously registered death notification.


e.g. "intent" or "activity"

Android - An Open Handset Alliance Project

Documentation

Goodies

org.bluez.BluetoothServiceNative

Summary

Constants

Constants inherited from interface org.bluez.IBluetoothService

Constants inherited from interface android.os.IBinder

Fields

Public Constructors

Public Methods

Protected Methods

Methods inherited from class android.os.Binder

Methods inherited from class java.lang.Object

Methods inherited from interface org.bluez.IBluetoothService

Methods inherited from interface android.os.IBinder

Methods inherited from interface android.os.IInterface

Details

Constants

public static final String PUBLISH_NAME

Fields

protected EventLoop mEventLoop

Public Constructors

public BluetoothServiceNative()

Public Methods

public void Cancel(Adapter adapter, String address)

Parameters

public void Release()

public void Request(Adapter adapter, String address, PasskeyResponse resp)

Parameters

See Also

public IBinder asBinder()

public static IBluetoothService asInterface(IBinder obj)

public void cancelPin(String address)

public static IBluetoothService getBluetoothService()

public Manager getManager()

public SDPClient getSDPClient(Adapter adapter, String address)

public boolean isBluetoothStarted()

public void notifyBondingCreated(String address)

Parameters

public void notifyBondingRemoved(String address)

Parameters

public void notifyDiscoveryCompleted()

public void notifyDiscoveryStarted()

public void notifyHeadsetConnected(String address)

public void notifyHeadsetDisconnected(String address)

public void notifyModeChanged(String adapter, String mode)

Parameters

public void notifyNameChanged(String adapter, String name)

Parameters

public void notifyRemoteAliasChanged(String address, String alias)

Parameters

public void notifyRemoteAliasCleared(String address)

Parameters

public void notifyRemoteClassUpdated(String address, int nClass)

Parameters

public void notifyRemoteDeviceConnected(String address)

Parameters

public void notifyRemoteDeviceDisappeared(String address)

public void notifyRemoteDeviceDisconnectRequested(String address)

Parameters

public void notifyRemoteDeviceDisconnected(String address)

Parameters

public void notifyRemoteDeviceFound(String address, int nClass, short nRSSI)

public void notifyRemoteNameFailed(String address)

Parameters

public void notifyRemoteNameUpdated(String address, String nClass)

Parameters

public boolean onTransact(int code, Parcel data, Parcel reply, int flags)

public void setPin(String address, String pin)

public boolean startBluetooth()

public boolean stopBluetooth(boolean force)

Protected Methods

protected abstract void broadcastIntent(Intent intent)