Bluetooth API
The following Bluetooth functionalities are provided:
- Controls local Bluetooth device, that is, turn Bluetooth on/off, etc.
- Sets visibility
- Discovers nearby Bluetooth devices (Device discovery, including Bluetooth LE devices)
- Gets bonded devices information
- Controls bonding
- Connects to a service on a remote device and exchanges data
- Registers a service (RFCOMM) on a local device, which can be consumed by remote devices to exchange data
- Advertise for remote devices (including Bluetooth LE devices)
- Act as a GATT client (Generic Attribute Profile client)
For more information on the Bluetooth features, see Bluetooth Guide.
Since: 1.0
Table of Contents
- 1. Type Definitions
- 1.1. BluetoothAddress
- 1.2. BluetoothUUID
- 1.3. BluetoothSocketState
- 1.4. BluetoothProfileType
- 1.5. BluetoothHealthChannelType
- 1.6. BluetoothLESolicitationUUID
- 1.7. BluetoothAdvertisePacketType
- 1.8. BluetoothAdvertisingState
- 1.9. BluetoothAdvertisingMode
- 2. Interfaces
- 2.1. BluetoothManagerObject
- 2.2. BluetoothLEServiceData
- 2.3. BluetoothLEManufacturerData
- 2.4. BluetoothLEAdvertiseDataInit
- 2.5. BluetoothLEAdvertiseData
- 2.6. BluetoothManager
- 2.7. BluetoothAdapter
- 2.8. BluetoothLEAdapter
- 2.9. BluetoothGATTService
- 2.10. BluetoothGATTCharacteristic
- 2.11. BluetoothGATTDescriptor
- 2.12. BluetoothLEScanCallback
- 2.13. BluetoothLEAdvertiseCallback
- 2.14. BluetoothLEConnectChangeCallback
- 2.15. ReadValueSuccessCallback
- 2.16. BluetoothDevice
- 2.17. BluetoothLEDevice
- 2.18. BluetoothSocket
- 2.19. BluetoothClass
- 2.20. BluetoothClassDeviceMajor
- 2.21. BluetoothClassDeviceMinor
- 2.22. BluetoothClassDeviceService
- 2.23. BluetoothServiceHandler
- 2.24. BluetoothProfileHandler
- 2.25. BluetoothHealthProfileHandler
- 2.26. BluetoothHealthApplication
- 2.27. BluetoothHealthChannel
- 2.28. BluetoothAdapterChangeCallback
- 2.29. BluetoothDeviceSuccessCallback
- 2.30. BluetoothDeviceArraySuccessCallback
- 2.31. BluetoothDiscoverDevicesSuccessCallback
- 2.32. BluetoothSocketSuccessCallback
- 2.33. BluetoothServiceSuccessCallback
- 2.34. BluetoothHealthApplicationSuccessCallback
- 2.35. BluetoothHealthChannelSuccessCallback
- 2.36. BluetoothHealthChannelChangeCallback
- 3. Related Feature
- 4. Full WebIDL
Summary of Interfaces and Methods
1. Type Definitions
1.1. BluetoothAddress
typedef DOMString BluetoothAddress;
Since: 1.0
1.3. BluetoothSocketState
enum BluetoothSocketState { "CLOSED", "OPEN" };
Since: 1.0
- CLOSED - corresponds to closed bluetooth socket.
- OPEN - corresponds to opened bluetooth socket.
1.4. BluetoothProfileType
enum BluetoothProfileType { "HEALTH" };
Since: 2.2
- HEALTH - corresponds to health bluetooth profile type.
1.5. BluetoothHealthChannelType
enum BluetoothHealthChannelType { "RELIABLE", "STREAMING" };
Since: 2.2
- RELIABLE - corresponds to reliable bluetooth health channel type.
- STREAMING - corresponds to streaming bluetooth health channel type.
1.6. BluetoothLESolicitationUUID
typedef DOMString BluetoothLESolicitationUUID;
Since: 2.3.1
1.7. BluetoothAdvertisePacketType
enum BluetoothAdvertisePacketType { "ADVERTISE", "SCAN_RESPONSE" };
Since: 2.3.1
- ADVERTISE - the advertising packet
- SCAN_RESPONSE- the scan response packet
2. Interfaces
2.1. BluetoothManagerObject
[NoInterfaceObject] interface BluetoothManagerObject { readonly attribute BluetoothManager bluetooth; };
Tizen implements BluetoothManagerObject;
Since: 1.0
The tizen.bluetooth object allows access to the Bluetooth API.
Attributes
-
readonly
BluetoothManager bluetoothObject representing a bluetooth manager.
Since: 1.0
2.2. BluetoothLEServiceData
[Constructor(DOMString uuid, DOMString data)] interface BluetoothLEServiceData { attribute BluetoothUUID uuid; attribute DOMString data; };
Since: 2.3.1
Constructors
Attributes
-
BluetoothUUID uuidThe 16-bit UUID of service data.
Since: 2.3.1
Code example:
/* Creates a serviceData. */ var service = new tizen.BluetoothLEServiceData("11e5", "0x1811"); service.uuid = "f23641a4";
-
DOMString dataThe service data of the Bluetooth LE device.
Since: 2.3.1
Code example:
/* Creates a serviceData. */ var service = new tizen.BluetoothLEServiceData("11e5", "0x1811"); service.data = "0x1815";
2.3. BluetoothLEManufacturerData
[Constructor(DOMString id, DOMString data)] interface BluetoothLEManufacturerData { attribute DOMString id; attribute DOMString data; };
Since: 2.3.1
Constructors
Attributes
-
DOMString idThe manufacturer assigned ID
Since: 2.3.1
Code example:
/* Creates a manufacturerData. */ var manufacturer = new tizen.BluetoothLEManufacturerData("127", "0x0057"); manufacturer.id = "129";
-
DOMString dataThe manufacturer data content
The string should consist of hexadecimal characters only (A-F, a-f, 0-9). If the string's length is odd, the last character will be omitted. The string may start without or with one of below prefixes:
- "0x",
- "0X".
See also, usage of BluetoothLEManufacturerData.
Since: 2.3.1
Code example:
/* Creates a manufacturerData. */ var manufacturer = new tizen.BluetoothLEManufacturerData("127", "0x0057"); manufacturer.data = "0x0059";
2.4. BluetoothLEAdvertiseDataInit
dictionary BluetoothLEAdvertiseDataInit { boolean? includeName; BluetoothUUID[]? uuids; BluetoothLESolicitationUUID[]? solicitationuuids; unsigned long? appearance; boolean? includeTxPowerLevel; BluetoothLEServiceData? serviceData; BluetoothLEManufacturerData? manufacturerData; };
Since: 2.3.1
This dictionary is used as an input parameter of the BluetoothLEAdvertiseData constructor.
Code example:
var advertData = { includeName: false, uuids: ["41a4"], solicitationuuids: ["58574d3f"], appearance: 192, includeTxPowerLevel: false };
2.5. BluetoothLEAdvertiseData
[Constructor(optional BluetoothLEAdvertiseDataInit? init)] interface BluetoothLEAdvertiseData { attribute boolean? includeName; attribute BluetoothUUID[]? uuids; attribute BluetoothLESolicitationUUID[]? solicitationuuids; attribute unsigned long? appearance; attribute boolean? includeTxPowerLevel; attribute BluetoothLEServiceData? serviceData; attribute BluetoothLEManufacturerData? manufacturerData; };
Since: 2.3.1
The BluetoothLEAdvertiseData container for Bluetooth LE advertising. This represents the data to be advertised as well as the scan response data for active scans.
Code example:
var advertData = { includeName: false, uuids: ["41a4"], solicitationuuids: ["58574d3f"], appearance: 192, includeTxPowerLevel: false }; var advertise = new tizen.BluetoothLEAdvertiseData(advertData);
Constructors
-
Constructor (BluetoothLEAdvertiseDataInit?)
BluetoothLEAdvertiseData(optional BluetoothLEAdvertiseDataInit? init);
Attributes
-
boolean includeName [nullable]The flag indicating whether the device name should be included in advertise or scan response data. If attribute is set to null, The default value is set to a false.
Since: 2.3.1
Code example:
var advertise = new tizen.BluetoothLEAdvertiseData(); advertise.includeName = true;
-
BluetoothUUID[]
uuids [nullable]The service UUIDs for advertise or scan response data.
Since: 2.3.1
Code example:
var advertise = new tizen.BluetoothLEAdvertiseData(); advertise.uuids = ["180d", "7cae86d2-a021-11ea-bb37-0242ac130002"];
-
BluetoothLESolicitationUUID[]
solicitationuuids [nullable]The service solicitation UUIDs for advertise or scan response data.
Since: 2.3.1
Code example:
var advertise = new tizen.BluetoothLEAdvertiseData(); advertise.solicitationuuids = ["180f", "7cae86d2-a021-11ea-bb37-0242ac130002"];
-
unsigned long appearance [nullable]The external appearance of this device for advertise or scan response data.
See the list of appearance codes for sample values.
Since: 2.3.1
Code example:
var advertise = new tizen.BluetoothLEAdvertiseData(); advertise.appearance = 192;
-
boolean includeTxPowerLevel [nullable]The transmission power level should be included in advertise or scan response data. If attribute is set to null, The default value is set to a false.
Since: 2.3.1
Code example:
var advertise = new tizen.BluetoothLEAdvertiseData(); advertise.includeTxPowerLevel = true;
-
BluetoothLEServiceData serviceData [nullable]The service data for advertise or scan response data.
Since: 2.3.1
Code example:
var advertise = new tizen.BluetoothLEAdvertiseData(); var service = new tizen.BluetoothLEServiceData("11e5", "0x1811"); advertise.serviceData = service;
-
BluetoothLEManufacturerData manufacturerData [nullable]The manufacturer specific data for advertise or scan response data.
Since: 2.3.1
Code example:
var advertise = new tizen.BluetoothLEAdvertiseData(); var manufacturer = new tizen.BluetoothLEManufacturerData("127", "0x0057"); advertise.manufacturerData = manufacturer;
2.6. BluetoothManager
[NoInterfaceObject] interface BluetoothManager { readonly attribute BluetoothClassDeviceMajor deviceMajor; readonly attribute BluetoothClassDeviceMinor deviceMinor; readonly attribute BluetoothClassDeviceService deviceService; BluetoothAdapter getDefaultAdapter() raises(WebAPIException); BluetoothLEAdapter getLEAdapter() raises(WebAPIException); };
Since: 1.0
Attributes
-
readonly
BluetoothClassDeviceMajor deviceMajorThe major device class identifier of Bluetooth class of device (CoD).
Since: 1.0
Code example:
console.log(tizen.bluetooth.deviceMajor);
-
readonly
BluetoothClassDeviceMinor deviceMinorThe minor device class identifier of Bluetooth class of device (CoD).
Since: 1.0
Code example:
console.log(tizen.bluetooth.deviceMinor);
-
readonly
BluetoothClassDeviceService deviceServiceThe major service class identifier of Bluetooth class of device (CoD).
Since: 1.0
Code example:
console.log(tizen.bluetooth.deviceService);
Methods
-
getDefaultAdapter
-
Gets the default local Bluetooth adapter.
BluetoothAdapter getDefaultAdapter();
Since: 1.0
Privilege level: public
Privilege: http://tizen.org/privilege/bluetooth
Warning: http://tizen.org/privilege/bluetooth.gap (public level) has been deprecated since 2.4. Instead, use http://tizen.org/privilege/bluetooth.
Return value:
-
BluetoothAdapter:
The local BluetoothAdapter object.
Exceptions:
- WebAPIException
with error type SecurityError, if the application does not have the privilege to call this method.
with error type UnknownError, if any other error occurs.
Code example:
try { var adapter = tizen.bluetooth.getDefaultAdapter(); } catch (err) { console.log(err.name + ": " + err.message); }
- WebAPIException
-
getLEAdapter
-
Gets the default Low Energy Bluetooth adapter.
BluetoothLEAdapter getLEAdapter();
Since: 2.3.1
Privilege level: public
Privilege: http://tizen.org/privilege/bluetooth
Warning: http://tizen.org/privilege/bluetooth.admin (public level) has been deprecated since 2.4. Instead, use http://tizen.org/privilege/bluetooth.
Remark: To check if this method is supported or not, use tizen.systeminfo.getCapability("http://tizen.org/feature/network.bluetooth.le").
Return value:
-
BluetoothLEAdapter:
The local BluetoothLEAdapter object.
Exceptions:
- WebAPIException
with error type SecurityError, if the application does not have the privilege to call this method.
with error type NotSupportedError, if the feature is not supported.
with error type UnknownError, if any other error occurs.
Code example:
try { var adapter = tizen.bluetooth.getLEAdapter(); } catch (err) { console.log(err.name + ": " + err.message); }
- WebAPIException
2.7. BluetoothAdapter
[NoInterfaceObject] interface BluetoothAdapter { readonly attribute DOMString name; readonly attribute BluetoothAddress address; readonly attribute boolean powered; readonly attribute boolean visible; void setName(DOMString name, optional SuccessCallback? successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); void setPowered(boolean state, optional SuccessCallback? successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); void setVisible(boolean mode, optional SuccessCallback? successCallback, optional ErrorCallback? errorCallback, optional unsigned short? timeout) raises(WebAPIException); void setChangeListener(BluetoothAdapterChangeCallback listener) raises(WebAPIException); void unsetChangeListener() raises(WebAPIException); void discoverDevices(BluetoothDiscoverDevicesSuccessCallback successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); void stopDiscovery(optional SuccessCallback? successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); void getKnownDevices(BluetoothDeviceArraySuccessCallback successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); void getDevice(BluetoothAddress address, BluetoothDeviceSuccessCallback successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); void createBonding(BluetoothAddress address, BluetoothDeviceSuccessCallback successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); void destroyBonding(BluetoothAddress address, optional SuccessCallback? successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); void registerRFCOMMServiceByUUID(BluetoothUUID uuid, DOMString name, BluetoothServiceSuccessCallback successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); BluetoothProfileHandler getBluetoothProfileHandler(BluetoothProfileType profileType) raises(WebAPIException); };
Since: 1.0
This interface offers methods to control local Bluetooth behavior, such as:
- Turning on/off Bluetooth radio
- Changing device visibility
- Scanning for remote devices
- Accessing known devices
- Registering a service in the device service database
Attributes
-
readonly
DOMString nameThe readable name of the Bluetooth adapter.
Since: 1.0
Code example:
/* Access adapter name. */ var adapter = tizen.bluetooth.getDefaultAdapter(); console.log("Bluetooth adapter name: " + adapter.name);
-
readonly
BluetoothAddress addressThe unique hardware address of the Bluetooth adapter, also known as the MAC address.
Since: 1.0
Code example:
var adapter = tizen.bluetooth.getDefaultAdapter(); console.log("Bluetooth device address: " + adapter.address);
-
readonly
boolean poweredThe current state of the Bluetooth adapter.
This attribute holds one of the following 2 values:
- true - If Bluetooth adapter is currently on
- false - If Bluetooth adapter is currently off
Since: 1.0
Code example:
var adapter = tizen.bluetooth.getDefaultAdapter(); console.log("Bluetooth state: " + (adapter.powered ? "On" : "Off"));
-
readonly
boolean visibleThe current visibility state of the Bluetooth adapter, that is, whether the local device is discoverable by remote devices.
Since: 1.0
Code example:
/* Queries the current visible state. */ var adapter = tizen.bluetooth.getDefaultAdapter(); console.log("Bluetooth Visibility: " + (adapter.visible ? "On" : "Off"));
Methods
-
setName
-
Sets the local Bluetooth adapter name.
void setName(DOMString name, optional SuccessCallback? successCallback, optional ErrorCallback? errorCallback);
Since: 1.0
Sends a request to Bluetooth hardware to change the name of the local Bluetooth adapter to name.
The ErrorCallback is launched with these error types:
- InvalidValuesError: If any of the input parameters contain an invalid value.
- ServiceNotAvailableError: If a Bluetooth device is turned off.
- UnknownError: In any other error case.
- NotSupportedError: If a device doesn't allow a Tizen Web application to change the name of the local Bluetooth adapter.
Privilege level: public
Privilege: http://tizen.org/privilege/bluetooth
Warning: http://tizen.org/privilege/bluetooth.admin (public level) has been deprecated since 2.4. Instead, use http://tizen.org/privilege/bluetooth.
Remark: To check if this method is supported or not, use tizen.systeminfo.getCapability("http://tizen.org/feature/network.bluetooth")
Parameters:
- name: Name to set.
- successCallback [optional] [nullable]: Callback function that is called when the asynchronous call completes successfully.
- errorCallback [optional] [nullable]: Callback function that is called when an error occurs.
Exceptions:
- WebAPIException
with error type TypeMismatchError, if any of the input parameter is not compatible with the expected type for that parameter.
with error type SecurityError, if the application does not have the privilege to call this method.
Code example:
var adapter = tizen.bluetooth.getDefaultAdapter(); var capability = tizen.systeminfo.getCapability("http://tizen.org/feature/network.bluetooth"); function changeName(newName) { if (adapter.name != newName) { /* Initiate change name. */ adapter.setName(newName, function() { console.log("Adapter name changed to " + adapter.name); }, function(e) { console.log("Failed to change name: " + e.message); }); } } if (capability === true) { changeName("myDevice"); }
-
setPowered
-
Sets the state of a Bluetooth adapter to on or off by sending a request to Bluetooth hardware to change the power state. For most Bluetooth actions, the Bluetooth adapter must be powered on.
Deprecated. It is deprecated since Tizen 2.3. Instead, let the user turn on/off Bluetooth through the Settings application. See Managing Bluetooth Tutorial.
void setPowered(boolean state, optional SuccessCallback? successCallback, optional ErrorCallback? errorCallback);
Since: 1.0
The ErrorCallback is launched with these error names:
- ServiceNotAvailableError - If a Bluetooth device is busy
-
NotSupportedError: If a device does not allow a Tizen Web application to turn on or off the Bluetooth service on a device.
Bluetooth must be enabled on the device which the remote Bluetooth devices always work with - UnknownError - If any other error occurs
Privilege level: public
Privilege: http://tizen.org/privilege/bluetooth
Warning: http://tizen.org/privilege/bluetooth.admin (public level) has been deprecated since 2.4. Instead, use http://tizen.org/privilege/bluetooth.
Remark: To check if this method is supported or not, use this.systeminfo.getCapability( "http://tizen.org/feature/network.bluetooth").
Parameters:
- state: State to set: true to power on Bluetooth, false to power it off
- successCallback [optional] [nullable]: Callback function that is called on successful Bluetooth activation/deactivation
- errorCallback [optional] [nullable]: Callback function that is called on failure of a Bluetooth activation/deactivation
Exceptions:
- WebAPIException
with error type TypeMismatchError, if any of the input parameter is not compatible with the expected type for that parameter.
with error type SecurityError, if the application does not have the privilege to call this method.
Code example:
var adapter = tizen.bluetooth.getDefaultAdapter(); function powerOn() { /* If adapter is not powered on. */ if (!adapter.powered) { /* Initiates power on. */ adapter.setPowered(true, function() { console.log("Bluetooth powered on success."); }, function(e) { console.log("Failed to power on Bluetooth: " + e.message); }); } } function powerOff() { /* If powered on. */ if (adapter.powered) { /* Initiates power off. */ adapter.setPowered(false, function() { console.log("Bluetooth powered off successfully."); }, function(e) { console.log("Failed to power off Bluetooth: " + e.message); }); } } var capability = tizen.systeminfo.getCapability("http://tizen.org/feature/network.bluetooth"); if (capability === true) { console.log("Bluetooth cannot be turn off or on because this device must be always enabled."); } else { powerOn(); }
-
setVisible
-
Sets the local device visibility by sending a request to a Bluetooth hardware to change the device visible state to mode.
Deprecated. It is deprecated since Tizen 2.3. Instead, let the user change the Bluetooth visibility through the Settings application. See the Managing Bluetooth Tutorial.
void setVisible(boolean mode, optional SuccessCallback? successCallback, optional ErrorCallback? errorCallback, optional unsigned short? timeout);
Since: 1.0
If mode is true, then the device is visible to other devices, that is, it responds to inquiry calls from remote devices for time period defined (in seconds) by timeout. After the timeout, the device will become invisible.
If timeout is not passed or an invalid parameter is passed, the timeout defaults to 180 seconds (3 minutes). A timeout of 0 is considered unlimited.
The ErrorCallback is launched with these error types:
- InvalidValuesError - If any of the input parameters contain an invalid value
- ServiceNotAvailableError - If a Bluetooth device is turned off
-
NotSupportedError: If a device does not allow a Tizen Web application to change the visibility of the local device
because some devices must be always discoverable from the remote Bluetooth devices - UnknownError - If any other error case occurs
Privilege level: platform
Privilege: http://tizen.org/privilege/bluetoothmanager
Remark: To check if this method is supported or not, use tizen.systeminfo.getCapability("http://tizen.org/feature/network.bluetooth")
Parameters:
- mode: The boolean value to set visibility It can either be set to: true - to show the device or false - to hide the device.
- successCallback [optional] [nullable]: Callback function that is called when changing visibility completes successfully
- errorCallback [optional] [nullable]: Callback function that is called when an error occurs
- timeout [optional] [nullable]: The visible timeout in seconds, used only when mode is true
Exceptions:
- WebAPIException
with error type TypeMismatchError, if any of the input parameter is not compatible with the expected type for that parameter.
with error type SecurityError, if the application does not have the privilege to call this method.
Code example:
var adapter = tizen.bluetooth.getDefaultAdapter(); function showMe() { if (adapter.visible == false) { /* Shows device */ adapter.setVisible(true, function() { console.log("Device is visible to other devices for 3 minutes."); }, function(e) { console.log("Error: " + e.message + "(" + e.name + ")"); }); } else { console.log("Device is already in discoverable mode."); } } function hideMe() { if (adapter.visible) { /* Hides device. */ adapter.setVisible(false, function() { console.log("Device is in-visible now."); }, function(e) { console.log("Error: " + e.message + "(" + e.name + ")"); }); } else { console.log("Device is already in invisible mode."); } } var capability = tizen.systeminfo.getCapability("http://tizen.org/feature/network.bluetooth"); if (capability === true) { console.log( "Because Bluetooth must be always discoverable from the remote Bluetooth devices, this method does not work. NotSupportedError would be returned through ErrorCallback."); } else { powerOn(); }
-
setChangeListener
-
Sets the listener to receive notifications about changes of Bluetooth adapter.
void setChangeListener(BluetoothAdapterChangeCallback listener);
Since: 2.2
Parameters:
- listener: The Bluetooth Adapter event listener to set.
Exceptions:
- WebAPIException
with error type TypeMismatchError, if the input parameter is not compatible with the expected type.
with error type SecurityError, if this functionality is not allowed.
with error type UnknownError, if any other error occurs.
Code example:
var changeListener = { onstatechanged: function(powered) { console.log("Power state is changed into: " + powered); }, onnamechanged: function(name) { console.log("Name is changed to: " + name); }, onvisibilitychanged: function(visible) { console.log("Visibility is changed into: " + visible); } }; var adapter = tizen.bluetooth.getDefaultAdapter(); adapter.setChangeListener(changeListener);
-
unsetChangeListener
-
Unsets the listener, so stop receiving notifications about changes of Bluetooth adapter.
void unsetChangeListener();
Since: 2.2
Calling this function has no effect if listener is not set.
Exceptions:
- WebAPIException
with error type SecurityError, if this functionality is not allowed.
with error type UnknownError, if any other error occurs.
Code example:
var adapter = tizen.bluetooth.getDefaultAdapter(); var changeListener = { onstatechanged: function(powered) { console.log("Power state is changed into: " + powered); if (!powered) adapter.unsetChangeListener(); }, onnamechanged: function(name) { console.log("Name is changed to: " + name); }, onvisibilitychanged: function(visible) { console.log("Visibility is changed into: " + visible); } }; adapter.setChangeListener(changeListener);
- WebAPIException
-
discoverDevices
-
Discovers nearby Bluetooth devices if any, that is, devices within proximity to the local device.
void discoverDevices(BluetoothDiscoverDevicesSuccessCallback successCallback, optional ErrorCallback? errorCallback);
Since: 1.0
This method initiates the device discovery process. Depending on the progress of this process the following methods are invoked:
- BluetoothDiscoverDevicesSuccessCallback.onstarted() - when a discovery process starts successfully.
- BluetoothDiscoverDevicesSuccessCallback.ondevicefound() - when any device is found in the process and this method is invoked with the device information. If no device is found, this method will never be invoked.
- BluetoothDiscoverDevicesSuccessCallback.ondevicedisappeared() - when a device goes out of proximity and this method is invoked with the address of the device.
- BluetoothDiscoverDevicesSuccessCallback.onfinished() - when a discovery process is completed.
A discovery process can be canceled anytime, by calling stopDiscovery() on the BluetoothAdapter.
The ErrorCallback is launched with these error types:
- ServiceNotAvailableError - If a Bluetooth device is turned off
- UnknownError - If any other error occurs
Privilege level: public
Privilege: http://tizen.org/privilege/bluetooth
Warning: http://tizen.org/privilege/bluetooth.gap (public level) has been deprecated since 2.4. Instead, use http://tizen.org/privilege/bluetooth.
Parameters:
- successCallback: Callback function that is called when an asynchronous call completes successfully.
- errorCallback [optional] [nullable]: Callback function that is called when an error occurs.
Exceptions:
- WebAPIException
with error type TypeMismatchError, if any of the input parameter is not compatible with the expected type for that parameter.
with error type SecurityError, if the application does not have the privilege to call this method.
Code example:
var adapter = tizen.bluetooth.getDefaultAdapter(); /* Purpose of code below is to enable Bluetooth on the device. */ var bluetoothSwitchAppControl = new tizen.ApplicationControl( "http://tizen.org/appcontrol/operation/edit", null, "application/x-bluetooth-on-off"); function launchSuccess() { console.log("Bluetooth Settings application is successfully launched"); } function launchError(error) { alert("An error occurred: " + error.name + ". Please enable Bluetooth through the Settings application"); } var serviceReply = { /* Called when the launched application reports success. */ onsuccess: function(data) { if (adapter.powered) { console.log("Bluetooth is successfully turned on"); startDiscovery(); } else { console.log("Bluetooth is still switched off"); } }, /* Called when launched application reports failure. */ onfailure: function() { alert("Bluetooth Settings application reported failure"); } }; /* Discovery sample code. */ function startDiscovery() { var discoverDevicesSuccessCallback = { onstarted: function() { console.log("Device discovery started"); }, ondevicefound: function(device) { console.log("Found device - name: " + device.name + ", Address: " + device.address); }, ondevicedisappeared: function(address) { console.log("Device disappeared: " + address); }, onfinished: function(devices) { console.log("Found Devices"); for (var i = 0; i < devices.length; i++) { console.log("Name: " + devices[i].name + ", Address: " + devices[i].address); } console.log("Total: " + devices.length); } }; /* Starts searching for nearby devices, for about 12 sec. */ adapter.discoverDevices(discoverDevicesSuccessCallback, function(e) { console.log("Failed to search devices: " + e.message + "(" + e.name + ")"); }); } /* Execution. */ if (adapter.powered) { console.log("Bluetooth is already enabled"); startDiscovery(); } else { console.log("Try to launch the Bluetooth Settings application"); tizen.application.launchAppControl( bluetoothSwitchAppControl, null, launchSuccess, launchError, serviceReply); }
-
stopDiscovery
-
Stops an active device discovery session.
void stopDiscovery(optional SuccessCallback? successCallback, optional ErrorCallback? errorCallback);
Since: 1.0
Device discovery is a heavyweight procedure, hence we recommend stopping discovery as soon as the required device is found. This method cancels an active discovery session.
The ErrorCallback is launched with these error types:
- ServiceNotAvailableError - If a Bluetooth device is turned off
- UnknownError - If any other error occurs
Privilege level: public
Privilege: http://tizen.org/privilege/bluetooth
Warning: http://tizen.org/privilege/bluetooth.gap (public level) has been deprecated since 2.4. Instead, use http://tizen.org/privilege/bluetooth.
Parameters:
- successCallback [optional] [nullable]: Callback function to invoke when an asynchronous call completes successfully.
- errorCallback [optional] [nullable]: Callback function to invoke when an error occurs.
Exceptions:
- WebAPIException
with error type TypeMismatchError, if any of the input parameter is not compatible with the expected type for that parameter.
with error type SecurityError, if the application does not have the privilege to call this method.
Code example:
var adapter = tizen.bluetooth.getDefaultAdapter(); /* Purpose of code below is to enable Bluetooth on the device. */ var bluetoothSwitchAppControl = new tizen.ApplicationControl( "http://tizen.org/appcontrol/operation/edit", null, "application/x-bluetooth-on-off"); function launchSuccess() { console.log("Bluetooth Settings application is successfully launched"); } function launchError(error) { alert("An error occurred: " + error.name + ". Please enable Bluetooth through the Settings application"); } var serviceReply = { /* Called when the launched application reports success. */ onsuccess: function(data) { if (adapter.powered) { console.log("Bluetooth is successfully turned on"); startDiscovery(); } else { console.log("Bluetooth is still switched off"); } }, /* Called when launched application reports failure. */ onfailure: function() { alert("Bluetooth Settings application reported failure"); } }; /* Discovery sample code. */ /* Calls this method whenever user finds one of the devices. */ function cancelDiscovery() { adapter.stopDiscovery( function() { console.log("Stop discovery success"); }, function(e) { console.log("Error while stopDiscovery:" + e.message); }); } function startDiscovery() { var discoverDevicesSuccessCallback = { onstarted: function() { console.log("Device discovery started"); }, ondevicefound: function(device) { console.log("Found device - name: " + device.name + ", Address: " + device.address); /* Shows the device to user to check if this is the device user is looking for. */ /* For example, add this to list view. */ cancelDiscovery(); }, ondevicedisappeared: function(address) { console.log("Device disappeared: " + address); /* Removes from list, as it is no longer valid. */ }, onfinished: function(devices) { console.log("Found Devices"); for (var i = 0; i < devices.length; i++) { console.log("Name: " + devices[i].name + ", Address: " + devices[i].address); } console.log("Total: " + devices.length); } }; /* Starts searching for nearby devices, for about 12 sec. */ adapter.discoverDevices(discoverDevicesSuccessCallback, function(e) { console.log("Failed to search devices: " + e.message + "(" + e.name + ")"); }); } /* Execution. */ if (adapter.powered) { console.log("Bluetooth is already enabled"); startDiscovery(); } else { console.log("Try to launch the Bluetooth Settings application"); tizen.application.launchAppControl( bluetoothSwitchAppControl, null, launchSuccess, launchError, serviceReply); }
-
getKnownDevices
-
Gets all the known devices that have information stored in the local Bluetooth adapter.
void getKnownDevices(BluetoothDeviceArraySuccessCallback successCallback, optional ErrorCallback? errorCallback);
Since: 1.0
A known device is one of the following:
- a bonded device
- a device found in last inquiry process
On success, it returns the list of currently known devices through BluetoothDeviceArraySuccessCallback.
The ErrorCallback is launched with these error types:
- ServiceNotAvailableError - If a Bluetooth device is turned off
- UnknownError - If any other error occurs
Privilege level: public
Privilege: http://tizen.org/privilege/bluetooth
Warning: http://tizen.org/privilege/bluetooth.gap (public level) has been deprecated since 2.4. Instead, use http://tizen.org/privilege/bluetooth.
Parameters:
- successCallback: Callback function to invoke at retrieval of a list of Bluetooth devices that were bonded (paired) to the local Bluetooth adapter.
- errorCallback [optional] [nullable]: Callback function to invoke in case of failure in finding bonded devices.
Exceptions:
- WebAPIException
with error type TypeMismatchError, if the input parameter is not compatible with the expected type for that parameter
with error type SecurityError, if the application does not have the privilege to call this method.
Code example:
var adapter = tizen.bluetooth.getDefaultAdapter(); /* Purpose of code below is to enable Bluetooth on the device. */ var bluetoothSwitchAppControl = new tizen.ApplicationControl( "http://tizen.org/appcontrol/operation/edit", null, "application/x-bluetooth-on-off"); function launchSuccess() { console.log("Bluetooth Settings application is successfully launched"); } function launchError(error) { alert("An error occurred: " + error.name + ". Please enable Bluetooth through the Settings application"); } var serviceReply = { /* Called when the launched application reports success. */ onsuccess: function(data) { if (adapter.powered) { console.log("Bluetooth is successfully turned on"); adapter.getKnownDevices(onGotDevices, onError); } else { console.log("Bluetooth is still switched off"); } }, /* Called when launched application reports failure. */ onfailure: function() { alert("Bluetooth Settings application reported failure"); } }; /* getKnownDevices sample code. */ function onGotDevices(devices) { console.log("Devices"); for (var i = 0; i < devices.length; i++) { console.log(" Name: " + devices[i].name + ", Address: " + devices[i].address); } console.log("Total: " + devices.length); } function onError(e) { console.log("Error: " + e.message); } /* Execution. */ if (adapter.powered) { console.log("Bluetooth is already enabled"); adapter.getKnownDevices(onGotDevices, onError); } else { console.log("Try to launch the Bluetooth Settings application"); tizen.application.launchAppControl( bluetoothSwitchAppControl, null, launchSuccess, launchError, serviceReply); }
-
getDevice
-
Gets the BluetoothDevice object for a given device hardware address.
void getDevice(BluetoothAddress address, BluetoothDeviceSuccessCallback successCallback, optional ErrorCallback? errorCallback);
Since: 1.0
This method returns device information stored in the local Bluetooth adapter for the specified device address through BluetoothDeviceSuccessCallback. A valid hardware address must be passed, such as "35:F4:59:D1:7A:03".
The ErrorCallback is launched with these error types:
- NotFoundError - If there is no device with the given address
- ServiceNotAvailableError - If a Bluetooth device is turned off
- UnknownError - If any other error occurs
Privilege level: public
Privilege: http://tizen.org/privilege/bluetooth
Warning: http://tizen.org/privilege/bluetooth.gap (public level) has been deprecated since 2.4. Instead, use http://tizen.org/privilege/bluetooth.
Parameters:
- address: Address of a remote Bluetooth device to get.
- successCallback: Callback function that is called when an asynchronous call completes successfully.
- errorCallback [optional] [nullable]: Callback function that is called when an error occurs.
Exceptions:
- WebAPIException
with error type TypeMismatchError, if the input parameter is not compatible with the expected type for that parameter
with error type SecurityError, if the application does not have the privilege to call this method.
Code example:
function gotDeviceInfo(device) { console.log("Device Name: " + device.name); console.log("Device Address: " + device.address); console.log("Device Class: " + device.deviceClass.major); console.log("Is Bonded: " + (device.isBonded ? "Yes" : "No")); } function onError(e) { console.log("Could not get device info:" + e.message); } var adapter = tizen.bluetooth.getDefaultAdapter(); adapter.getDevice("35:F4:59:D1:7A:03", gotDeviceInfo, onError);
-
createBonding
-
Creates a bond with a remote device by initiating the bonding process with peer device, using the given MAC address. The remote device must be bonded with the local device in order to connect to services of the remote device and then exchange data with each other.
void createBonding(BluetoothAddress address, BluetoothDeviceSuccessCallback successCallback, optional ErrorCallback? errorCallback);
Since: 1.0
If the bonding process is successful, the device information is sent in successCallback.
The ErrorCallback is launched with these error types:
- NotFoundError - If there is no device with the given address
- ServiceNotAvailableError - If a Bluetooth device is turned off
- UnknownError - If any other error occurs
Privilege level: public
Privilege: http://tizen.org/privilege/bluetooth
Warning: http://tizen.org/privilege/bluetooth.gap (public level) has been deprecated since 2.4. Instead, use http://tizen.org/privilege/bluetooth.
Parameters:
- address: MAC address of remote Bluetooth address to bond with.
- successCallback: Callback function that is called when an asynchronous call completes successfully.
- errorCallback [optional] [nullable]: Callback function that is called when an error occurs.
Exceptions:
- WebAPIException
with error type TypeMismatchError, if the input parameter is not compatible with the expected type for that parameter.
with error type SecurityError, if the application does not have the privilege to call this method.
Code example:
function onBondingSuccess(device) { console.log("Device Name:" + device.name); console.log("Device Address:" + device.address); console.log("Device Service UUIDs:" + device.uuids.join("\n")); } function onError(e) { console.log("Could not create bonding, reason:" + e.message); } var adapter = tizen.bluetooth.getDefaultAdapter(); adapter.createBonding("35:F4:59:D1:7A:03", onBondingSuccess, onError);
-
destroyBonding
-
Destroys the bond with a remote device.
void destroyBonding(BluetoothAddress address, optional SuccessCallback? successCallback, optional ErrorCallback? errorCallback);
Since: 1.0
This method initiates the process of removing the specified address from the list of bonded devices.
The ErrorCallback is launched with these error types:
- NotFoundError - If there is no device with the given address
- ServiceNotAvailableError - If a Bluetooth device is turned off
- UnknownError - If any other error occurs
Privilege level: public
Privilege: http://tizen.org/privilege/bluetooth
Warning: http://tizen.org/privilege/bluetooth.gap (public level) has been deprecated since 2.4. Instead, use http://tizen.org/privilege/bluetooth.
Parameters:
- address: Address of a bonded device.
- successCallback [optional] [nullable]: Callback function that is called when an asynchronous call completes successfully.
- errorCallback [optional] [nullable]: Callback function that is called when an error occurs.
Exceptions:
- WebAPIException
with error type TypeMismatchError, if the input parameter is not compatible with the expected type for that parameter
with error type SecurityError, if the application does not have the privilege to call this method.
Code example:
var adapter = tizen.bluetooth.getDefaultAdapter(); function gotDevice(device) { if (device.isBonded) { /* Initiates destroying bonding. */ adapter.destroyBonding(device.address, function() { console.log("Succeeded to destroy the bond success with:" + device.address); }, function(e) { console.log( "Failed to destroy the bond with " + device.address + ", reason: " + e.message); }); } } var deviceAddress = "35:F4:59:D1:7A:03"; adapter.getDevice(deviceAddress, gotDevice, function(e) { console.log("Failed to get device info for " + deviceAddress + ", reason: " + e.message); });
-
registerRFCOMMServiceByUUID
-
Registers a service record in the device service record database with the specified uuid, name.
void registerRFCOMMServiceByUUID(BluetoothUUID uuid, DOMString name, BluetoothServiceSuccessCallback successCallback, optional ErrorCallback? errorCallback);
Since: 1.0
On success of the service registration, it returns a BluetoothServiceHandler object as the first parameter of successCallback, and listens for client connections. The service handler can be used to be notified on client connections or to unregister the service. User interaction is mandatory to connect to a registered service.
If any client(remote device) connects to this service, then BluetoothServiceHandler.onconnect() is invoked with BluetoothSocket object.
BluetoothServiceHandler.unregister() can be used to unregister the service record from the device service database and stop listening for client connections.
The ErrorCallback is launched with these error types:
- InvalidValuesError - If any of the input parameters contain an invalid value
- ServiceNotAvailableError - If a Bluetooth device is turned off
- UnknownError - If any other error occurs
Privilege level: public
Privilege: http://tizen.org/privilege/bluetooth
Warning: http://tizen.org/privilege/bluetooth.spp (public level) has been deprecated since 2.4. Instead, use http://tizen.org/privilege/bluetooth.
Parameters:
- uuid: UUID of the new service, to which clients connect.
- name: Name of a service.
- successCallback: Callback function that is called on successful service registration.
- errorCallback [optional] [nullable]: Callback function that is called when an error occurs.
Exceptions:
- WebAPIException
with error type TypeMismatchError, if the input parameter is not compatible with the expected type for that parameter.
with error type SecurityError, if the application does not have the privilege to call this method.
Code example:
var adapter = tizen.bluetooth.getDefaultAdapter(); /* Holds currently registered service record. */ var chatServiceHandler = null; /* Holds currently open socket. */ var serviceSocket = null; function chatServiceSuccessCb(recordHandler) { console.log("Chat service registration succeeds!"); chatServiceHandler = recordHandler; recordHandler.onconnect = function(socket) { console.log("Client connected: " + socket.peer.name + "," + socket.peer.address); serviceSocket = socket; /* Messages received from remote device. */ socket.onmessage = function() { var data = socket.readData(); /* Handles message code goes here. */ }; socket.onclose = function() { console.log("The socket is closed"); serviceSocket = null; }; }; } function publishChatService() { /* Only RFCOMM services with 128-bit UUIDs can be registered */ var CHAT_SERVICE_UUID = "5BCE9431-6C75-32AB-AFE0-2EC108A30860"; adapter.registerRFCOMMServiceByUUID(CHAT_SERVICE_UUID, "Chat service", chatServiceSuccessCb, /* Error handler. */ function(e) { console.log("Could not register service record, Error: " + e.message); }); } function unregisterChatService() { if (chatServiceHandler != null) { chatServiceHandler.unregister( function() { console.log("Chat service is unregistered"); chatServiceHandler = null; }, function(e) { console.log("Failed to unregister service: " + e.message); }); } }
-
getBluetoothProfileHandler
-
Gets the profile handler for the given type.
BluetoothProfileHandler getBluetoothProfileHandler(BluetoothProfileType profileType);
Since: 2.2
Remark: To check if HEALTH type is supported or not, use tizen.systeminfo.getCapability("http://tizen.org/feature/network.health")
Parameters:
- profileType: Bluetooth Profile type.
Return value:
-
BluetoothProfileHandler:
Represents the Bluetooth profile handle.
Exceptions:
- WebAPIException
with error type TypeMismatchError, if the input parameter is not compatible with the expected type for that parameter.
with error type NotSupportedError, if the given profileType is not supported on a device.
with error type UnknownError, if any other error occurs.
Code example:
var adapter = tizen.bluetooth.getDefaultAdapter(); var healthProfileHandler; var healthCapability = tizen.systeminfo.getCapability("http://tizen.org/feature/network.bluetooth.health"); if (healthCapability) { healthProfileHandler = adapter.getBluetoothProfileHandler("HEALTH"); } else { console.log("Bluetooth Health Profile is not supported on this device"); }
2.8. BluetoothLEAdapter
[NoInterfaceObject] interface BluetoothLEAdapter { void startScan(BluetoothLEScanCallback successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); void stopScan() raises(WebAPIException); void startAdvertise(BluetoothLEAdvertiseData advertiseData, BluetoothAdvertisePacketType packetType, BluetoothLEAdvertiseCallback successCallback, optional ErrorCallback? errorCallback, optional BluetoothAdvertisingMode? mode, optional boolean? connectable) raises(WebAPIException); void stopAdvertise() raises(WebAPIException); };
Since: 2.3.1
This interface offers methods to control local Bluetooth Low Energy behavior, such as:
- Scanning and Advertising for remote devices
Methods
-
startScan
-
Starts scanning for Low Energy advertisement.
void startScan(BluetoothLEScanCallback successCallback, optional ErrorCallback? errorCallback);
Since: 2.3.1
There is no time limit for the bluetooth Low Energy scanning process. It can be canceled only by calling the stopScan() method in the BluetoothLEAdapter interface.
The ErrorCallback will be launched in the following situations:
- ServiceNotAvailableError - If a Bluetooth device is turned off
- UnknownError - If any other error occurs.
Privilege level: public
Privilege: http://tizen.org/privilege/bluetooth
Warning: http://tizen.org/privilege/bluetooth.admin (public level) has been deprecated since 2.4. Instead, use http://tizen.org/privilege/bluetooth.
Parameters:
- successCallback: Called when advertisement is found.
- errorCallback [optional] [nullable]: The method to invoke when an error occurs.
Exceptions:
- WebAPIException
with error type TypeMismatchError, if any input attribute is not compatible with the expected type for this attribute.
with error type InvalidStateError, if device is currently in progress of scanning, if the local Bluetooth le adapter is currently not enabled.
with error type SecurityError, if the application does not have the privilege to call this method.
Code example:
var adapter = tizen.bluetooth.getLEAdapter(); adapter.startScan(function onsuccess(device) { console.log("[Found device] address: " + device.address); });
-
stopScan
-
Stops scanning for Low Energy advertisement.
void stopScan();
Since: 2.3.1
Privilege level: public
Privilege: http://tizen.org/privilege/bluetooth
Warning: http://tizen.org/privilege/bluetooth.admin (public level) has been deprecated since 2.4. Instead, use http://tizen.org/privilege/bluetooth.
Exceptions:
- WebAPIException
with error type SecurityError, if the application does not have the privilege to call this method.
with error type UnknownError, if any other error occurs
Code example:
var adapter = tizen.bluetooth.getLEAdapter(); adapter.startScan(function onsuccess(device) { if (device.address == "11:22:33:44:55:66") { console.log("Found device: " + device.name); adapter.stopScan(); } });
- WebAPIException
-
startAdvertise
-
Starts advertising for Low Energy Devices.
void startAdvertise(BluetoothLEAdvertiseData advertiseData, BluetoothAdvertisePacketType packetType, BluetoothLEAdvertiseCallback successCallback, optional ErrorCallback? errorCallback, optional BluetoothAdvertisingMode? mode, optional boolean? connectable);
Since: 2.3.1
A advertising process can be canceled anytime, by calling stopAdvertise() on the BluetoothLEAdapter.
The ErrorCallback will be launched in the following situations:
- ServiceNotAvailableError - If a Bluetooth device is turned off
- UnknownError - If any other error occurs
Privilege level: public
Privilege: http://tizen.org/privilege/bluetooth
Warning: http://tizen.org/privilege/bluetooth.admin (public level) has been deprecated since 2.4. Instead, use http://tizen.org/privilege/bluetooth.
Parameters:
- advertiseData: BluetoothLEAdvertiseData object to be added.
- packetType: The bluetooth LE packet type.
- successCallback: Callback function that is called when advertise is started successfully.
- errorCallback [optional] [nullable]: The method to invoke when an error occurs.
- mode [optional] [nullable]: The power and latency mode of advertising. The default mode is "BALANCED".
- connectable [optional] [nullable]: The connectable status. It's true if the advertisement will be connectable. The default value of the parameter is true.
Exceptions:
- WebAPIException
with error type TypeMismatchError, if any input attribute is not compatible with the expected type for this attribute.
with error type QuotaExceededError, if any input attribute is not compatible with the maximum data size for this attribute.
with error type InvalidStateError, if device is currently in progress of advertising, if the local Bluetooth le adapter is currently not enabled.
with error type SecurityError, if the application does not have the privilege to call this method.
Code example:
var adapter = tizen.bluetooth.getLEAdapter(); var battery_svc_uuid_16 = "180f"; /* 16-bit service UUIDs are supported (e.g. 180f). */ var heart_rate_svc_uuid_16 = "180d"; /* Service solicitation UUID, 16-bit UUID are supported (e.g. 180d). */ var advertiseOptions = { includeName: true, /* Whether the device name should be included. */ includeTxPowerLevel: true, /* Whether the transmission power level should be included. */ appearance: 192, /* External appearance of device, 192 - Generic Watch. */ uuids: [battery_svc_uuid_16], solicitationuuids: [heart_rate_svc_uuid_16] }; var advertiseData = new tizen.BluetoothLEAdvertiseData(advertiseOptions); var connectable = true; adapter.startAdvertise(advertiseData, "ADVERTISE", function onstate(state) { console.log("Advertiser state: " + state); }, function(e) { console.log("Failed to startAdvertise: " + e.message); }, "LOW_LATENCY", connectable);
-
stopAdvertise
-
Stops advertising for Low Energy Devices.
void stopAdvertise();
Since: 2.3.1
Privilege level: public
Privilege: http://tizen.org/privilege/bluetooth
Warning: http://tizen.org/privilege/bluetooth.admin (public level) has been deprecated since 2.4. Instead, use http://tizen.org/privilege/bluetooth.
Exceptions:
- WebAPIException
with error type SecurityError, if the application does not have the privilege to call this method.
with error type UnknownError, if any other error occurs
Code example:
var adapter = tizen.bluetooth.getLEAdapter(); var battery_svc_uuid_16 = "180f"; /* 16-bit service UUIDs are supported (e.g. 180f). */ var heart_rate_svc_uuid_16 = "180d"; /* Service solicitation UUID, 16-bit UUIDs are supported (e.g. 180d). */ var advertiseOptions = { includeName: true, /* Whether the device name should be included. */ includeTxPowerLevel: true, /* Whether the transmission power level should be included. */ appearance: 192, /* External appearance of device, 192 - Generic Watch. */ uuids: [battery_svc_uuid_16], solicitationuuids: [heart_rate_svc_uuid_16] }; var advertiseData = new tizen.BluetoothLEAdvertiseData(advertiseOptions); adapter.startAdvertise(advertiseData, "ADVERTISE", function onstate(state) { console.log("Advertiser state: " + state); }); adapter.stopAdvertise();
- WebAPIException
2.9. BluetoothGATTService
[NoInterfaceObject] interface BluetoothGATTService { readonly attribute BluetoothUUID uuid; readonly attribute BluetoothGATTService[] services; readonly attribute BluetoothGATTCharacteristic[] characteristics; };
Since: 2.3.1
Code example:
function onconnected(device) { console.log("Connected to device"); var service = device.getService(device.uuids[0]); console.log("Service got"); } var adapter = tizen.bluetooth.getLEAdapter(); adapter.startScan(function onsuccess(device) { console.log("[Found device] address: " + device.address); device.connect(onconnected.bind(null, device), onerror); });
Attributes
-
readonly
BluetoothUUID uuidUUID of the service.
Since: 2.3.1
Remark: uuid is set to "0xFFFF", if the value cannot be retrieved.
Code example:
var service = device.getService(device.uuids[0]); console.log("Service UUID " + service.uuid);
-
readonly
BluetoothGATTService[]
servicesA list of services included in this service.
Since: 2.3.1
Code example:
var service = device.getService(device.uuids[0]); for (var i = 0; i < service.services.length; ++i) { console.log("Subservices UUID " + service.services[i].uuid); }
-
readonly
BluetoothGATTCharacteristic[]
characteristicsA list of characteristics in this service.
Since: 2.3.1
Code example:
var service = device.getService(device.uuids[0]); for (var i = 0; i < service.characteristics.length; ++i) { console.log("Subservices UUID " + service.characteristics[i].isWritable); }
2.10. BluetoothGATTCharacteristic
[NoInterfaceObject] interface BluetoothGATTCharacteristic { readonly attribute BluetoothGATTDescriptor[] descriptors; readonly attribute boolean isBroadcast; readonly attribute boolean hasExtendedProperties; readonly attribute boolean isNotify; readonly attribute boolean isIndication; readonly attribute boolean isReadable; readonly attribute boolean isSignedWrite; readonly attribute boolean isWritable; readonly attribute boolean isWriteNoResponse; void readValue(ReadValueSuccessCallback successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); void writeValue(byte[] value, optional SuccessCallback? successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); long addValueChangeListener(ReadValueSuccessCallback callback) raises(WebAPIException); void removeValueChangeListener(long watchID); };
Since: 2.3.1
Attributes
-
readonly
BluetoothGATTDescriptor[]
descriptorsA list of descriptors in this characteristic.
Since: 2.3.1
-
readonly
boolean isBroadcastIndicates if the characteristic is broadcastable.
Since: 2.3.1
-
readonly
boolean hasExtendedPropertiesIndicates if the characteristic has extended properties.
Since: 2.3.1
-
readonly
boolean isNotifyIndicates if the characteristic supports notification.
Since: 2.3.1
-
readonly
boolean isIndicationIndicates if the characteristic supports indication.
Since: 2.3.1
-
readonly
boolean isReadableIndicates if the characteristic is readable.
Since: 2.3.1
-
readonly
boolean isSignedWriteIndicates if the characteristic supports write with the signature.
Since: 2.3.1
-
readonly
boolean isWritableIndicates if the characteristic is writable.
Since: 2.3.1
-
readonly
boolean isWriteNoResponseIndicates if the characteristic supports writing without response.
Since: 2.3.1
Methods
-
readValue
-
Reads the characteristic value from the remote device. Updates characteristic value attribute.
void readValue(ReadValueSuccessCallback successCallback, optional ErrorCallback? errorCallback);
Since: 2.3.1
The ErrorCallback is launched with these error types:
- UnknownError - If any other error occurs
Privilege level: public
Privilege: http://tizen.org/privilege/bluetooth
Warning: http://tizen.org/privilege/bluetooth.admin (public level) has been deprecated since 2.4. Instead, use http://tizen.org/privilege/bluetooth.
Parameters:
- successCallback: Callback function that is called when the characteristic value is read successfully.
- errorCallback [optional] [nullable]: Callback function that is called in case of failure.
Exceptions:
- WebAPIException
with error type TypeMismatchError, if the input parameter is not compatible with the expected type for that parameter.
with error type InvalidStateError, if the local Bluetooth le adapter is currently not enabled.
with error type SecurityError, if the application does not have the privilege to call this method.
Code example:
function onerror(e) { console.log("Failed to connect to device: " + e.message); } function proccessDevice(device) { device.connect(onConnected, onerror); function onConnected() { var service = device.getService(device.uuids[0]); if (service.characteristics.length > 0) { var characteristic = service.characteristics[0]; characteristic.readValue(function(val) { console.log("Value read: " + val); device.disconnect(); }); } } } var adapter = tizen.bluetooth.getLEAdapter(); adapter.startScan(function onsuccess(device) { if (device.address == "11:22:33:44:55:66") { console.log("Found device: " + device.name); proccessDevice(device); } });
-
writeValue
-
Writes the characteristic value to the remote device.
void writeValue(byte[] value, optional SuccessCallback? successCallback, optional ErrorCallback? errorCallback);
Since: 2.3.1
The ErrorCallback is launched with these error types:
- UnknownError - If any other error occurs
Privilege level: public
Privilege: http://tizen.org/privilege/bluetooth
Warning: http://tizen.org/privilege/bluetooth.admin (public level) has been deprecated since 2.4. Instead, use http://tizen.org/privilege/bluetooth.
Parameters:
- value: The characteristic value to write.
- successCallback [optional] [nullable]: Callback function that is called when the characteristic value is written successfully.
- errorCallback [optional] [nullable]: Callback function that is called in case of failure.
Exceptions:
- WebAPIException
with error type TypeMismatchError, if the input parameter is not compatible with the expected type for that parameter.
with error type InvalidStateError, if the local Bluetooth le adapter is currently not enabled.
with error type SecurityError, if the application does not have the privilege to call this method.
Code example:
function onerror(e) { console.log("Failed to connect to device: " + e.message); } function proccessDevice(device) { device.connect(onConnected, onerror); function onConnected() { var service = device.getService(device.uuids[0]); if (service.characteristics.length > 0) { var characteristic = service.characteristics[0]; var data = new Array(1, 2, 3, 4, 5, 6); characteristic.writeValue(data, function() { console.log("Value written"); device.disconnect(); }, function(e) { console.log("Failed to write: " + e.message); }); } } } var adapter = tizen.bluetooth.getLEAdapter(); adapter.startScan(function onsuccess(device) { if (device.address == "11:22:33:44:55:66") { console.log("Found device: " + device.name); proccessDevice(device); } });
-
addValueChangeListener
-
Registers a callback to be called when characteristic value of the characteristic changes.
long addValueChangeListener(ReadValueSuccessCallback callback);
Since: 2.3.1
Privilege level: public
Privilege: http://tizen.org/privilege/bluetooth
Warning: http://tizen.org/privilege/bluetooth.admin (public level) has been deprecated since 2.4. Instead, use http://tizen.org/privilege/bluetooth.
Parameters:
- callback: Listener function that is called when the connection state changes.
Return value:
-
long:
The watchID to be used to unregister the listener.
Exceptions:
- WebAPIException
with error type SecurityError, if the application does not have the privilege to call this method.
Code example:
function proccessDevice(device) { function onConnected() { var service = device.getService("5BCE9431-6C75-32AB-AFE0-2EC108A30860"); if (service.characteristics.length > 0) { var characteristic = service.characteristics[0]; var watchID; watchID = characteristic.addValueChangeListener(function(value) { console.log("Characteristic value changed: " + value); characteristic.removeValueChangeListener(watchID); device.disconnect(); }); } } device.connect(onConnected); } var adapter = tizen.bluetooth.getLEAdapter(); adapter.startScan(function onsuccess(device) { if (device.address == "11:22:33:44:55:66") { console.log("Found device: " + device.name); adapter.stopScan(); proccessDevice(device); } });
-
removeValueChangeListener
-
Unregisters a characteristic value change listener.
void removeValueChangeListener(long watchID);
Since: 2.3.1
Calling this function has no effect if there is no listener with given id.
Remark: Example of using can be find at addValueChangeListener code example.
Parameters:
- watchID: The watchID identifier returned by the addValueChangeListener() method.
2.11. BluetoothGATTDescriptor
[NoInterfaceObject] interface BluetoothGATTDescriptor { void readValue(ReadValueSuccessCallback successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); void writeValue(byte[] value, optional SuccessCallback? successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); };
Since: 2.3.1
Methods
-
readValue
-
Reads descriptor value from remote device. Updates descriptor value attribute.
void readValue(ReadValueSuccessCallback successCallback, optional ErrorCallback? errorCallback);
Since: 2.3.1
The ErrorCallback is launched with these error types:
- UnknownError - If any other error occurs
Privilege level: public
Privilege: http://tizen.org/privilege/bluetooth
Warning: http://tizen.org/privilege/bluetooth.admin (public level) has been deprecated since 2.4. Instead, use http://tizen.org/privilege/bluetooth.
Parameters:
- successCallback: Callback function that is called when the descriptor value is read successfully.
- errorCallback [optional] [nullable]: Callback function that is called in case of failure.
Exceptions:
- WebAPIException
with error type TypeMismatchError, if the input parameter is not compatible with the expected type for that parameter.
with error type InvalidStateError, if the local Bluetooth le adapter is currently not enabled.
with error type SecurityError, if the application does not have the privilege to call this method.
Code example:
function onerror(e) { console.log("Failed to connect to device: " + e.message); } function proccessDevice(device) { device.connect(onConnected, onerror); function onConnected() { var service = device.getService(device.uuids[0]); if (service.characteristics.length > 0) { var characteristic = service.characteristics[0]; var descriptor = characteristic.descriptors[0]; descriptor.readValue(function(val) { console.log("Value read: " + val); device.disconnect(); }); } } } var adapter = tizen.bluetooth.getLEAdapter(); adapter.startScan(function onsuccess(device) { if (device.address == "11:22:33:44:55:66") { console.log("Found device: " + device.name); proccessDevice(device); } });
-
writeValue
-
Writes the descriptor value to the remote device.
void writeValue(byte[] value, optional SuccessCallback? successCallback, optional ErrorCallback? errorCallback);
Since: 2.3.1
The ErrorCallback is launched with these error types:
- UnknownError - If any other error occurs
Privilege level: public
Privilege: http://tizen.org/privilege/bluetooth
Warning: http://tizen.org/privilege/bluetooth.admin (public level) has been deprecated since 2.4. Instead, use http://tizen.org/privilege/bluetooth.
Parameters:
- value: The descriptor value to write.
- successCallback [optional] [nullable]: Callback function that is called when the descriptor value is written successfully.
- errorCallback [optional] [nullable]: Callback function that is called in case of failure.
Exceptions:
- WebAPIException
with error type TypeMismatchError, if the input parameter is not compatible with the expected type for that parameter.
with error type InvalidStateError, if the local Bluetooth le adapter is currently not enabled.
with error type SecurityError, if the application does not have the privilege to call this method.
Code example:
function onerror(e) { console.log("Failed to connect to device: " + e.message); } function proccessDevice(device) { device.connect(onConnected, onerror); function onConnected() { var service = device.getService(device.uuids[0]); if (service.characteristics.length > 0) { var characteristic = service.characteristics[0]; var data = new Array(1, 2, 3, 4, 5, 6); var descriptor = characteristic.descriptors[0]; descriptor.writeValue(data, function() { console.log("Value written"); device.disconnect(); }, function(e) { console.log("Failed to write: " + e.message); }); } } } var adapter = tizen.bluetooth.getLEAdapter(); adapter.startScan(function onsuccess(device) { if (device.address == "11:22:33:44:55:66") { console.log("Found device: " + device.name); proccessDevice(device); } });
2.12. BluetoothLEScanCallback
[Callback=FunctionOnly, NoInterfaceObject] interface BluetoothLEScanCallback { void onsuccess(BluetoothLEDevice device); };
Since: 2.3.1
Remark: Example of using can be find at startScan code example.
Methods
-
onsuccess
-
Called when a new device is successfully discovered in the process of scanning.
void onsuccess(BluetoothLEDevice device);
Since: 2.3.1
Parameters:
- device: Device that is found.
2.13. BluetoothLEAdvertiseCallback
[Callback=FunctionOnly, NoInterfaceObject] interface BluetoothLEAdvertiseCallback { void onstate(BluetoothAdvertisingState state); };
Since: 2.3.1
Remark: Example of using can be find at startAdvertise code example.
Methods
-
onstate
-
Called when the advertising state is changed.
void onstate(BluetoothAdvertisingState state);
Since: 2.3.1
Parameters:
- state: State that is Advertising process.
2.14. BluetoothLEConnectChangeCallback
[Callback, NoInterfaceObject] interface BluetoothLEConnectChangeCallback { void onconnected(BluetoothLEDevice device); void ondisconnected(BluetoothLEDevice device); };
Since: 2.3.1
Remark: Example of using can be find at addConnectStateChangeListener code example.
Methods
-
onconnected
-
Called at the beginning of connect to a specific LE based service on a remote Bluetooth LE device.
void onconnected(BluetoothLEDevice device);
Since: 2.3.1
-
ondisconnected
-
Called at the beginning of disconnect to a specific LE based service on a remote Bluetooth LE device.
void ondisconnected(BluetoothLEDevice device);
Since: 2.3.1
2.15. ReadValueSuccessCallback
[Callback=FunctionOnly, NoInterfaceObject] interface ReadValueSuccessCallback { void onread(byte[] value); };
Since: 2.3.1
Remark: Example of using can be find at BluetoothGATTCharacteristic.readValue() and BluetoothGATTDescriptor.readValue() code examples.
2.16. BluetoothDevice
[NoInterfaceObject] interface BluetoothDevice { readonly attribute DOMString name; readonly attribute BluetoothAddress address; readonly attribute BluetoothClass deviceClass; readonly attribute boolean isBonded; readonly attribute boolean isTrusted; readonly attribute boolean isConnected; readonly attribute BluetoothUUID[] uuids; void connectToServiceByUUID(BluetoothUUID uuid, BluetoothSocketSuccessCallback successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); };
Since: 1.0
A BluetoothDevice object can be retrieved using one of the following APIs:
- BluetoothAdapter.getDevice()
- BluetoothAdapter.getKnownDevices()
- BluetoothAdapter.discoverDevices()
- BluetoothAdapter.createBonding()
Attributes
-
readonly
DOMString nameThe readable name of this remote device.
Since: 1.0
Code example:
var adapter = tizen.bluetooth.getDefaultAdapter(); adapter.getDevice("11:22:33:44:55:66", function(device) { console.log("Device Name: " + device.name); });
-
readonly
BluetoothAddress addressThe hardware address of this remote device.
Since: 1.0
Code example:
var adapter = tizen.bluetooth.getDefaultAdapter(); adapter.getDevice("11:22:33:44:55:66", function(device) { console.log("Device Address: " + device.address); });
-
readonly
BluetoothClass deviceClassThe device class, which represents the type of the device and the services it provides.
Since: 1.0
Code example:
var adapter = tizen.bluetooth.getDefaultAdapter(); adapter.getDevice("11:22:33:44:55:66", function(device) { console.log("Device Major Class: " + device.deviceClass.major); });
-
readonly
boolean isBondedThe bond state of this remote device with the local device.
Since: 1.0
Code example:
var adapter = tizen.bluetooth.getDefaultAdapter(); adapter.getDevice("11:22:33:44:55:66", function(device) { console.log("Is bonded: " + (device.isBonded ? "Yes" : "No")); });
-
readonly
boolean isTrustedThe flag indicating whether the local device recognizes this remote device as a trusted device or not.
Since: 1.0
Code example:
var adapter = tizen.bluetooth.getDefaultAdapter(); adapter.getDevice("11:22:33:44:55:66", function(device) { console.log("Is trusted: " + (device.isTrusted ? "Yes" : "No")); });
-
readonly
boolean isConnectedThe flag indicating whether the connection state of this remote device with the local device.
Since: 1.0
Code example:
var adapter = tizen.bluetooth.getDefaultAdapter(); adapter.getDevice("11:22:33:44:55:66", function(device) { console.log("Is connected: " + (device.isConnected ? "Yes" : "No")); });
-
readonly
BluetoothUUID[]
uuidsThe list of 128-bit service UUIDs available on this remote device.
Since: 1.0
Code example:
var adapter = tizen.bluetooth.getDefaultAdapter(); var CHAT_SERVICE_UUID = "5BCE9431-6C75-32AB-AFE0-2EC108A30860"; adapter.getDevice("11:22:33:44:55:66", function(device) { var uuids = device.uuids; var services = ""; for (var i = 0; i < uuids.length; i++) { services += uuids[i] + "\n"; } console.log("Services found: " + services); if (uuids.indexOf(CHAT_SERVICE_UUID) != -1) { /* Connects to service. */ device.connectToServiceByUUID(CHAT_SERVICE_UUID, function(socket) { /* Connected to service, handle socket. */ }, function(e) { console.log("Could not connect to chat service !!!. Error: " + e.message); }); } });
Methods
-
connectToServiceByUUID
-
Connects to a specified service identified by uuid on this remote device.
void connectToServiceByUUID(BluetoothUUID uuid, BluetoothSocketSuccessCallback successCallback, optional ErrorCallback? errorCallback);
Since: 1.0
If opening a connection is successful, then a BluetoothSocket object with open state is sent using successCallback, through which data can be exchanged by both devices.
The ErrorCallback is launched with these error types:
- NotFoundError - If there is no service with the specified uuid
- InvalidValuesError - If any of the input parameters contain an invalid value
- UnknownError - If any other error occurs
Privilege level: public
Privilege: http://tizen.org/privilege/bluetooth
Warning: http://tizen.org/privilege/bluetooth.spp (public level) has been deprecated since 2.4. Instead, use http://tizen.org/privilege/bluetooth.
Parameters:
- uuid: 128-bit unique identifier, which specifies the service on the remote device.
- successCallback: Callback function that is called when an asynchronous call completes successfully.
- errorCallback [optional] [nullable]: Callback function that is called when opening of a socket fails.
Exceptions:
- WebAPIException
with error type TypeMismatchError, if the input parameter is not compatible with the expected type for that parameter
with error type SecurityError, if the application does not have the privilege to call this method.
Code example:
var adapter = tizen.bluetooth.getDefaultAdapter(); /* Purpose of code below is to enable Bluetooth on the device. */ var bluetoothSwitchAppControl = new tizen.ApplicationControl( "http://tizen.org/appcontrol/operation/edit", null, "application/x-bluetooth-on-off"); function launchSuccess() { console.log("Bluetooth Settings application is successfully launched"); } function launchError(error) { alert("An error occurred: " + error.name + ". Please enable Bluetooth through the Settings application"); } var serviceReply = { /* Called when the launched application reports success. */ onsuccess: function(data) { if (adapter.powered) { console.log("Bluetooth is successfully turned on"); adapter.getDevice("35:F4:59:D1:7A:03", onDeviceReady, function(e) { console.log("Error: " + e.message); }); } else { console.log("Bluetooth is still switched off"); } }, /* Called when launched application reports failure. */ onfailure: function() { alert("Bluetooth Settings application reported failure"); } }; /* connectToServiceByUUID sample code. */ var clientSocket = null; /* Calls a method that is invoked when user wants to send a message to a remote device. */ function sendMessage(msg) { /* Validates socket state, if everything is ok. */ if (clientSocket != null && clientSocket.state == "OPEN") { /* Sends the message. */ clientSocket.writeData(msg); } } /* Calls a method that is invoked when a socket is open. */ function onSocketConnected(socket) { clientSocket = socket; console.log("Opening a socket successfully!!!"); socket.onmessage = function() { var data = socket.readData(); var recvmsg = ""; for (var i = 0; i < data.length; i++) { recvmsg += String.fromCharCode(data[i]); } console.log("server msg >> " + recvmsg); }; socket.onclose = function() { console.log("socket disconnected"); }; } function onDeviceReady(device) { /* Validates device and service uuid. */ if (device.uuids.indexOf("5BCE9431-6C75-32AB-AFE0-2EC108A30860") != -1) { /* Opens socket. */ device.connectToServiceByUUID( "5BCE9431-6C75-32AB-AFE0-2EC108A30860", onSocketConnected, function(e) { console.log("Error connecting to service. Reason: " + e.message); }); } else { console.log("Chat service is not supported by this device"); } } /* Execution. */ if (adapter.powered) { console.log("Bluetooth is already enabled"); adapter.getDevice("35:F4:59:D1:7A:03", onDeviceReady, function(e) { console.log("Error: " + e.message); }); } else { console.log("Try to launch the Bluetooth Settings application"); tizen.application.launchAppControl( bluetoothSwitchAppControl, null, launchSuccess, launchError, serviceReply); }
2.17. BluetoothLEDevice
[NoInterfaceObject] interface BluetoothLEDevice { readonly attribute BluetoothAddress address; readonly attribute DOMString? name; readonly attribute long? txpowerlevel; readonly attribute unsigned long? appearance; readonly attribute BluetoothUUID[]? uuids; readonly attribute BluetoothLESolicitationUUID[]? solicitationuuids; readonly attribute BluetoothLEServiceData[]? serviceData; readonly attribute BluetoothLEManufacturerData? manufacturerData; readonly attribute long rssi; void connect(optional SuccessCallback? successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); void disconnect(optional SuccessCallback? successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); BluetoothGATTService getService(BluetoothUUID uuid) raises(WebAPIException); BluetoothUUID[] getServiceAllUuids() raises(WebAPIException); long addConnectStateChangeListener(BluetoothLEConnectChangeCallback listener) raises(WebAPIException); void removeConnectStateChangeListener(long watchID); };
Since: 2.3.1
A BluetoothLEDevice object can be retrieved by using one of the following APIs:
- BluetoothLEAdapter.startScan()
Attributes
-
readonly
BluetoothAddress addressThe address of the Bluetooth LE device from the scan result information.
Since: 2.3.1
Code example:
var adapter = tizen.bluetooth.getLEAdapter(); adapter.startScan(function onsuccess(device) { console.log("Found device: " + device.address); });
-
readonly
DOMString name [nullable]The name of the Bluetooth LE device from the scan result information.
Since: 2.3.1
Code example:
var adapter = tizen.bluetooth.getLEAdapter(); adapter.startScan(function onsuccess(device) { console.log("Found device: " + device.name); });
-
readonly
long txpowerlevel [nullable]The transmission power level of the Bluetooth LE device from the scan result information.
It represents the current transmit power level in dBm, and the level ranges from -100 dBm to +20 dBm to a resolution of 1 dBm.
Since: 2.3.1
Code example:
var adapter = tizen.bluetooth.getLEAdapter(); adapter.startScan(function onsuccess(device) { console.log("Found device: " + device.txpowerlevel); });
-
readonly
unsigned long appearance [nullable]The appearance of the Bluetooth LE device from the scan result information.
Since: 2.3.1
Code example:
var adapter = tizen.bluetooth.getLEAdapter(); adapter.startScan(function onsuccess(device) { console.log("Found device: " + device.appearance); });
-
readonly
BluetoothUUID[]
uuids [nullable]The list of service UUIDs from scan result.
Since: 2.3.1
Code example:
var adapter = tizen.bluetooth.getLEAdapter(); adapter.startScan(function onsuccess(device) { var uuids = device.uuids; var services = ""; for (var i = 0; i < uuids.length; i++) { services += uuids[i] + "\n"; } console.log("Service found: " + services); });
-
readonly
BluetoothLESolicitationUUID[]
solicitationuuids [nullable]The list of service solicitation UUIDs available on Bluetooth LE device from the scan result information.
Since: 2.3.1
Code example:
var adapter = tizen.bluetooth.getLEAdapter(); adapter.startScan(function onsuccess(device) { var uuids = device.solicitationuuids; var services = ""; for (var i = 0; i < uuids.length; i++) { services += uuids[i] + "\n"; } console.log("Service solicitations found: " + services); });
-
readonly
BluetoothLEServiceData[]
serviceData [nullable]The list of service data available on Bluetooth LE device from the scan result information.
Since: 2.3.1
Remark: Service data is found only when its BluetoothLEServiceData::uuid is 16-bit.
Code example:
var adapter = tizen.bluetooth.getLEAdapter(); adapter.startScan(function onsuccess(device) { var serviceData = device.serviceData; var data = ""; for (var i = 0; i < serviceData.length; i++) { data += serviceData[i].id + serviceData[i].data + "\n"; } console.log("Service data found: " + data); });
-
readonly
BluetoothLEManufacturerData manufacturerData [nullable]The manufacturer data from the scan result information.
Since: 2.3.1
Code example:
var adapter = tizen.bluetooth.getLEAdapter(); /* On an advertising device:. */ var advertiseOptions = { manufacturerData: new tizen.BluetoothLEManufacturerData("127", "0xDeadc0dE") }; var advertiseData = new tizen.BluetoothLEAdvertiseData(advertiseOptions); adapter.startAdvertise(advertiseData, "ADVERTISE", function onstate(state) { console.log("Advertiser state: " + state); }, function(e) { console.log("Failed to startAdvertise : " + e.message); }, "LOW_LATENCY"); /* On scanning device:. */ adapter.startScan(function onsuccess(device) { var manufacturerData = device.manufacturerData; console.log("Found device, manufacturerData: " + JSON.stringify(device.manufacturerData)); });
Output example:
Advertiser state: STARTED Found device, manufacturerData: {"id":"127","data":"DEADC0DE"}
-
readonly
long rssiThe received signal strength indicator in dBm (decibel-milliwatts) units.
The signal strength depends on distance (between the device and the beacon) and broadcasting power value.
Since: 3.0
Code example:
var adapter = tizen.bluetooth.getLEAdapter(); adapter.startScan(function onsuccess(device) { console.log("Found device: " + device.name); console.log("RSSI: " + device.rssi); });
Output example:
Found device: beacon RSSI: -25
Methods
-
connect
-
Establishes Low Energy connection to the device.
void connect(optional SuccessCallback? successCallback, optional ErrorCallback? errorCallback);
Since: 2.3.1
Connection is required to readValue() and writeValue() from the remote device.
The ErrorCallback is launched with these error types:
- UnknownError - If any other error occurs
Privilege level: public
Privilege: http://tizen.org/privilege/bluetooth
Warning: http://tizen.org/privilege/bluetooth.admin (public level) has been deprecated since 2.4. Instead, use http://tizen.org/privilege/bluetooth.
Remark: Establishing a connection can make device's Bluetooth stack busy. With the result, some of the operations, such as BluetoothLEAdapter::stopScan() can fail until connect()'s callback such as successCallback() or errorCallback() is triggered.
Parameters:
- successCallback [optional] [nullable]: Callback function that is called when the connection is established successfully.
- errorCallback [optional] [nullable]: Callback function that is called in case of failure.
Exceptions:
- WebAPIException
with error type TypeMismatchError, if the input parameter is not compatible with the expected type for that parameter.
with error type SecurityError, if the application does not have the privilege to call this method.
Code example:
function onerror(e) { console.log("Failed to connect to device: " + e.message); } function onconnected() { console.log("Connected to device"); } var adapter = tizen.bluetooth.getLEAdapter(); adapter.startScan(function onsuccess(device) { if (device.address == "11:22:33:44:55:66") { console.log("Found device: " + device.name); device.connect(onconnected, onerror); } });
-
disconnect
-
Disconnects from the device.
void disconnect(optional SuccessCallback? successCallback, optional ErrorCallback? errorCallback);
Since: 2.3.1
The ErrorCallback is launched with these error types:
- UnknownError - If any other error occurs
Privilege level: public
Privilege: http://tizen.org/privilege/bluetooth
Warning: http://tizen.org/privilege/bluetooth.admin (public level) has been deprecated since 2.4. Instead, use http://tizen.org/privilege/bluetooth.
Parameters:
- successCallback [optional] [nullable]: Callback function that is called when the connection is finished successfully.
- errorCallback [optional] [nullable]: Callback function that is called in case of failure.
Exceptions:
- WebAPIException
with error type TypeMismatchError, if the input parameter is not compatible with the expected type for that parameter.
with error type InvalidStateError, if device is currently not connected
with error type SecurityError, if the application does not have the privilege to call this method.
Code example:
function onerror(e) { console.log("Error occurred: " + e.message); } function onDeviceFound(device) { function ondisconnect() { console.log("Disconnected"); } function onconnected() { console.log("Connected to device"); device.disconnect(ondisconnect, onerror); } if (device.address == "11:22:33:44:55:66") { console.log("Found device: " + device.name); device.connect(onconnected, onerror); } } var adapter = tizen.bluetooth.getLEAdapter(); adapter.startScan(onDeviceFound, onerror);
-
getService
-
Retrieves a service from the device for the given UUID.
BluetoothGATTService getService(BluetoothUUID uuid);
Since: 2.3.1
Privilege level: public
Privilege: http://tizen.org/privilege/bluetooth
Warning: http://tizen.org/privilege/bluetooth.admin (public level) has been deprecated since 2.4. Instead, use http://tizen.org/privilege/bluetooth.
Parameters:
- uuid: UUID of the service.
Return value:
-
BluetoothGATTService:
Retrieved service for the given UUID.
Exceptions:
- WebAPIException
with error type NotFoundError, if there is no service with the given UUID.
with error type SecurityError, if the application does not have the privilege to call this method.
with error type InvalidStateError, if the GATT service is not available.
with error type UnknownError, if any other error occurs.
Code example:
function onconnected(device) { console.log("Connected to device"); var service = device.getService(device.uuids[0]); console.log("Service got"); } function onerror(e) { console.log("Error occurred: " + e.message); } function onDeviceFound(device) { if (device.address == "11:22:33:44:55:66") { console.log("Found device: " + device.name); device.connect(onconnected.bind(null, device), onerror); } } var adapter = tizen.bluetooth.getLEAdapter(); adapter.startScan(onDeviceFound, onerror);
-
getServiceAllUuids
-
Retrieves list of all service UUIDs from connected GATT server.
BluetoothUUID[] getServiceAllUuids();
Since: 3.0
Privilege level: public
Privilege: http://tizen.org/privilege/bluetooth
Return value:
-
BluetoothUUID[]:
The array of all service UUIDs that belong to the connected GATT server.
Exceptions:
- WebAPIException
with error type InvalidValuesError, if GATT server is not available.
with error type NotSupportedError, if the feature is not supported.
with error type SecurityError, if the application does not have the privilege to call this method.
Code example:
/* Below variable should represent valid address of discoverable bluetooth low energy device. */ var remoteAddress = "11:22:33:44:55:66"; function onconnected(device) { console.log("Connected to device"); var services = device.getServiceAllUuids(); console.log("Services length " + services.length); } function onerror(e) { console.log("Error occurred: " + e.message); } function onDeviceFound(device) { if (device.address == remoteAddress) { device.connect(onconnected.bind(null, device), onerror); } } var adapter = tizen.bluetooth.getLEAdapter(); adapter.startScan(onDeviceFound, onerror);
Output example:
Connected to device Services length 2
- WebAPIException
-
addConnectStateChangeListener
-
Registers a listener to be called when the device connects or disconnects.
long addConnectStateChangeListener(BluetoothLEConnectChangeCallback listener);
Since: 2.3.1
Parameters:
- listener: Listener functions that are called when the connection state changes.
Return value:
-
long:
The watchID to be used to unregister the listener.
Exceptions:
- WebAPIException
with error type TypeMismatchError, if the input parameter is not compatible with the expected type for that parameter.
Code example:
function onerror(e) { console.log("Error occurred: " + e.message); } function onDeviceFound(device) { var onConnectionStateChange = { onconnected: function(device) { console.log("Device " + device.name + " connected"); }, ondisconnected: function(device) { console.log("Device " + device.name + " disconnected"); } }; if (device.address === "11:22:33:44:55:66") { console.log("Found device: " + device.name); device.addConnectStateChangeListener(onConnectionStateChange); device.connect(); } } var adapter = tizen.bluetooth.getLEAdapter(); adapter.startScan(onDeviceFound, onerror);
-
removeConnectStateChangeListener
-
Unregisters a Bluetooth device connection listener.
void removeConnectStateChangeListener(long watchID);
Since: 2.3.1
Calling this function has no effect if there is no listener with given id.
Parameters:
- watchID: The watchID identifier returned by the addConnectStateChangeListener() method.
Code example:
function onerror(e) { console.log("Error occurred: " + e.message); } function onDeviceFound(device) { var onConnectionStateChange = { onconnected: function(device) { console.log("Device " + device.name + " connected"); }, ondisconnected: function(device) { console.log("Device " + device.name + " disconnected"); device.removeConnectStateChangeListener(listenerID); } }; if (device.address === "11:22:33:44:55:66") { console.log("Found device: " + device.name); listenerID = device.addConnectStateChangeListener(onConnectionStateChange); device.connect(); } } var adapter = tizen.bluetooth.getLEAdapter(); var listenerID = null; adapter.startScan(onDeviceFound, onerror);
2.18. BluetoothSocket
[NoInterfaceObject] interface BluetoothSocket { readonly attribute BluetoothUUID uuid; readonly attribute BluetoothSocketState state; readonly attribute BluetoothDevice peer; [TreatNonCallableAsNull] attribute SuccessCallback? onmessage raises(WebAPIException); [TreatNonCallableAsNull] attribute SuccessCallback? onclose raises(WebAPIException); unsigned long writeData(byte[] data) raises(WebAPIException); byte[] readData() raises(WebAPIException); void close() raises(WebAPIException); };
Since: 1.0
The socket object is created by BluetoothDevice.connectToServiceByUUID() or BluetoothAdapter.registerRFCOMMServiceByUUID().
Attributes
-
readonly
BluetoothUUID uuidThe service UUID to which this socket is connected.
Since: 1.0
-
readonly
BluetoothSocketState stateThe socket state.
Since: 1.0
-
readonly
BluetoothDevice peerThe peer device to which this socket is connected.
Since: 1.0
-
SuccessCallback onmessage [nullable]Called when an incoming message is received successfully from the peer. By default, this attribute is set to null.
Since: 1.0
Exceptions:
- WebAPIException
with error type TypeMismatchError, if any input attribute is not compatible with the expected type for this attribute.
- WebAPIException
-
SuccessCallback onclose [nullable]Called when the socket is closed successfully. By default, this attribute is set to null.
Since: 1.0
Exceptions:
- WebAPIException
with error type TypeMismatchError, if any input attribute is not compatible with the expected type for this attribute.
- WebAPIException
Methods
-
writeData
-
Writes data as a sequence of bytes onto the socket and returns the number of bytes actually written.
unsigned long writeData(byte[] data);
Since: 1.0
Privilege level: public
Privilege: http://tizen.org/privilege/bluetooth
Warning: http://tizen.org/privilege/bluetooth.spp (public level) has been deprecated since 2.4. Instead, use http://tizen.org/privilege/bluetooth.
Parameters:
- data: The data to send.
Return value:
-
unsigned long:
The number of bytes actually sent.
Exceptions:
- WebAPIException
with error type TypeMismatchError, if any input parameters in not compatible with the expected type for that parameter.
with error type SecurityError, if the application does not have the privilege to call this method.
with error type UnknownError, if any other error occurs.
Code example:
var adapter = tizen.bluetooth.getDefaultAdapter(); /* Purpose of code below is to enable Bluetooth on the device. */ var bluetoothSwitchAppControl = new tizen.ApplicationControl( "http://tizen.org/appcontrol/operation/edit", null, "application/x-bluetooth-on-off"); function launchSuccess() { console.log("Bluetooth Settings application is successfully launched"); } function launchError(error) { alert("An error occurred: " + error.name + ". Please enable Bluetooth through the Settings application"); } var serviceReply = { /* Called when the launched application reports success. */ onsuccess: function(data) { if (adapter.powered) { console.log("Bluetooth is successfully turned on"); adapter.getDevice("35:F4:59:D1:7A:03", onDeviceReady, function(e) { console.log("Error: " + e.message); }); } else { console.log("Bluetooth is still switched off"); } }, /* Called when launched application reports failure. */ onfailure: function() { alert("Bluetooth Settings application reported failure"); } }; /* writeData sample code. */ function onSocketConnected(socket) { console.log("Opened connection to remote device"); socket.onmessage = function() { console.log("Message received: " + socket.readData()); }; socket.onclose = function() { console.log("Socket closed with " + socket.peer.name); }; /* Sends data to peer. */ var textmsg = "Test"; var sendtextmsg = new Array(); for (var i = 0; i < textmsg.length; i++) { sendtextmsg[i] = textmsg.charCodeAt(i); } socket.writeData(sendtextmsg); } function onSocketError(e) { console.log("Error connecting to service. Reason: " + e.message); } function onDeviceReady(device) { /* Validates device and service uuid. */ if (device.uuids.indexOf("5BCE9431-6C75-32AB-AFE0-2EC108A30860") != -1) { /* Opens socket. */ device.connectToServiceByUUID( "5BCE9431-6C75-32AB-AFE0-2EC108A30860", onSocketConnected, onSocketError); } } /* Execution. */ if (adapter.powered) { console.log("Bluetooth is already enabled"); adapter.getDevice("35:F4:59:D1:7A:03", onDeviceReady, function(e) { console.log("Error: " + e.message); }); } else { console.log("Try to launch the Bluetooth Settings application"); tizen.application.launchAppControl( bluetoothSwitchAppControl, null, launchSuccess, launchError, serviceReply); }
-
readData
-
Reads data from the socket.
byte[] readData();
Since: 1.0
This method should be called only in the BluetoothSocket.onmessage handler, that is, when data is ready on the socket.
Privilege level: public
Privilege: http://tizen.org/privilege/bluetooth
Warning: http://tizen.org/privilege/bluetooth.spp (public level) has been deprecated since 2.4. Instead, use http://tizen.org/privilege/bluetooth.
Return value:
-
byte[]:
The sequence of bytes successfully read.
Exceptions:
- WebAPIException
with error type SecurityError, if the application does not have the privilege to call this method.
with error type UnknownError, if any other error occurs.
Code example:
var adapter = tizen.bluetooth.getDefaultAdapter(); /* Purpose of code below is to enable Bluetooth on the device. */ var bluetoothSwitchAppControl = new tizen.ApplicationControl( "http://tizen.org/appcontrol/operation/edit", null, "application/x-bluetooth-on-off"); function launchSuccess() { console.log("Bluetooth Settings application is successfully launched"); } function launchError(error) { alert("An error occurred: " + error.name + ". Please enable Bluetooth through the Settings application"); } var serviceReply = { /* Called when the launched application reports success. */ onsuccess: function(data) { if (adapter.powered) { console.log("Bluetooth is successfully turned on"); adapter.getDevice("35:F4:59:D1:7A:03", onDeviceReady, function(e) { console.log("Error: " + e.message); }); } else { console.log("Bluetooth is still switched off"); } }, /* Called when launched application reports failure. */ onfailure: function() { alert("Bluetooth Settings application reported failure"); } }; /* readData sample code. */ function onError(e) { console.log("Error connecting to service. Reason: " + e.message); } function onSocketConnected(socket) { console.log("Opening socket success!!!"); socket.onmessage = function() { /* Gets a message from peer, reads it. */ var data = socket.readData(); /* Code to evaluate message goes here. */ }; socket.onclose = function() { console.log("Socket closed with " + socket.peer.name); }; } function onDeviceReady(device) { /* Validates device and service uuid. */ if (device.uuids.indexOf("5BCE9431-6C75-32AB-AFE0-2EC108A30860") != -1) { /* Opens socket. */ device.connectToServiceByUUID( "5BCE9431-6C75-32AB-AFE0-2EC108A30860", onSocketConnected, onError); } } /* Execution. */ if (adapter.powered) { console.log("Bluetooth is already enabled"); adapter.getDevice("35:F4:59:D1:7A:03", onDeviceReady, function(e) { console.log("Error: " + e.message); }); } else { console.log("Try to launch the Bluetooth Settings application"); tizen.application.launchAppControl( bluetoothSwitchAppControl, null, launchSuccess, launchError, serviceReply); }
- WebAPIException
-
close
-
Closes the socket.
void close();
Since: 1.0
BluetoothSocket.state changes to CLOSED, and BluetoothSocket.onclose() is invoked on success.
Privilege level: public
Privilege: http://tizen.org/privilege/bluetooth
Warning: http://tizen.org/privilege/bluetooth.spp (public level) has been deprecated since 2.4. Instead, use http://tizen.org/privilege/bluetooth.
Exceptions:
- WebAPIException
with error type SecurityError, if the application does not have the privilege to call this method.
with error type UnknownError, if any other error occurs.
Code example:
var adapter = tizen.bluetooth.getDefaultAdapter(); /* Purpose of code below is to enable Bluetooth on the device. */ var bluetoothSwitchAppControl = new tizen.ApplicationControl( "http://tizen.org/appcontrol/operation/edit", null, "application/x-bluetooth-on-off"); function launchSuccess() { console.log("Bluetooth Settings application is successfully launched"); } function launchError(error) { alert("An error occurred: " + error.name + ". Please enable Bluetooth through the Settings application"); } var serviceReply = { /* Called when the launched application reports success. */ onsuccess: function(data) { if (adapter.powered) { console.log("Bluetooth is successfully turned on"); startDiscovery(); } else { console.log("Bluetooth is still switched off"); } }, /* Called when launched application reports failure. */ onfailure: function() { alert("Bluetooth Settings application reported failure"); } }; function onSocketConnected(socket) { console.log("Opened connection to remote device " + socket.peer.name); socket.onclose = function() { console.log("Socket closed with " + socket.peer.name); }; socket.close(); } function onSocketError(e) { console.log("Error connecting to service. Reason: " + e.message); } function onDeviceReady(device) { /* Validates device and service uuid. */ if (device.uuids.indexOf("5BCE9431-6C75-32AB-AFE0-2EC108A30860") != -1) { device.connectToServiceByUUID( "5BCE9431-6C75-32AB-AFE0-2EC108A30860", onSocketConnected, onSocketError); } } if (adapter.powered) { /* Gets the BluetoothDevice object. */ adapter.getDevice("35:F4:59:D1:7A:03", onDeviceReady, function(e) { console.log("Error: " + e.message); }); } else { console.log("Try to launch the Bluetooth Settings application"); tizen.application.launchAppControl( bluetoothSwitchAppControl, null, launchSuccess, launchError, serviceReply); }
- WebAPIException
2.19. BluetoothClass
[NoInterfaceObject] interface BluetoothClass { readonly attribute octet major; readonly attribute octet minor; readonly attribute unsigned short[] services; boolean hasService(unsigned short service) raises(WebAPIException); };
Since: 1.0
Bluetooth device class describes the characteristics and capabilities of a device.
Bluetooth CoD is a 24-bit integer created by the union of three components:
- Exactly one Major Device Class (bits 8-12 of CoD) - This is the highest level of granularity for defining a Bluetooth Device.
- Exactly one Minor Device Class (bits 2-7 of CoD) - This is to be interpreted only in the context of the Major Device Class. Thus, the meaning of these bits may change, depending on the value of "Major Device Class".
- Zero or more Major Service Classes (bits 13-23) - Represents the services supported by the device.
The Major and Minor classes are intended to define a general family of devices with which any particular implementation wishes to be associated. No assumptions should be made about specific functionality or characteristics of any application, based solely on the assignment of a Major or minor device class.
Attributes
-
readonly
octet majorThe major device class.
The BluetoothClassDeviceMajor interface contains the list of known values.
Since: 1.0
Code example:
var adapter = tizen.bluetooth.getDefaultAdapter(); function evaluateDevice(address) { adapter.getDevice(address, function(device) { if (device.deviceClass.major == tizen.bluetooth.deviceMajor.COMPUTER) { /* Shows computer icon for this device. */ console.log("Device is computer"); } else if (device.deviceClass.major == tizen.bluetooth.deviceMajor.PHONE) { /* Shows phone icon. */ console.log("Device is a Phone"); } }, function(e) { console.log("Couldn't get any device with the given address: " + e.message); }); } evaluateDevice("11:22:33:44:55:66");
-
readonly
octet minorThe minor device class.
The BluetoothClassDeviceMinor interface contains the list of known values.
Since: 1.0
-
readonly
unsigned short[]
servicesThe services provided by this device and it refers to the BluetoothClassDeviceService interface for the list of possible values.
Since: 1.0
Methods
-
hasService
-
Checks whether the given service exists in the services.
boolean hasService(unsigned short service);
Since: 1.0
Privilege level: public
Privilege: http://tizen.org/privilege/bluetooth
Warning: http://tizen.org/privilege/bluetooth.gap (public level) has been deprecated since 2.4. Instead, use http://tizen.org/privilege/bluetooth.
Parameters:
- service: Service to check.
Return value:
-
boolean:
true, if given service exists in the services.
Exceptions:
- WebAPIException
with error type InvalidValuesError, if any of the input parameters contain an invalid value.
with error type SecurityError, if the application does not have the privilege to call this method.
with error type UnknownError, if any other error occurs.
Code example:
var adapter = tizen.bluetooth.getDefaultAdapter(); adapter.getDevice("12:34:56:78:9A:BC", function(device) { if (device.deviceClass.hasService(tizen.bluetooth.deviceService.POSITIONING)) { console.log("Device supports Positioning service"); } }, function(e) { console.log("Couldn't get device for given address: " + e.message); });
2.20. BluetoothClassDeviceMajor
[NoInterfaceObject] interface BluetoothClassDeviceMajor { const octet MISC = 0x00; const octet COMPUTER = 0x01; const octet PHONE = 0x02; const octet NETWORK = 0x03; const octet AUDIO_VIDEO = 0x04; const octet PERIPHERAL = 0x05; const octet IMAGING = 0x06; const octet WEARABLE = 0x07; const octet TOY = 0x08; const octet HEALTH = 0x09; const octet UNCATEGORIZED = 0x1F; };
Since: 1.0
2.21. BluetoothClassDeviceMinor
[NoInterfaceObject] interface BluetoothClassDeviceMinor { const octet COMPUTER_UNCATEGORIZED = 0x00; const octet COMPUTER_DESKTOP = 0x01; const octet COMPUTER_SERVER = 0x02; const octet COMPUTER_LAPTOP = 0x03; const octet COMPUTER_HANDHELD_PC_OR_PDA = 0x04; const octet COMPUTER_PALM_PC_OR_PDA = 0x05; const octet COMPUTER_WEARABLE = 0x06; const octet PHONE_UNCATEGORIZED = 0x00; const octet PHONE_CELLULAR = 0x01; const octet PHONE_CORDLESS = 0x02; const octet PHONE_SMARTPHONE = 0x03; const octet PHONE_MODEM_OR_GATEWAY = 0x04; const octet PHONE_ISDN = 0x05; const octet AV_UNRECOGNIZED = 0x00; const octet AV_WEARABLE_HEADSET = 0x01; const octet AV_HANDSFREE = 0x02; const octet AV_MICROPHONE = 0x04; const octet AV_LOUDSPEAKER = 0x05; const octet AV_HEADPHONES = 0x06; const octet AV_PORTABLE_AUDIO = 0x07; const octet AV_CAR_AUDIO = 0x08; const octet AV_SETTOP_BOX = 0x09; const octet AV_HIFI = 0x0a; const octet AV_VCR = 0x0b; const octet AV_VIDEO_CAMERA = 0x0c; const octet AV_CAMCORDER = 0x0d; const octet AV_MONITOR = 0x0e; const octet AV_DISPLAY_AND_LOUDSPEAKER = 0x0f; const octet AV_VIDEO_CONFERENCING = 0x10; const octet AV_GAMING_TOY = 0x12; const octet PERIPHERAL_UNCATEGORIZED = 0; const octet PERIPHERAL_KEYBOARD = 0x10; const octet PERIPHERAL_POINTING_DEVICE = 0x20; const octet PERIPHERAL_KEYBOARD_AND_POINTING_DEVICE = 0x30; const octet PERIPHERAL_JOYSTICK = 0x01; const octet PERIPHERAL_GAMEPAD = 0x02; const octet PERIPHERAL_REMOTE_CONTROL = 0x03; const octet PERIPHERAL_SENSING_DEVICE = 0x04; const octet PERIPHERAL_DEGITIZER_TABLET = 0x05; const octet PERIPHERAL_CARD_READER = 0x06; const octet PERIPHERAL_DIGITAL_PEN = 0x07; const octet PERIPHERAL_HANDHELD_SCANNER = 0x08; const octet PERIPHERAL_HANDHELD_INPUT_DEVICE = 0x09; const octet IMAGING_UNCATEGORIZED = 0x00; const octet IMAGING_DISPLAY = 0x04; const octet IMAGING_CAMERA = 0x08; const octet IMAGING_SCANNER = 0x10; const octet IMAGING_PRINTER = 0x20; const octet WEARABLE_WRITST_WATCH = 0x01; const octet WEARABLE_PAGER = 0x02; const octet WEARABLE_JACKET = 0x03; const octet WEARABLE_HELMET = 0x04; const octet WEARABLE_GLASSES = 0x05; const octet TOY_ROBOT = 0x01; const octet TOY_VEHICLE = 0x02; const octet TOY_DOLL = 0x03; const octet TOY_CONTROLLER = 0x04; const octet TOY_GAME = 0x05; const octet HEALTH_UNDEFINED = 0x00; const octet HEALTH_BLOOD_PRESSURE_MONITOR = 0x01; const octet HEALTH_THERMOMETER = 0x02; const octet HEALTH_WEIGHING_SCALE = 0x03; const octet HEALTH_GLUCOSE_METER = 0x04; const octet HEALTH_PULSE_OXIMETER = 0x05; const octet HEALTH_PULSE_RATE_MONITOR = 0x06; const octet HEALTH_DATA_DISPLAY = 0x07; const octet HEALTH_STEP_COUNTER = 0x08; const octet HEALTH_BODY_COMPOSITION_ANALYZER = 0x09; const octet HEALTH_PEAK_FLOW_MONITOR = 0x0a; const octet HEALTH_MEDICATION_MONITOR = 0x0b; const octet HEALTH_KNEE_PROSTHESIS = 0x0c; const octet HEALTH_ANKLE_PROSTHESIS = 0x0d; };
Since: 1.0
2.22. BluetoothClassDeviceService
[NoInterfaceObject] interface BluetoothClassDeviceService { const unsigned short LIMITED_DISCOVERABILITY = 0x0001; const unsigned short POSITIONING = 0x0008; const unsigned short NETWORKING = 0x0010; const unsigned short RENDERING = 0x0020; const unsigned short CAPTURING = 0x0040; const unsigned short OBJECT_TRANSFER = 0x0080; const unsigned short AUDIO = 0x0100; const unsigned short TELEPHONY = 0x0200; const unsigned short INFORMATION = 0x0400; };
Since: 1.0
2.23. BluetoothServiceHandler
[NoInterfaceObject] interface BluetoothServiceHandler { readonly attribute BluetoothUUID uuid; readonly attribute DOMString name; readonly attribute boolean isConnected; [TreatNonCallableAsNull] attribute BluetoothSocketSuccessCallback? onconnect raises(WebAPIException); void unregister(optional SuccessCallback? successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); };
Since: 1.0
Attributes
-
readonly
BluetoothUUID uuidThe UUID of the service. See example.
Since: 1.0
-
readonly
DOMString nameThe name of the service. See example.
Since: 1.0
-
readonly
boolean isConnectedThe flag indicating whether any remote devices is using this service. See example.
Since: 1.0
-
BluetoothSocketSuccessCallback onconnect [nullable]Called when a remote device is connected successfully to this service. By default, this attribute is set to null.
Since: 1.0
Exceptions:
- WebAPIException
with error type TypeMismatchError, if any input attribute is not compatible with the expected type for this attribute.
Code example:
var adapter = tizen.bluetooth.getDefaultAdapter(); function chatServiceSuccessCb(handler) { console.log("Chat service " + handler.name + " with UUID " + handler.uuid + " is successfully registered!"); console.log("There is " + (handler.isConnected ? "a" : "no") + " device using this service"); handler.onconnect = function(socket) { console.log("Client is connected: " + socket.peer.name + "," + socket.peer.address); socket.onmessage = function() { var data = socket.readData(); /* Handle message code goes here. */ }; /* Expected close. */ socket.onclose = function() { console.log("The socket is closed"); }; }; } function errorCb(e) { console.log("Could not register service record, Error: " + e.message); } var CHAT_SERVICE_UUID = "5BCE9431-6C75-32AB-AFE0-2EC108A30860"; adapter.registerRFCOMMServiceByUUID( CHAT_SERVICE_UUID, "Chat service", chatServiceSuccessCb, errorCb);
- WebAPIException
Methods
-
unregister
-
Unregisters a service record from the Bluetooth services record database and stops listening for new connections to this service.
void unregister(optional SuccessCallback? successCallback, optional ErrorCallback? errorCallback);
Since: 1.0
The ErrorCallback is launched with these error types:
- UnknownError - If any other error occurs
Privilege level: public
Privilege: http://tizen.org/privilege/bluetooth
Warning: http://tizen.org/privilege/bluetooth.spp (public level) has been deprecated since 2.4. Instead, use http://tizen.org/privilege/bluetooth.
Parameters:
- successCallback [optional] [nullable]: Callback function that is called when the record is removed successfully from the service records database.
- errorCallback [optional] [nullable]: Callback function that is called in case of failure (to unregister).
Exceptions:
- WebAPIException
with error type TypeMismatchError, if the input parameter is not compatible with the expected type for that parameter.
with error type SecurityError, if the application does not have the privilege to call this method.
Code example:
var adapter = tizen.bluetooth.getDefaultAdapter(); var chatServiceHandler = null; function chatServiceSuccessCb(handler) { console.log("Chat service registration was successful!"); chatServiceHandler = handler; handler.onconnect = function(socket) { console.log("Client is connected: " + socket.peer.name + "," + socket.peer.address); socket.onmessage = function() { var data = socket.readData(); /* Handle message code goes here. */ }; /* Expected close. */ socket.onclose = function() { console.log("The socket is closed"); }; }; } function publishChatService() { var CHAT_SERVICE_UUID = "5BCE9431-6C75-32AB-AFE0-2EC108A30860"; adapter.registerRFCOMMServiceByUUID(CHAT_SERVICE_UUID, "Chat service", chatServiceSuccessCb, /* Error handler. */ function(e) { console.log("Could not register service record, Error: " + e.message); }); } function unRegisterChatService() { if (chatServiceHandler != null) { chatServiceHandler.unregister( function() { chatServiceHandler = null; console.log("Chat service is unregistered"); }, function(e) { console.log("Error: " + e.message); }); } }
2.24. BluetoothProfileHandler
[NoInterfaceObject] interface BluetoothProfileHandler { readonly attribute BluetoothProfileType profileType; };
Since: 2.2
Attributes
-
readonly
BluetoothProfileType profileTypeThe Bluetooth profile type.
Since: 2.2
Code example:
var adapter = tizen.bluetooth.getDefaultAdapter(); var healthCapability = tizen.systeminfo.getCapability("http://tizen.org/feature/network.bluetooth.health"); if (healthCapability) { var healthProfileHandler = adapter.getBluetoothProfileHandler("HEALTH"); console.log("Bluetooth profile type is " + healthProfileHandler.profileType); } else { console.log("Bluetooth Health Profile is not supported on this device"); }
2.25. BluetoothHealthProfileHandler
[NoInterfaceObject] interface BluetoothHealthProfileHandler : BluetoothProfileHandler { void registerSinkApplication(unsigned short dataType, DOMString name, BluetoothHealthApplicationSuccessCallback successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); void connectToSource(BluetoothDevice peer, BluetoothHealthApplication application, BluetoothHealthChannelSuccessCallback successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); };
Since: 2.2
Methods
-
registerSinkApplication
-
Registers an application for the Sink role.
void registerSinkApplication(unsigned short dataType, DOMString name, BluetoothHealthApplicationSuccessCallback successCallback, optional ErrorCallback? errorCallback);
Since: 2.2
The ErrorCallback is launched with these error types:
- ServiceNotAvailableError - If a Bluetooth device is turned off
- UnknownError - If any other error occurs
Privilege level: public
Privilege: http://tizen.org/privilege/bluetooth
Warning: http://tizen.org/privilege/bluetooth.health (public level) has been deprecated since 2.4. Instead, use http://tizen.org/privilege/bluetooth.
Parameters:
- dataType: MDEP data type used for communication, which is referenced in the ISO/IEEE 11073-20601 spec. For example, pulse oximeter is 4100 and blood pressure monitor is 4103.
- name: Friendly name associated with sink application.
- successCallback: Callback function that is called when a sink application is registered successfully.
- errorCallback [optional] [nullable]: Callback function that is called when an error occurs.
Exceptions:
- WebAPIException
with error type SecurityError, if the application does not have the privilege to call this method.
with error type TypeMismatchError, if any of the input parameter is not compatible with the expected type for that parameter.
Code example:
var adapter = tizen.bluetooth.getDefaultAdapter(); var healthProfileHandler = adapter.getBluetoothProfileHandler("HEALTH"); function healthRegisterSuccess(app) { console.log("Registered application: " + app.name); } function healthRegisterError(e) { console.log("Failed to register application: " + e.message); } healthProfileHandler.registerSinkApplication( 4100, "testSinkApp", healthRegisterSuccess, healthRegisterError);
-
connectToSource
-
Connects to the health device which acts as the Source role.
void connectToSource(BluetoothDevice peer, BluetoothHealthApplication application, BluetoothHealthChannelSuccessCallback successCallback, optional ErrorCallback? errorCallback);
Since: 2.2
The ErrorCallback is launched with these error types:
- ServiceNotAvailableError - If a Bluetooth device is turned off
- InvalidValuesError - If any of the input parameters contain an invalid value
- UnknownError - If any other error occurs
Privilege level: public
Privilege: http://tizen.org/privilege/bluetooth
Warning: http://tizen.org/privilege/bluetooth.health (public level) has been deprecated since 2.4. Instead, use http://tizen.org/privilege/bluetooth.
Parameters:
- peer: Remote device which acts as the Source role.
- application: Registered application for the Sink role.
- successCallback: Callback function that is called when a connection is established successfully.
- errorCallback [optional] [nullable]: Callback function that is called when an error occurs.
Exceptions:
- WebAPIException
with error type SecurityError, if the application does not have the privilege to call this method.
with error type TypeMismatchError, if any of the input parameter is not compatible with the expected type for that parameter.
Code example:
var adapter = tizen.bluetooth.getDefaultAdapter(); var healthProfileHandler = adapter.getBluetoothProfileHandler("HEALTH"); var registerHealthApp = null; function healthConnectSuccess(channel) { console.log("Health device is connected"); var status = "Name of remote device: " + channel.peer.name + "channel type of device profile: " + channel.channelType + "health application name: " + channel.application.name; console.log(status); } function healthConnectError(e) { console.log("Failed to connect to source: " + e.message); } function gotDeviceInfo(device) { healthProfileHandler.connectToSource( device, registerHealthApp, healthConnectSuccess, healthConnectError); } function healthRegisterSuccess(app) { console.log("Registered application: " + app.name); registerHealthApp = app; adapter.getDevice("35:F4:59:D1:7A:03", gotDeviceInfo); } function healthRegisterError(e) { console.log("Failed to register application: " + e.message); } healthProfileHandler.registerSinkApplication( 4100, "testSinkApp", healthRegisterSuccess, healthRegisterError);
2.26. BluetoothHealthApplication
[NoInterfaceObject] interface BluetoothHealthApplication { readonly attribute unsigned short dataType; readonly attribute DOMString name; [TreatNonCallableAsNull] attribute BluetoothHealthChannelSuccessCallback? onconnect raises(WebAPIException); void unregister(optional SuccessCallback? successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); };
Since: 2.2
Attributes
-
readonly
unsigned short dataTypeThe MDEP data type used for communication, which is referenced in the ISO/IEEE 11073-20601 spec.
For example, pulse oximeter is 4100 and blood pressure monitor is 4103. See example.
Since: 2.2
-
readonly
DOMString nameThe friendly name associated with sink application. See example.
Since: 2.2
-
BluetoothHealthChannelSuccessCallback onconnect [nullable]Called when a health device is connected successfully through this application.
By default, this attribute is set to null.
Since: 2.2
Exceptions:
- WebAPIException
with error type TypeMismatchError, if an input attribute is not compatible with the expected type for this attribute.
Code example:
var adapter = tizen.bluetooth.getDefaultAdapter(); var healthProfileHandler = adapter.getBluetoothProfileHandler("HEALTH"); function healthRegisterSuccess(app) { console.log("Registered application: " + app.name); console.log("Data type used for communication is " + app.dataType); app.onconnect = function(channel) { console.log("Health device is connected"); }; } function healthRegisterError(e) { console.log("Failed to register application: " + e.message); } healthProfileHandler.registerSinkApplication( 4100, "testSinkApp", healthRegisterSuccess, healthRegisterError);
- WebAPIException
Methods
-
unregister
-
Unregisters this application.
void unregister(optional SuccessCallback? successCallback, optional ErrorCallback? errorCallback);
Since: 2.2
The ErrorCallback is launched with these error types:
- ServiceNotAvailableError - If a Bluetooth device is turned off
- UnknownError - If any other error occurs
Privilege level: public
Privilege: http://tizen.org/privilege/bluetooth
Warning: http://tizen.org/privilege/bluetooth.health (public level) has been deprecated since 2.4. Instead, use http://tizen.org/privilege/bluetooth.
Parameters:
- successCallback [optional] [nullable]: Callback function that is called when a sink application is registered successfully.
- errorCallback [optional] [nullable]: Callback function that is called when an error occurs.
Exceptions:
- WebAPIException
with error type SecurityError, if the application does not have the privilege to call this method.
with error type TypeMismatchError, if any of the input parameter is not compatible with the expected type for that parameter.
Code example:
var adapter = tizen.bluetooth.getDefaultAdapter(); var healthProfileHandler = adapter.getBluetoothProfileHandler("HEALTH"); var healthApp = null; function healthRegisterSuccess(app) { console.log("Registered application: " + app.name); healthApp = app; healthApp.onconnect = function(channel) { console.log("Connected!!"); }; } function healthRegisterError(e) { console.log("Failed to register application: " + e.message); } function startSink() { try { healthProfileHandler.registerSinkApplication( 4100, "testSinkApp", healthRegisterSuccess, healthRegisterError); } catch (e) { console.log("Error: " + e.message); } } function stopSink() { try { if (healthApp != null) { healthApp.unregister( function() { healthApp = null; console.log("Health application is unregistered"); }, function(e) { console.log("Error: " + e.message); }); } } catch (err) { console.log("Error: " + err.message); } }
2.27. BluetoothHealthChannel
[NoInterfaceObject] interface BluetoothHealthChannel { readonly attribute BluetoothDevice peer; readonly attribute BluetoothHealthChannelType channelType; readonly attribute BluetoothHealthApplication application; readonly attribute boolean isConnected; void close() raises(WebAPIException); unsigned long sendData(byte[] data) raises(WebAPIException); void setListener(BluetoothHealthChannelChangeCallback listener) raises(WebAPIException); void unsetListener() raises(WebAPIException); };
Since: 2.2
Attributes
-
readonly
BluetoothDevice peerThe remote device to which this channel is connected. See example.
Since: 2.2
-
readonly
BluetoothHealthChannelType channelTypeThe type of this channel. See example.
Since: 2.2
-
readonly
BluetoothHealthApplication applicationThe health application which is used to communicate with the remote device. See example.
Since: 2.2
-
readonly
boolean isConnectedThe flag indicating whether any remote device is connected.
Since: 2.2
Code example:
var adapter = tizen.bluetooth.getDefaultAdapter(); var healthProfileHandler = adapter.getBluetoothProfileHandler("HEALTH"); function healthRegisterSuccess(app) { app.onconnect = function(channel) { console.log("Health device " + (channel.isConnected ? "is" : "is not") + " connected to " + channel.peer.name + " remote device"); console.log("Channel type is " + channel.channelType + " and health application name used for communication is " + channel.application.name); }; } function healthRegisterError(e) { console.log("Failed to register application: " + e.message); } healthProfileHandler.registerSinkApplication( 4100, "testSinkApp", healthRegisterSuccess, healthRegisterError);
Methods
-
close
-
Closes the connected channel. BluetoothHealthChannel.isConnected is changed to false and BluetoothHealthChannelChangeCallback.onclose is invoked when this channel is closed successfully.
void close();
Since: 2.2
Privilege level: public
Privilege: http://tizen.org/privilege/bluetooth
Warning: http://tizen.org/privilege/bluetooth.health (public level) has been deprecated since 2.4. Instead, use http://tizen.org/privilege/bluetooth.
Exceptions:
- WebAPIException
with error type SecurityError, if the application does not have the privilege to call this method.
with error type ServiceNotAvailableError, if a Bluetooth device is turned off.
with error type UnknownError, if any other error occurs.
Code example:
var adapter = tizen.bluetooth.getDefaultAdapter(); var healthProfileHandler = adapter.getBluetoothProfileHandler("HEALTH"); function healthRegisterSuccess(app) { console.log("Registered application: " + app.name); app.onconnect = function(channel) { console.log("Health device is connected"); channel.close(); }; } function healthRegisterError(e) { console.log("Failed to register application: " + e.message); } healthProfileHandler.registerSinkApplication( 4100, "testSinkApp", healthRegisterSuccess, healthRegisterError);
- WebAPIException
-
sendData
-
Sends data and returns the number of bytes actually written.
unsigned long sendData(byte[] data);
Since: 2.2
Privilege level: public
Privilege: http://tizen.org/privilege/bluetooth
Warning: http://tizen.org/privilege/bluetooth.health (public level) has been deprecated since 2.4. Instead, use http://tizen.org/privilege/bluetooth.
Parameters:
- data: Data to send.
Return value:
-
unsigned long:
Number of bytes actually sent.
Exceptions:
- WebAPIException
with error type SecurityError, if the application does not have the privilege to call this method.
with error type ServiceNotAvailableError, if a Bluetooth device is turned off.
with error type TypeMismatchError, if any of the input parameter is not compatible with the expected type for that parameter.
with error type UnknownError, if any other error occurs.
Code example:
var adapter = tizen.bluetooth.getDefaultAdapter(); var healthProfileHandler = adapter.getBluetoothProfileHandler("HEALTH"); /* Data to send. */ var textmsg = "Test"; var dataToSend = new Array(); for (var i = 0; i < textmsg.length; i++) { dataToSend[i] = textmsg.charCodeAt(i); } function healthRegisterSuccess(app) { console.log("Registered application: " + app.name); app.onconnect = function(channel) { console.log("Health device is connected"); channel.sendData(dataToSend); }; } function healthRegisterError(e) { console.log("Failed to register application: " + e.message); } healthProfileHandler.registerSinkApplication( 4100, "testSinkApp", healthRegisterSuccess, healthRegisterError);
-
setListener
-
Sets the listener to receive notifications.
void setListener(BluetoothHealthChannelChangeCallback listener);
Since: 2.2
Privilege level: public
Privilege: http://tizen.org/privilege/bluetooth
Warning: http://tizen.org/privilege/bluetooth.health (public level) has been deprecated since 2.4. Instead, use http://tizen.org/privilege/bluetooth.
Parameters:
- listener: Event listener of Bluetooth health channel.
Exceptions:
- WebAPIException
with error type TypeMismatchError, if the input parameter is not compatible with the expected type.
with error type SecurityError, if the application does not have the privilege to call this method.
with error type UnknownError, if any other error occurs.
Code example:
var adapter = tizen.bluetooth.getDefaultAdapter(); var healthProfileHandler = adapter.getBluetoothProfileHandler("HEALTH"); var channelCallback = { onmessage: function(data) { console.log("data is received"); }, onclose: function() { console.log("channel is closed"); } }; function healthRegisterSuccess(app) { console.log("Registered application: " + app.name); app.onconnect = function(channel) { console.log("Health device is connected"); channel.setListener(channelCallback); }; } function healthRegisterError(e) { console.log("Failed to register application: " + e.message); } healthProfileHandler.registerSinkApplication( 4100, "testSinkApp", healthRegisterSuccess, healthRegisterError);
-
unsetListener
-
Unsets the listener. This stops receiving notifications.
void unsetListener();
Since: 2.2
Calling this function has no effect if listener is not set.
Privilege level: public
Privilege: http://tizen.org/privilege/bluetooth
Warning: http://tizen.org/privilege/bluetooth.health (public level) has been deprecated since 2.4. Instead, use http://tizen.org/privilege/bluetooth.
Exceptions:
- WebAPIException
with error type SecurityError, if the application does not have the privilege to call this method.
with error type UnknownError, if any other error occurs.
Code example:
var adapter = tizen.bluetooth.getDefaultAdapter(); var healthProfileHandler = adapter.getBluetoothProfileHandler("HEALTH"); var connectedChannel = null; var channelCallback = { onmessage: function(data) { console.log("data is received"); }, onclose: function() { console.log("channel is closed"); connectedChannel.unsetListener(); } }; function healthRegisterSuccess(app) { console.log("Registered application: " + app.name); app.onconnect = function(channel) { console.log("Health device is connected"); connectedChannel = channel; connectedChannel.setListener(channelCallback); }; } function healthRegisterError(e) { console.log("Failed to register application: " + e.message); } healthProfileHandler.registerSinkApplication( 4100, "testSinkApp", healthRegisterSuccess, healthRegisterError);
- WebAPIException
2.28. BluetoothAdapterChangeCallback
[Callback, NoInterfaceObject] interface BluetoothAdapterChangeCallback { void onstatechanged(boolean powered); void onnamechanged(DOMString name); void onvisibilitychanged(boolean visible); };
Since: 2.2
Remark: Example of using can be find at setChangeListener code example.
Methods
-
onstatechanged
-
Called when the power state is changed.
void onstatechanged(boolean powered);
Since: 2.2
Parameters:
- powered: Flag indicating power state of local Bluetooth: true means power-on, false means power-off.
-
onnamechanged
-
Called when the name is changed.
void onnamechanged(DOMString name);
Since: 2.2
Parameters:
- name: Name of local Bluetooth.
-
onvisibilitychanged
-
Called when the visibility is changed.
void onvisibilitychanged(boolean visible);
Since: 2.2
Parameters:
- visible: Flag indicating visibility of local Bluetooth: true means that local Bluetooth is discoverable, false means that local Bluetooth is hidden from other devices.
2.29. BluetoothDeviceSuccessCallback
[Callback=FunctionOnly, NoInterfaceObject] interface BluetoothDeviceSuccessCallback { void onsuccess(BluetoothDevice device); };
Since: 1.0
Remark: Example of using can be find at getDevice and createBonding code examples.
Methods
-
onsuccess
-
Called on success.
void onsuccess(BluetoothDevice device);
Since: 1.0
Parameters:
- device: BluetoothDevice object.
2.30. BluetoothDeviceArraySuccessCallback
[Callback=FunctionOnly, NoInterfaceObject] interface BluetoothDeviceArraySuccessCallback { void onsuccess(BluetoothDevice[] devices); };
Since: 1.0
Remark: Example of using can be find at getKnownDevices code example.
Methods
-
onsuccess
-
Called when device information is ready.
void onsuccess(BluetoothDevice[] devices);
Since: 1.0
Parameters:
- devices: List of devices known to local Bluetooth adapter. Each element is a BluetoothDevice.
2.31. BluetoothDiscoverDevicesSuccessCallback
[Callback, NoInterfaceObject] interface BluetoothDiscoverDevicesSuccessCallback { void onstarted(); void ondevicefound(BluetoothDevice device); void ondevicedisappeared(BluetoothAddress address); void onfinished(BluetoothDevice[] foundDevices); };
Since: 1.0
Remark: Example of using can be find at discoverDevices code example.
Methods
-
onstarted
-
Called at the beginning of a device discovery process for finding the nearby Bluetooth device.
void onstarted();
Since: 1.0
-
ondevicefound
-
Called when a new device is discovered in the process of inquiry/discovery.
void ondevicefound(BluetoothDevice device);
Since: 1.0
Parameters:
- device: Device that is found.
-
ondevicedisappeared
-
Called when a device is lost from proximity. After that, this device is no longer visible.
void ondevicedisappeared(BluetoothAddress address);
Since: 1.0
Parameters:
- address: Address of the device that is no longer in range or visible.
-
onfinished
-
Called when the device discovery process has finished.
void onfinished(BluetoothDevice[] foundDevices);
Since: 1.0
Parameters:
- foundDevices: Array of devices found in this discovery session.
2.32. BluetoothSocketSuccessCallback
[Callback=FunctionOnly, NoInterfaceObject] interface BluetoothSocketSuccessCallback { void onsuccess(BluetoothSocket socket); };
Since: 1.0
Remark: Example of using can be find at connectToServiceByUUID code example.
Methods
-
onsuccess
-
Called when the connection to a service is ready.
void onsuccess(BluetoothSocket socket);
Since: 1.0
Parameters:
- socket: Socket to connect to the specified service on a remote device.
2.33. BluetoothServiceSuccessCallback
[Callback=FunctionOnly, NoInterfaceObject] interface BluetoothServiceSuccessCallback { void onsuccess(BluetoothServiceHandler handler); };
Since: 1.0
Remark: Example of using can be find at registerRFCOMMServiceByUUID code example.
Methods
-
onsuccess
-
Called when registering a service with the local device is successful.
void onsuccess(BluetoothServiceHandler handler);
Since: 1.0
Parameters:
- handler: Bluetooth service handler.
2.34. BluetoothHealthApplicationSuccessCallback
[Callback=FunctionOnly, NoInterfaceObject] interface BluetoothHealthApplicationSuccessCallback { void onsuccess(BluetoothHealthApplication application); };
Since: 2.2
Remark: Example of using can be find at registerSinkApplication code example.
Methods
-
onsuccess
-
Called when the application is registered successfully.
void onsuccess(BluetoothHealthApplication application);
Since: 2.2
Parameters:
- application: Registered health application.
2.35. BluetoothHealthChannelSuccessCallback
[Callback=FunctionOnly, NoInterfaceObject] interface BluetoothHealthChannelSuccessCallback { void onsuccess(BluetoothHealthChannel channel); };
Since: 2.2
Remark: Example of using can be find at connectToSource code example.
Methods
-
onsuccess
-
Called when a connection is established.
void onsuccess(BluetoothHealthChannel channel);
Since: 2.2
Parameters:
- channel: Connected health channel.
2.36. BluetoothHealthChannelChangeCallback
[Callback, NoInterfaceObject] interface BluetoothHealthChannelChangeCallback { void onmessage(byte[] data); void onclose(); };
Since: 2.2
Remark: Example of using can be find at setListener code example.
3. Related Feature
To guarantee that the Bluetooth application runs on a device with Bluetooth feature, declare the following feature requirements in the config file:
To guarantee that the Bluetooth healthcare application runs on a device with Bluetooth health profile feature, declare the following feature requirements in the config file:
To guarantee that the Bluetooth Low Energy application runs on a device with Bluetooth Low Energy feature, declare the following feature requirements in the config file:
4. Full WebIDL
module Bluetooth { typedef DOMString BluetoothAddress; typedef DOMString BluetoothUUID; typedef DOMString BluetoothLESolicitationUUID; enum BluetoothSocketState { "CLOSED", "OPEN" }; enum BluetoothProfileType { "HEALTH" }; enum BluetoothHealthChannelType { "RELIABLE", "STREAMING" }; enum BluetoothAdvertisePacketType { "ADVERTISE", "SCAN_RESPONSE" }; enum BluetoothAdvertisingState { "STARTED", "STOPPED" }; enum BluetoothAdvertisingMode { "BALANCED", "LOW_LATENCY", "LOW_ENERGY" }; dictionary BluetoothLEAdvertiseDataInit { boolean? includeName; BluetoothUUID[]? uuids; BluetoothLESolicitationUUID[]? solicitationuuids; unsigned long? appearance; boolean? includeTxPowerLevel; BluetoothLEServiceData? serviceData; BluetoothLEManufacturerData? manufacturerData; }; Tizen implements BluetoothManagerObject; [NoInterfaceObject] interface BluetoothManagerObject { readonly attribute BluetoothManager bluetooth; }; [Constructor(DOMString uuid, DOMString data)] interface BluetoothLEServiceData { attribute BluetoothUUID uuid; attribute DOMString data; }; [Constructor(DOMString id, DOMString data)] interface BluetoothLEManufacturerData { attribute DOMString id; attribute DOMString data; }; [Constructor(optional BluetoothLEAdvertiseDataInit? init)] interface BluetoothLEAdvertiseData { attribute boolean? includeName; attribute BluetoothUUID[]? uuids; attribute BluetoothLESolicitationUUID[]? solicitationuuids; attribute unsigned long? appearance; attribute boolean? includeTxPowerLevel; attribute BluetoothLEServiceData? serviceData; attribute BluetoothLEManufacturerData? manufacturerData; }; [NoInterfaceObject] interface BluetoothManager { readonly attribute BluetoothClassDeviceMajor deviceMajor; readonly attribute BluetoothClassDeviceMinor deviceMinor; readonly attribute BluetoothClassDeviceService deviceService; BluetoothAdapter getDefaultAdapter() raises(WebAPIException); BluetoothLEAdapter getLEAdapter() raises(WebAPIException); }; [NoInterfaceObject] interface BluetoothAdapter { readonly attribute DOMString name; readonly attribute BluetoothAddress address; readonly attribute boolean powered; readonly attribute boolean visible; void setName(DOMString name, optional SuccessCallback? successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); void setChangeListener(BluetoothAdapterChangeCallback listener) raises(WebAPIException); void unsetChangeListener() raises(WebAPIException); void discoverDevices(BluetoothDiscoverDevicesSuccessCallback successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); void stopDiscovery(optional SuccessCallback? successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); void getKnownDevices(BluetoothDeviceArraySuccessCallback successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); void getDevice(BluetoothAddress address, BluetoothDeviceSuccessCallback successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); void createBonding(BluetoothAddress address, BluetoothDeviceSuccessCallback successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); void destroyBonding(BluetoothAddress address, optional SuccessCallback? successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); void registerRFCOMMServiceByUUID(BluetoothUUID uuid, DOMString name, BluetoothServiceSuccessCallback successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); BluetoothProfileHandler getBluetoothProfileHandler(BluetoothProfileType profileType) raises(WebAPIException); }; [NoInterfaceObject] interface BluetoothLEAdapter { void startScan(BluetoothLEScanCallback successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); void stopScan() raises(WebAPIException); void startAdvertise(BluetoothLEAdvertiseData advertiseData, BluetoothAdvertisePacketType packetType, BluetoothLEAdvertiseCallback successCallback, optional ErrorCallback? errorCallback, optional BluetoothAdvertisingMode? mode, optional boolean? connectable) raises(WebAPIException); void stopAdvertise() raises(WebAPIException); }; [NoInterfaceObject] interface BluetoothGATTService { readonly attribute BluetoothUUID uuid; readonly attribute BluetoothGATTService[] services; readonly attribute BluetoothGATTCharacteristic[] characteristics; }; [NoInterfaceObject] interface BluetoothGATTCharacteristic { readonly attribute BluetoothGATTDescriptor[] descriptors; readonly attribute boolean isBroadcast; readonly attribute boolean hasExtendedProperties; readonly attribute boolean isNotify; readonly attribute boolean isIndication; readonly attribute boolean isReadable; readonly attribute boolean isSignedWrite; readonly attribute boolean isWritable; readonly attribute boolean isWriteNoResponse; void readValue(ReadValueSuccessCallback successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); void writeValue(byte[] value, optional SuccessCallback? successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); long addValueChangeListener(ReadValueSuccessCallback callback) raises(WebAPIException); void removeValueChangeListener(long watchID); }; [NoInterfaceObject] interface BluetoothGATTDescriptor { void readValue(ReadValueSuccessCallback successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); void writeValue(byte[] value, optional SuccessCallback? successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); }; [Callback=FunctionOnly, NoInterfaceObject] interface BluetoothLEScanCallback { void onsuccess(BluetoothLEDevice device); }; [Callback=FunctionOnly, NoInterfaceObject] interface BluetoothLEAdvertiseCallback { void onstate(BluetoothAdvertisingState state); }; [Callback, NoInterfaceObject] interface BluetoothLEConnectChangeCallback { void onconnected(BluetoothLEDevice device); void ondisconnected(BluetoothLEDevice device); }; [Callback=FunctionOnly, NoInterfaceObject] interface ReadValueSuccessCallback { void onread(byte[] value); }; [NoInterfaceObject] interface BluetoothDevice { readonly attribute DOMString name; readonly attribute BluetoothAddress address; readonly attribute BluetoothClass deviceClass; readonly attribute boolean isBonded; readonly attribute boolean isTrusted; readonly attribute boolean isConnected; readonly attribute BluetoothUUID[] uuids; void connectToServiceByUUID(BluetoothUUID uuid, BluetoothSocketSuccessCallback successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); }; [NoInterfaceObject] interface BluetoothLEDevice { readonly attribute BluetoothAddress address; readonly attribute DOMString? name; readonly attribute long? txpowerlevel; readonly attribute unsigned long? appearance; readonly attribute BluetoothUUID[]? uuids; readonly attribute BluetoothLESolicitationUUID[]? solicitationuuids; readonly attribute BluetoothLEServiceData[]? serviceData; readonly attribute BluetoothLEManufacturerData? manufacturerData; readonly attribute long rssi; void connect(optional SuccessCallback? successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); void disconnect(optional SuccessCallback? successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); BluetoothGATTService getService(BluetoothUUID uuid) raises(WebAPIException); BluetoothUUID[] getServiceAllUuids() raises(WebAPIException); long addConnectStateChangeListener(BluetoothLEConnectChangeCallback listener) raises(WebAPIException); void removeConnectStateChangeListener(long watchID); }; [NoInterfaceObject] interface BluetoothSocket { readonly attribute BluetoothUUID uuid; readonly attribute BluetoothSocketState state; readonly attribute BluetoothDevice peer; [TreatNonCallableAsNull] attribute SuccessCallback? onmessage raises(WebAPIException); [TreatNonCallableAsNull] attribute SuccessCallback? onclose raises(WebAPIException); unsigned long writeData(byte[] data) raises(WebAPIException); byte[] readData() raises(WebAPIException); void close() raises(WebAPIException); }; [NoInterfaceObject] interface BluetoothClass { readonly attribute octet major; readonly attribute octet minor; readonly attribute unsigned short[] services; boolean hasService(unsigned short service) raises(WebAPIException); }; [NoInterfaceObject] interface BluetoothClassDeviceMajor { const octet MISC = 0x00; const octet COMPUTER = 0x01; const octet PHONE = 0x02; const octet NETWORK = 0x03; const octet AUDIO_VIDEO = 0x04; const octet PERIPHERAL = 0x05; const octet IMAGING = 0x06; const octet WEARABLE = 0x07; const octet TOY = 0x08; const octet HEALTH = 0x09; const octet UNCATEGORIZED = 0x1F; }; [NoInterfaceObject] interface BluetoothClassDeviceMinor { const octet COMPUTER_UNCATEGORIZED = 0x00; const octet COMPUTER_DESKTOP = 0x01; const octet COMPUTER_SERVER = 0x02; const octet COMPUTER_LAPTOP = 0x03; const octet COMPUTER_HANDHELD_PC_OR_PDA = 0x04; const octet COMPUTER_PALM_PC_OR_PDA = 0x05; const octet COMPUTER_WEARABLE = 0x06; const octet PHONE_UNCATEGORIZED = 0x00; const octet PHONE_CELLULAR = 0x01; const octet PHONE_CORDLESS = 0x02; const octet PHONE_SMARTPHONE = 0x03; const octet PHONE_MODEM_OR_GATEWAY = 0x04; const octet PHONE_ISDN = 0x05; const octet AV_UNRECOGNIZED = 0x00; const octet AV_WEARABLE_HEADSET = 0x01; const octet AV_HANDSFREE = 0x02; const octet AV_MICROPHONE = 0x04; const octet AV_LOUDSPEAKER = 0x05; const octet AV_HEADPHONES = 0x06; const octet AV_PORTABLE_AUDIO = 0x07; const octet AV_CAR_AUDIO = 0x08; const octet AV_SETTOP_BOX = 0x09; const octet AV_HIFI = 0x0a; const octet AV_VCR = 0x0b; const octet AV_VIDEO_CAMERA = 0x0c; const octet AV_CAMCORDER = 0x0d; const octet AV_MONITOR = 0x0e; const octet AV_DISPLAY_AND_LOUDSPEAKER = 0x0f; const octet AV_VIDEO_CONFERENCING = 0x10; const octet AV_GAMING_TOY = 0x12; const octet PERIPHERAL_UNCATEGORIZED = 0; const octet PERIPHERAL_KEYBOARD = 0x10; const octet PERIPHERAL_POINTING_DEVICE = 0x20; const octet PERIPHERAL_KEYBOARD_AND_POINTING_DEVICE = 0x30; const octet PERIPHERAL_JOYSTICK = 0x01; const octet PERIPHERAL_GAMEPAD = 0x02; const octet PERIPHERAL_REMOTE_CONTROL = 0x03; const octet PERIPHERAL_SENSING_DEVICE = 0x04; const octet PERIPHERAL_DEGITIZER_TABLET = 0x05; const octet PERIPHERAL_CARD_READER = 0x06; const octet PERIPHERAL_DIGITAL_PEN = 0x07; const octet PERIPHERAL_HANDHELD_SCANNER = 0x08; const octet PERIPHERAL_HANDHELD_INPUT_DEVICE = 0x09; const octet IMAGING_UNCATEGORIZED = 0x00; const octet IMAGING_DISPLAY = 0x04; const octet IMAGING_CAMERA = 0x08; const octet IMAGING_SCANNER = 0x10; const octet IMAGING_PRINTER = 0x20; const octet WEARABLE_WRITST_WATCH = 0x01; const octet WEARABLE_PAGER = 0x02; const octet WEARABLE_JACKET = 0x03; const octet WEARABLE_HELMET = 0x04; const octet WEARABLE_GLASSES = 0x05; const octet TOY_ROBOT = 0x01; const octet TOY_VEHICLE = 0x02; const octet TOY_DOLL = 0x03; const octet TOY_CONTROLLER = 0x04; const octet TOY_GAME = 0x05; const octet HEALTH_UNDEFINED = 0x00; const octet HEALTH_BLOOD_PRESSURE_MONITOR = 0x01; const octet HEALTH_THERMOMETER = 0x02; const octet HEALTH_WEIGHING_SCALE = 0x03; const octet HEALTH_GLUCOSE_METER = 0x04; const octet HEALTH_PULSE_OXIMETER = 0x05; const octet HEALTH_PULSE_RATE_MONITOR = 0x06; const octet HEALTH_DATA_DISPLAY = 0x07; const octet HEALTH_STEP_COUNTER = 0x08; const octet HEALTH_BODY_COMPOSITION_ANALYZER = 0x09; const octet HEALTH_PEAK_FLOW_MONITOR = 0x0a; const octet HEALTH_MEDICATION_MONITOR = 0x0b; const octet HEALTH_KNEE_PROSTHESIS = 0x0c; const octet HEALTH_ANKLE_PROSTHESIS = 0x0d; }; [NoInterfaceObject] interface BluetoothClassDeviceService { const unsigned short LIMITED_DISCOVERABILITY = 0x0001; const unsigned short POSITIONING = 0x0008; const unsigned short NETWORKING = 0x0010; const unsigned short RENDERING = 0x0020; const unsigned short CAPTURING = 0x0040; const unsigned short OBJECT_TRANSFER = 0x0080; const unsigned short AUDIO = 0x0100; const unsigned short TELEPHONY = 0x0200; const unsigned short INFORMATION = 0x0400; }; [NoInterfaceObject] interface BluetoothServiceHandler { readonly attribute BluetoothUUID uuid; readonly attribute DOMString name; readonly attribute boolean isConnected; [TreatNonCallableAsNull] attribute BluetoothSocketSuccessCallback? onconnect raises(WebAPIException); void unregister(optional SuccessCallback? successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); }; [NoInterfaceObject] interface BluetoothProfileHandler { readonly attribute BluetoothProfileType profileType; }; [NoInterfaceObject] interface BluetoothHealthProfileHandler : BluetoothProfileHandler { void registerSinkApplication(unsigned short dataType, DOMString name, BluetoothHealthApplicationSuccessCallback successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); void connectToSource(BluetoothDevice peer, BluetoothHealthApplication application, BluetoothHealthChannelSuccessCallback successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); }; [NoInterfaceObject] interface BluetoothHealthApplication { readonly attribute unsigned short dataType; readonly attribute DOMString name; [TreatNonCallableAsNull] attribute BluetoothHealthChannelSuccessCallback? onconnect raises(WebAPIException); void unregister(optional SuccessCallback? successCallback, optional ErrorCallback? errorCallback) raises(WebAPIException); }; [NoInterfaceObject] interface BluetoothHealthChannel { readonly attribute BluetoothDevice peer; readonly attribute BluetoothHealthChannelType channelType; readonly attribute BluetoothHealthApplication application; readonly attribute boolean isConnected; void close() raises(WebAPIException); unsigned long sendData(byte[] data) raises(WebAPIException); void setListener(BluetoothHealthChannelChangeCallback listener) raises(WebAPIException); void unsetListener() raises(WebAPIException); }; [Callback, NoInterfaceObject] interface BluetoothAdapterChangeCallback { void onstatechanged(boolean powered); void onnamechanged(DOMString name); void onvisibilitychanged(boolean visible); }; [Callback=FunctionOnly, NoInterfaceObject] interface BluetoothDeviceSuccessCallback { void onsuccess(BluetoothDevice device); }; [Callback=FunctionOnly, NoInterfaceObject] interface BluetoothDeviceArraySuccessCallback { void onsuccess(BluetoothDevice[] devices); }; [Callback, NoInterfaceObject] interface BluetoothDiscoverDevicesSuccessCallback { void onstarted(); void ondevicefound(BluetoothDevice device); void ondevicedisappeared(BluetoothAddress address); void onfinished(BluetoothDevice[] foundDevices); }; [Callback=FunctionOnly, NoInterfaceObject] interface BluetoothSocketSuccessCallback { void onsuccess(BluetoothSocket socket); }; [Callback=FunctionOnly, NoInterfaceObject] interface BluetoothServiceSuccessCallback { void onsuccess(BluetoothServiceHandler handler); }; [Callback=FunctionOnly, NoInterfaceObject] interface BluetoothHealthApplicationSuccessCallback { void onsuccess(BluetoothHealthApplication application); }; [Callback=FunctionOnly, NoInterfaceObject] interface BluetoothHealthChannelSuccessCallback { void onsuccess(BluetoothHealthChannel channel); }; [Callback, NoInterfaceObject] interface BluetoothHealthChannelChangeCallback { void onmessage(byte[] data); void onclose(); }; };