OobInitiatorRangingConfig


public final class OobInitiatorRangingConfig
extends RangingConfig implements Parcelable

java.lang.Object
   ↳ android.ranging.RangingConfig
     ↳ android.ranging.oob.OobInitiatorRangingConfig


Represents the configuration for an Out-of-Band (OOB) initiator in a ranging session. This class includes configuration options such as device handles, security level, ranging mode, and interval range for setting up an OOB initiator ranging session.

Summary

Nested classes

class OobInitiatorRangingConfig.Builder

Builder class for creating instances of OobInitiatorRangingConfig

Constants

int RANGING_MODE_AUTO

Automatic ranging mode, allows the system to choose the best mode.

int RANGING_MODE_FUSED

Starts ranging with all the ranging technologies both devices support.

int RANGING_MODE_HIGH_ACCURACY

High accuracy ranging mode.

int RANGING_MODE_HIGH_ACCURACY_PREFERRED

High accuracy ranging mode.

int SECURITY_LEVEL_BASIC

Basic security level for the ranging session.

int SECURITY_LEVEL_SECURE

Basic security level for the ranging session.

Inherited constants

Fields

public static final Creator<OobInitiatorRangingConfig> CREATOR

Public methods

int describeContents()

Describe the kinds of special objects contained in this Parcelable instance's marshaled representation.

List<DeviceHandle> getDeviceHandles()

Returns the list of DeviceHandles associated with the OOB initiator.

Duration getFastestRangingInterval()

Returns the fastest requested ranging interval.

Range<Duration> getRangingIntervalRange()

Returns the ranging interval range configuration.

int getRangingMode()

Returns the ranging mode for the session.

int getSecurityLevel()

Returns the security level set for the ranging session.

Duration getSlowestRangingInterval()

Returns the slowest acceptable ranging.

String toString()

Returns a string representation of the object.

void writeToParcel(Parcel dest, int flags)

Flatten this object in to a Parcel.

Inherited methods

Constants

RANGING_MODE_AUTO

public static final int RANGING_MODE_AUTO

Automatic ranging mode, allows the system to choose the best mode.

Constant Value: 0 (0x00000000)

RANGING_MODE_FUSED

public static final int RANGING_MODE_FUSED

Starts ranging with all the ranging technologies both devices support.

Constant Value: 3 (0x00000003)

RANGING_MODE_HIGH_ACCURACY

public static final int RANGING_MODE_HIGH_ACCURACY

High accuracy ranging mode. Fallback to ranging technologies if high accuracy ranging is not supported

Constant Value: 1 (0x00000001)

RANGING_MODE_HIGH_ACCURACY_PREFERRED

public static final int RANGING_MODE_HIGH_ACCURACY_PREFERRED

High accuracy ranging mode. No fallback allowed.

Constant Value: 2 (0x00000002)

SECURITY_LEVEL_BASIC

public static final int SECURITY_LEVEL_BASIC

Basic security level for the ranging session.

Example usage: UWB: Static-STS BLE-CS: Security level one

Constant Value: 0 (0x00000000)

SECURITY_LEVEL_SECURE

public static final int SECURITY_LEVEL_SECURE

Basic security level for the ranging session.

Example usage: UWB: Provisioned-STS BLE-CS: Security level four

Constant Value: 1 (0x00000001)

Fields

CREATOR

public static final Creator<OobInitiatorRangingConfig> CREATOR

Public methods

describeContents

public int describeContents ()

Describe the kinds of special objects contained in this Parcelable instance's marshaled representation. For example, if the object will include a file descriptor in the output of writeToParcel(android.os.Parcel, int), the return value of this method must include the CONTENTS_FILE_DESCRIPTOR bit.

Returns
int a bitmask indicating the set of special object types marshaled by this Parcelable object instance. Value is either 0 or CONTENTS_FILE_DESCRIPTOR

getDeviceHandles

public List<DeviceHandle> getDeviceHandles ()

Returns the list of DeviceHandles associated with the OOB initiator.

Returns
List<DeviceHandle> A list of DeviceHandle objects. This value cannot be null.

getFastestRangingInterval

public Duration getFastestRangingInterval ()

Returns the fastest requested ranging interval.

Returns
Duration The fastest interval. This value cannot be null.

getRangingIntervalRange

public Range<Duration> getRangingIntervalRange ()

Returns the ranging interval range configuration.

Returns
Range<Duration> The Range associated with this OOB initiator. This value cannot be null.

getRangingMode

public int getRangingMode ()

Returns the ranging mode for the session.

Returns
int the ranging mode.

Possible values: RANGING_MODE_AUTO RANGING_MODE_HIGH_ACCURACY RANGING_MODE_HIGH_ACCURACY_PREFERRED RANGING_MODE_FUSED Value is RANGING_MODE_AUTO, RANGING_MODE_HIGH_ACCURACY, RANGING_MODE_HIGH_ACCURACY_PREFERRED, or RANGING_MODE_FUSED

getSecurityLevel

public int getSecurityLevel ()

Returns the security level set for the ranging session.

Returns
int the security level.

Possible values: SECURITY_LEVEL_BASIC SECURITY_LEVEL_SECURE Value is SECURITY_LEVEL_BASIC, or SECURITY_LEVEL_SECURE

getSlowestRangingInterval

public Duration getSlowestRangingInterval ()

Returns the slowest acceptable ranging.

Returns
Duration The slowest interval. This value cannot be null.

toString

public String toString ()

Returns a string representation of the object.

Returns
String a string representation of the object.

writeToParcel

public void writeToParcel (Parcel dest, 
                int flags)

Flatten this object in to a Parcel.

Parameters
dest Parcel: This value cannot be null.

flags int: Additional flags about how the object should be written. May be 0 or Parcelable.PARCELABLE_WRITE_RETURN_VALUE. Value is either 0 or a combination of Parcelable.PARCELABLE_WRITE_RETURN_VALUE, and android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES