B2G/Bluetooth/WebBluetooth-v2/BluetoothServerSocket

From MozillaWiki
Jump to: navigation, search

Overview

BluetoothServerSocket is a listening socket which is used to listen incoming RFCOMM connection.

Interfaces

BluetoothServerSocket

[CheckPermissions="bluetoothSocket"]
interface BluetoothServerSocket: EventTarget
{
  readonly attribute DOMString serviceUuid;
  readonly attribute DOMString? serviceName;

           attribute EventHandler onclose;

  [NewObject, Throws] Promise<BluetoothSocket> listen()
  [NewObject, Throws] Promise<void> close();
};

Properties

serviceUuid

Description
The UUID of Bluetooth service this server socket expected to accept for.
Value type
DOMString
Default value
Empty string ("")

serviceName

Description
The service name this server socket expected to accept for.
Value type
DOMString
Default value
Empty string ("")

Event Handlers

onclose

Description
Event raised when the listening socket has been close..
Argument
[CheckPermissions="bluetooth"]
interface BtSocketClostEvent : Event
{
  readonly attribute DOMString reason;
};
reason
A string indicating the reason the server closed the

Methods

listen()

Description
Listen for a socket connection using the RFCOMM protocol.
Return
A Promise to indicate whether the operation is resolved or rejected. Once the Promise is resolved, it returns a BluetoothSocket object which is connected to a remote device.

close()

Description
Immediately close this listening socket.
Return
A Promise to indicate whether the operation is resolved or rejected.

See Also