TransportHandle


interface TransportHandle : AutoCloseable
android.ranging.oob.TransportHandle

TransportHandle is used as the Out-Of-Band (OOB) transport mechanism by ranging module. In cases where module is used in a non-raw ranging mode, the user shall provide an implementation of the TransportHandle, allowing ranging module to do the necessary OOB communication with a peer device using the provided transport handle. Some examples of OOB transport between two peer devices are:

  • BLE GATT connection
  • Wi-Fi MDNS link
  • Internet

Summary

Nested classes
abstract

TransportHandle callback.

Public methods
abstract Unit

Registers a callback to receive updates from the transport mechanism.

abstract Unit

Send data to the peer device via the implemented OOB transport.

Inherited functions

Public methods

registerReceiveCallback

abstract fun registerReceiveCallback(
    executor: Executor,
    callback: TransportHandle.ReceiveCallback
): Unit

Registers a callback to receive updates from the transport mechanism.

The callback should be used to notify information about the peer device including the data received from the peer device.

Parameters
executor Executor: the Executor on which the callback should be invoked. Must not be null.
callback TransportHandle.ReceiveCallback: the ReceiveCallback instance to receive updates. Must not be null.
Exceptions
java.lang.IllegalArgumentException if either executor or callback is null.

sendData

abstract fun sendData(data: ByteArray): Unit

Send data to the peer device via the implemented OOB transport.

Parameters
data ByteArray: the data to be sent to the peer device. Must not be null.
Exceptions
java.lang.IllegalArgumentException if the provided data is null or invalid