Methods

acceptConnections

chrome.experimental.bluetooth.acceptConnections(string uuid, stringservice_name, string service_description, function callback)

Accept incoming bluetooth connections by advertising as a service.

Parameters

uuid ( string )

The UUID of the service being advertised.

service_name ( string )

The human-readable name of the service being advertised.

service_description ( string )

The human-readable description of the service being advertised.

callback ( function )

Called once for each connection that is established.

Callback function

The callback parameter should specify a function that looks like this:

function(BluetoothSocket result) {...};

result ( BluetoothSocket )

A bluetooth socket identifier that can be used to communicate with the connected device.

connect

chrome.experimental.bluetooth.connect(BluetoothDevice device, string uuid, function callback)

Connect to a service on a bluetooth device.

Parameters

device ( BluetoothDevice )

The target device of the connection.

uuid ( string )

The target service of the connection.

callback ( function )

Called when the connection is established.

Callback function

The callback parameter should specify a function that looks like this:

function(BluetoothSocket result) {...};

result ( BluetoothSocket )

A bluetooth socket identifier that can be used to communicate with the connected device.

disconnect

chrome.experimental.bluetooth.disconnect(BluetoothSocket socket, function callback)

Close the bluetooth connection specified by socket.

Parameters

socket ( BluetoothSocket )

The bluetooth socket to read from.

callback ( optional function )

Called with a boolean value to indicate success.

Callback function

If you specify the callback parameter, it should specify a function that looks like this:

function(boolean result) {...};

result ( boolean )

True if successful, false otherwise.

getBluetoothAddress

chrome.experimental.bluetooth.getBluetoothAddress(function callback)

Get the bluetooth address of the system.

Parameters

callback ( function )

Called with the result.

Callback function

The callback parameter should specify a function that looks like this:

function(string result) {...};

result ( string )

The bluetooth address of the system.

getDevicesWithService

chrome.experimental.bluetooth.getDevicesWithService(string service_uuid, function callback)

Request a list of bluetooth devices that support service.

Parameters

service_uuid ( string )

The UUID of the desired service.

callback ( function )

Called with a list of bluetooth devices.

Callback function

The callback parameter should specify a function that looks like this:

function(array of BluetoothDevice results) {...};

results ( array of BluetoothDevice )

An array of BluetoothDevice objects, all of which provide the specified service.

getOutOfBandPairingData

chrome.experimental.bluetooth.getOutOfBandPairingData(function callback)

Get the local Out of Band Pairing data.

Parameters

callback ( function )

Called with the Out of Band Pairing data.

Callback function

The callback parameter should specify a function that looks like this:

function(array of ArrayBuffer result) {...};

result ( array of ArrayBuffer )

The local Out of Band Pairing data. The array will have length exactly 2 (or be null, in case of an error).

isBluetoothCapable

chrome.experimental.bluetooth.isBluetoothCapable(function callback)

Check if this extension has access to bluetooth.

Parameters

callback ( function )

Called with the result.

Callback function

The callback parameter should specify a function that looks like this:

function(boolean result) {...};

result ( boolean )

True if the extension has access to bluetooth, false otherwise.

isBluetoothPowered

chrome.experimental.bluetooth.isBluetoothPowered(function callback)

Check if the bluetooth adapter has power.

Parameters

callback ( function )

Called with the result.

Callback function

The callback parameter should specify a function that looks like this:

function(boolean result) {...};

result ( boolean )

True if the bluetooth adapter has power, false otherwise.

read

chrome.experimental.bluetooth.read(BluetoothSocket socket, function callback)

Read data from a bluetooth connection.

Parameters

socket ( BluetoothSocket )

The bluetooth socket to read from.

callback ( function )

Called when data is available.

Callback function

The callback parameter should specify a function that looks like this:

function(ArrayBuffer result) {...};

result ( ArrayBuffer )

An ArrayBuffer of data.

setOutOfBandPairingData

chrome.experimental.bluetooth.setOutOfBandPairingData(string bluetooth_address, array of ArrayBuffer data,function callback)

Set the Out of Band Pairing data for the bluetooth device at bluetooth_address.

Parameters

bluetooth_address ( string )

The bluetooth address that is supplying the data.

data ( array of ArrayBuffer )

An array of length exactly equal to 2 containing the Out of Band Pairing data for the device at bluetooth_address.

callback ( optional function )

Called with a boolean value to indicate success.

Callback function

If you specify the callback parameter, it should specify a function that looks like this:

function(boolean result) {...};

result ( boolean )

True if successful, false otherwise.

write

chrome.experimental.bluetooth.write(BluetoothSocket socket, ArrayBuffer data, function callback)

Write data to a bluetooth connection.

Parameters

socket ( BluetoothSocket )

The bluetooth socket to read from.

data ( ArrayBuffer )

The data to be written.

callback ( function )

Called with a boolean value to indicate success.

Callback function

The callback parameter should specify a function that looks like this:

function(boolean result) {...};

result ( boolean )

True if successful, false otherwise.

Events

onBluetoothAvailabilityChange

chrome.experimental.bluetooth.onBluetoothAvailabilityChange.addListener(function(boolean available) {...});

Fired when the availability of bluetooth on the system changes.

Listener parameters

available ( boolean )

True if bluetooth is available, false otherwise.

onBluetoothPoweredChange

chrome.experimental.bluetooth.onBluetoothPoweredChange.addListener(function(boolean powered) {...});

Fired when the powered state of bluetooth on the system changes.

Listener parameters

powered ( boolean )

True if bluetooth is powered on, false otherwise.

Types