L2capNetworkSpecifier Class

Definition

[Android.Runtime.Register("android/net/L2capNetworkSpecifier", ApiSince=36, DoNotGenerateAcw=true)]
public sealed class L2capNetworkSpecifier : Android.Net.NetworkSpecifier, Android.OS.IParcelable, IDisposable, Java.Interop.IJavaPeerable

[<Android.Runtime.Register("android/net/L2capNetworkSpecifier", ApiSince=36, DoNotGenerateAcw=true)>]
type L2capNetworkSpecifier = class
    inherit NetworkSpecifier
    interface IParcelable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Inheritance

Object

Object

NetworkSpecifier

L2capNetworkSpecifier

Attributes

RegisterAttribute

Implements

IParcelable IJavaObject IJavaPeerable IDisposable

Remarks

A NetworkSpecifier used to identify an L2CAP network over BLE.

An L2CAP network is not symmetrical, meaning there exists both a server (Bluetooth peripheral) and a client (Bluetooth central) node. This specifier contains the information required to request a client L2CAP network using ConnectivityManager#requestNetwork while specifying the remote MAC address, and Protocol/Service Multiplexer (PSM). It can also contain information allocated by the system when reserving a server network using ConnectivityManager#reserveNetwork such as the Protocol/Service Multiplexer (PSM). In both cases, the header compression option must be specified.

An L2CAP server network allocates a Protocol/Service Multiplexer (PSM) to be advertised to the client. A new server network must always be reserved using ConnectivityManager#reserveNetwork. The subsequent ConnectivityManager.NetworkCallback#onReserved(NetworkCapabilities) callback includes an L2CapNetworkSpecifier. The getPsm() method will return the Protocol/Service Multiplexer (PSM) of the reserved network so that the server can advertise it to the client and the client can connect. An L2CAP server network is backed by a android.bluetooth.BluetoothServerSocket which can, in theory, accept many connections. However, before SDK version Build.VERSION_CODES.VANILLA_ICE_CREAM Bluetooth APIs do not expose the channel ID, so these connections are indistinguishable. In practice, this means that the network matching semantics in ConnectivityService will tear down all but the first connection.

When the connection between client and server completes, a Network whose capabilities satisfy this L2capNetworkSpecifier will connect and the usual callbacks, such as NetworkCallback#onAvailable, will be called on the callback object passed to ConnectivityManager#reserveNetwork or ConnectivityManager#requestNetwork.

Java documentation for android.net.L2capNetworkSpecifier.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.