gecko-dev/dom/webidl/BluetoothAdapter.webidl

229 строки
7.4 KiB
Plaintext

/* -*- Mode: c++; c-basic-offset: 2; indent-tabs-mode: nil; tab-width: 40 -*- */
/* vim: set ts=2 et sw=2 tw=80: */
/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this file,
* You can obtain one at http://mozilla.org/MPL/2.0/. */
// MediaMetadata and MediaPlayStatus are used to keep data from Applications.
// Please see specification of AVRCP 1.3 for more details.
dictionary MediaMetaData
{
// track title
DOMString title = "";
// artist name
DOMString artist = "";
// album name
DOMString album = "";
// track number
long long mediaNumber = -1;
// number of tracks in the album
long long totalMediaCount = -1;
// playing time (ms)
long long duration = -1;
};
dictionary MediaPlayStatus
{
// current track length (ms)
long long duration = -1;
// playing time (ms)
long long position = -1;
// one of 'STOPPED'/'PLAYING'/'PAUSED'/'FWD_SEEK'/'REV_SEEK'/'ERROR'
DOMString playStatus = "";
};
[ChromeOnly]
interface BluetoothAdapter : EventTarget {
readonly attribute BluetoothAdapterState state;
readonly attribute DOMString address;
readonly attribute DOMString name;
readonly attribute boolean discoverable;
readonly attribute boolean discovering;
readonly attribute BluetoothGattServer? gattServer;
readonly attribute BluetoothPairingListener? pairingReqs;
// Fired when attribute(s) of BluetoothAdapter changed
attribute EventHandler onattributechanged;
// Fired when a remote device gets paired with the adapter
attribute EventHandler ondevicepaired;
// Fired when a remote device gets unpaired from the adapter
attribute EventHandler ondeviceunpaired;
// Fired when the pairing process aborted
attribute EventHandler onpairingaborted;
// Fired when a2dp connection status changed
attribute EventHandler ona2dpstatuschanged;
// Fired when handsfree connection status changed
attribute EventHandler onhfpstatuschanged;
// Fired when handsfree connection status changed
attribute EventHandler onhidstatuschanged;
// Fired when sco connection status changed
attribute EventHandler onscostatuschanged;
// Fired when remote devices query current media play status
attribute EventHandler onrequestmediaplaystatus;
// Fired when remote devices request password for OBEX authentication
attribute EventHandler onobexpasswordreq;
// Fired when PBAP manager requests for 'pullphonebook'
attribute EventHandler onpullphonebookreq;
// Fired when PBAP manager requests for 'pullvcardentry'
attribute EventHandler onpullvcardentryreq;
// Fired when PBAP manager requests for 'pullvcardlisting'
attribute EventHandler onpullvcardlistingreq;
// Fired when remote devices request to list SMS/MMS/Email folders
attribute EventHandler onmapfolderlistingreq;
// Fired when remote devices request to list SMS/MMS/Email messages
attribute EventHandler onmapmessageslistingreq;
// Fired when remote devices fetch the specific message
attribute EventHandler onmapgetmessagereq;
// Fired when remote devices set message status
attribute EventHandler onmapsetmessagestatusreq;
// Fired when remote devices send out SMS/MMS/Email message
attribute EventHandler onmapsendmessagereq;
// Fired when remote devices download SMS/MMS/Email messages
attribute EventHandler onmapmessageupdatereq;
/**
* Enable/Disable a local bluetooth adapter by asynchronus methods and return
* its result through a Promise.
*
* Several onattributechanged events would be triggered during processing the
* request, and the last one indicates adapter.state becomes enabled/disabled.
*/
[NewObject]
Promise<void> enable();
[NewObject]
Promise<void> disable();
[NewObject]
Promise<void> setName(DOMString name);
[NewObject]
Promise<void> setDiscoverable(boolean discoverable);
[NewObject]
Promise<BluetoothDiscoveryHandle> startDiscovery();
[NewObject]
Promise<void> stopDiscovery();
[NewObject]
Promise<void> pair(DOMString deviceAddress);
[NewObject]
Promise<void> unpair(DOMString deviceAddress);
sequence<BluetoothDevice> getPairedDevices();
/**
* [B2G only GATT client API]
* |startLeScan| and |stopLeScan| methods are exposed only if
* "dom.bluetooth.webbluetooth.enabled" preference is false.
*/
[NewObject,
Func="mozilla::dom::bluetooth::BluetoothManager::B2GGattClientEnabled"]
Promise<BluetoothDiscoveryHandle> startLeScan(sequence<DOMString> serviceUuids);
[NewObject,
Func="mozilla::dom::bluetooth::BluetoothManager::B2GGattClientEnabled"]
Promise<void> stopLeScan(BluetoothDiscoveryHandle discoveryHandle);
[NewObject, Throws]
DOMRequest getConnectedDevices(unsigned short serviceUuid);
/**
* Connect/Disconnect to a specific service of a target remote device.
* To check the value of service UUIDs, please check "Bluetooth Assigned
* Numbers" / "Service Discovery Protocol" for more information.
*
* Note that service UUID is optional. If it isn't passed when calling
* Connect, multiple profiles are tried sequentially based on the class of
* device (CoD). If it isn't passed when calling Disconnect, all connected
* profiles are going to be closed.
*
* Reply success if the connection of any profile is successfully
* established/released; reply error if we failed to connect/disconnect all
* of the planned profiles.
*
* @param device Remote device
* @param profile 2-octets service UUID. This is optional.
*/
[NewObject, Throws]
DOMRequest connect(BluetoothDevice device, optional unsigned short serviceUuid);
[NewObject, Throws]
DOMRequest disconnect(BluetoothDevice device, optional unsigned short serviceUuid);
// One device can only send one file at a time
[NewObject, Throws]
DOMRequest sendFile(DOMString deviceAddress, Blob blob);
[NewObject, Throws]
DOMRequest stopSendingFile(DOMString deviceAddress);
[NewObject, Throws]
DOMRequest confirmReceivingFile(DOMString deviceAddress, boolean confirmation);
// Connect/Disconnect SCO (audio) connection
[NewObject, Throws]
DOMRequest connectSco();
[NewObject, Throws]
DOMRequest disconnectSco();
[NewObject, Throws]
DOMRequest isScoConnected();
/**
* Additional HFP methods to handle CDMA network.
*
* In GSM network we observe call operations from RIL call state changes;
* however in CDMA network RIL call states do not change under some call
* operations, so we need these additional methods to be informed of these
* operations from dialer.
*
* For more information please refer to bug 912005 and 925638.
*/
[NewObject, Throws]
DOMRequest answerWaitingCall();
[NewObject, Throws]
DOMRequest ignoreWaitingCall();
[NewObject, Throws]
DOMRequest toggleCalls();
// AVRCP 1.3 methods
[NewObject, Throws]
DOMRequest sendMediaMetaData(optional MediaMetaData mediaMetaData);
[NewObject, Throws]
DOMRequest sendMediaPlayStatus(optional MediaPlayStatus mediaPlayStatus);
};
enum BluetoothAdapterState
{
"disabled",
"disabling",
"enabled",
"enabling"
};
enum BluetoothAdapterAttribute
{
"unknown",
"state",
"address",
"name",
"discoverable",
"discovering"
};