UwbManager

interface UwbManager

Interface for getting UWB capabilities and interacting with nearby UWB devices to perform ranging.

Summary

Public companion functions
UwbManager

Creates a new UwbManager that is used for creating UWB client sessions.

Public functions
suspend UwbClientSessionScope

This function is deprecated. Renamed to controleeSessionScope
suspend UwbControleeSessionScope
suspend UwbControllerSessionScope
suspend Boolean

Checks whether UWB service is available or not.

Extension functions
Single<UwbClientSessionScope>

This function is deprecated. Renamed to controleeSessionScopeSingle
Single<UwbControleeSessionScope>

Returns a Single of UwbControleeSessionScope.
Single<UwbControllerSessionScope>

Returns a Single of UwbControllerSessionScope.

Public companion functions

createInstance

Added in 1.0.0-alpha09
fun createInstance(context: Context): UwbManager

Creates a new UwbManager that is used for creating UWB client sessions.

Public functions

clientSessionScope

suspend fun clientSessionScope(): UwbClientSessionScope
Returns
UwbClientSessionScope

a new UwbClientSessionScope that tracks the lifecycle of a UWB connection.
Throws
androidx.core.uwb.exceptions.UwbServiceNotAvailableException

if the UWB is turned off.
androidx.core.uwb.exceptions.UwbHardwareNotAvailableException

if the hardware is not available on the device.

controleeSessionScope

suspend fun controleeSessionScope(): UwbControleeSessionScope
Returns
UwbControleeSessionScope

a new UwbControleeSessionScope that tracks the lifecycle of a UWB connection.
Throws
androidx.core.uwb.exceptions.UwbServiceNotAvailableException

if the UWB is turned off.
androidx.core.uwb.exceptions.UwbHardwareNotAvailableException

if the hardware is not available on the device.

controllerSessionScope

suspend fun controllerSessionScope(): UwbControllerSessionScope
Returns
UwbControllerSessionScope

a new UwbControllerSessionScope that tracks the lifecycle of a UWB connection.
Throws
androidx.core.uwb.exceptions.UwbServiceNotAvailableException

if the UWB is turned off.
androidx.core.uwb.exceptions.UwbHardwareNotAvailableException

if the hardware is not available on the device.

isAvailable

suspend fun isAvailable(): Boolean

Checks whether UWB service is available or not. Airplane mode or turning the UWB off will cause the uwb service to be unavailable. When unavailable, the user cannot create session scope through this interface. Also, user should check the hardware support for UWB by using PackageManager.hasSystemFeature("android.hardware.uwb").

Returns
Boolean

true if UWB service is available, false otherwise
Throws
androidx.core.uwb.exceptions.UwbHardwareNotAvailableException

if the hardware is not available on the device.

Extension functions

clientSessionScopeSingle

fun UwbManager.clientSessionScopeSingle(): Single<UwbClientSessionScope>

Returns a Single of UwbClientSessionScope.

See also
clientSessionScope

controleeSessionScopeSingle

fun UwbManager.controleeSessionScopeSingle(): Single<UwbControleeSessionScope>

Returns a Single of UwbControleeSessionScope.

See also
controleeSessionScope

controllerSessionScopeSingle

fun UwbManager.controllerSessionScopeSingle(): Single<UwbControllerSessionScope>

Returns a Single of UwbControllerSessionScope.

See also
controllerSessionScope