Added in [API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Summary: [Nested Classes](https://developer.android.com/reference/android/ranging/raw/RawRangingDevice#nestedclasses) \| [Constants](https://developer.android.com/reference/android/ranging/raw/RawRangingDevice#constants) \| [Inherited Constants](https://developer.android.com/reference/android/ranging/raw/RawRangingDevice#inhconstants) \| [Fields](https://developer.android.com/reference/android/ranging/raw/RawRangingDevice#lfields) \| [Methods](https://developer.android.com/reference/android/ranging/raw/RawRangingDevice#pubmethods) \| [Inherited Methods](https://developer.android.com/reference/android/ranging/raw/RawRangingDevice#inhmethods)

# RawRangingDevice

*** ** * ** ***

` public final class RawRangingDevice `   
` extends https://developer.android.com/reference/java/lang/Object ` ` implements https://developer.android.com/reference/android/os/Parcelable `

|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) ||
| ↳ | android.ranging.raw.RawRangingDevice |

<br />

*** ** * ** ***

Represents a device participating in ranging operations. This class supports multiple ranging technologies, including UWB, BLE CS, BLE RSSI and Wi-Fi NAN-RTT. The configuration for each technology is provided through corresponding parameter objects.

## Summary

| ### Nested classes ||
|---|---|
| ` class` | `https://developer.android.com/reference/android/ranging/raw/RawRangingDevice.Builder` Builder class for creating instances of `https://developer.android.com/reference/android/ranging/raw/RawRangingDevice`. |

| ### Constants ||
|---|---|
| `int` | `https://developer.android.com/reference/android/ranging/raw/RawRangingDevice#UPDATE_RATE_FREQUENT` Frequent ranging interval. |
| `int` | `https://developer.android.com/reference/android/ranging/raw/RawRangingDevice#UPDATE_RATE_INFREQUENT` Infrequent ranging interval. |
| `int` | `https://developer.android.com/reference/android/ranging/raw/RawRangingDevice#UPDATE_RATE_NORMAL` Normal ranging interval (Default). |

### Inherited constants

From interface `https://developer.android.com/reference/android/os/Parcelable` `int` `https://developer.android.com/reference/android/os/Parcelable#CONTENTS_FILE_DESCRIPTOR`

Descriptor bit used with `https://developer.android.com/reference/android/os/Parcelable#describeContents()`: indicates that the Parcelable object's flattened representation includes a file descriptor.
`int` `https://developer.android.com/reference/android/os/Parcelable#PARCELABLE_WRITE_RETURN_VALUE`

Flag for use with `https://developer.android.com/reference/android/os/Parcelable#writeToParcel(android.os.Parcel,%20int)`: the object being written is a return value, that is the result of a function such as "`Parcelable someFunction()`", "`void someFunction(out Parcelable)`", or "`void someFunction(inout Parcelable)`".

| ### Fields ||
|---|---|
| ` public static final https://developer.android.com/reference/android/os/Parcelable.Creator<https://developer.android.com/reference/android/ranging/raw/RawRangingDevice>` | `https://developer.android.com/reference/android/ranging/raw/RawRangingDevice#CREATOR` <br /> |

| ### Public methods ||
|---|---|
| ` int` | ` https://developer.android.com/reference/android/ranging/raw/RawRangingDevice#describeContents()() ` Describe the kinds of special objects contained in this Parcelable instance's marshaled representation. |
| ` https://developer.android.com/reference/android/ranging/ble/rssi/BleRssiRangingParams` | ` https://developer.android.com/reference/android/ranging/raw/RawRangingDevice#getBleRssiRangingParams()() ` Returns the BLE rssi ranging parameters, if applicable. |
| ` https://developer.android.com/reference/android/ranging/ble/cs/BleCsRangingParams` | ` https://developer.android.com/reference/android/ranging/raw/RawRangingDevice#getCsRangingParams()() ` Returns the CS ranging parameters, if applicable. |
| ` https://developer.android.com/reference/android/ranging/uwb/DlTdoaRangingParams` | ` https://developer.android.com/reference/android/ranging/raw/RawRangingDevice#getDlTdoaRangingParams()() ` Returns the DL-TDOA ranging parameters, if applicable. |
| ` https://developer.android.com/reference/android/ranging/RangingDevice` | ` https://developer.android.com/reference/android/ranging/raw/RawRangingDevice#getRangingDevice()() ` Returns the `https://developer.android.com/reference/android/ranging/RangingDevice` associated with this instance. |
| ` https://developer.android.com/reference/java/util/Map<https://developer.android.com/reference/java/lang/Integer, https://developer.android.com/reference/java/time/Duration>` | ` https://developer.android.com/reference/android/ranging/raw/RawRangingDevice#getRangingIntervalValues()() ` Returns a map of ranging technologies to their corresponding ranging interval durations for available ranging technologies parameters. |
| ` https://developer.android.com/reference/android/ranging/wifi/rtt/RttRangingParams` | ` https://developer.android.com/reference/android/ranging/raw/RawRangingDevice#getRttRangingParams()() ` Returns the RTT ranging parameters, if applicable. |
| ` https://developer.android.com/reference/android/ranging/wifi/rtt/RttStationRangingParams` | ` https://developer.android.com/reference/android/ranging/raw/RawRangingDevice#getRttStationRangingParams()() ` Returns the Wi-Fi STA-AP ranging parameters, if applicable. |
| ` https://developer.android.com/reference/android/ranging/uwb/UwbRangingParams` | ` https://developer.android.com/reference/android/ranging/raw/RawRangingDevice#getUwbRangingParams()() ` Returns the UWB ranging parameters, if applicable. |
| ` https://developer.android.com/reference/android/ranging/wifi/pd/WifiPdRangingParams` | ` https://developer.android.com/reference/android/ranging/raw/RawRangingDevice#getWifiPdRangingParams()() ` Returns the Wi-Fi PD ranging parameters, if applicable. |
| ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/android/ranging/raw/RawRangingDevice#toString()() ` Returns a string representation of the object. |
| ` void` | ` https://developer.android.com/reference/android/ranging/raw/RawRangingDevice#writeToParcel(android.os.Parcel,%20int)(https://developer.android.com/reference/android/os/Parcel dest, int flags) ` Flatten this object in to a Parcel. |

### Inherited methods

From class ` https://developer.android.com/reference/java/lang/Object ` ` https://developer.android.com/reference/java/lang/Object` ` https://developer.android.com/reference/java/lang/Object#clone()() `

Creates and returns a copy of this object.
` boolean` ` https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object)(https://developer.android.com/reference/java/lang/Object obj) `

Indicates whether some other object is "equal to" this one.
` void` ` https://developer.android.com/reference/java/lang/Object#finalize()() `

Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
` final https://developer.android.com/reference/java/lang/Class<?>` ` https://developer.android.com/reference/java/lang/Object#getClass()() `

Returns the runtime class of this `Object`.
` int` ` https://developer.android.com/reference/java/lang/Object#hashCode()() `

Returns a hash code value for the object.
` final void` ` https://developer.android.com/reference/java/lang/Object#notify()() `

Wakes up a single thread that is waiting on this object's monitor.
` final void` ` https://developer.android.com/reference/java/lang/Object#notifyAll()() `

Wakes up all threads that are waiting on this object's monitor.
` https://developer.android.com/reference/java/lang/String` ` https://developer.android.com/reference/java/lang/Object#toString()() `

Returns a string representation of the object.
` final void` ` https://developer.android.com/reference/java/lang/Object#wait(long,%20int)(long timeoutMillis, int nanos) `

Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed.
` final void` ` https://developer.android.com/reference/java/lang/Object#wait(long)(long timeoutMillis) `

Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed.
` final void` ` https://developer.android.com/reference/java/lang/Object#wait()() `

Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*.
From interface ` https://developer.android.com/reference/android/os/Parcelable ` ` abstract int` ` https://developer.android.com/reference/android/os/Parcelable#describeContents()() `

Describe the kinds of special objects contained in this Parcelable instance's marshaled representation.
` abstract void` ` https://developer.android.com/reference/android/os/Parcelable#writeToParcel(android.os.Parcel,%20int)(https://developer.android.com/reference/android/os/Parcel dest, int flags) `

Flatten this object in to a Parcel.

## Constants

### UPDATE_RATE_FREQUENT

Added in [API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public static final int UPDATE_RATE_FREQUENT
```

Frequent ranging interval.

- UWB - 96 milliseconds for config id `https://developer.android.com/reference/android/ranging/uwb/UwbRangingParams#CONFIG_PROVISIONED_UNICAST_DS_TWR_VERY_FAST`, 120 milliseconds otherwise. See `https://developer.android.com/reference/android/ranging/uwb/UwbRangingCapabilities#getSupportedRangingUpdateRates()` to verify Frequent update rate is supported.
- BLE RSSI - 500 milliseconds.
- BLE CS - 100 milliseconds.
- WiFi Rtt - 128 milliseconds if `https://developer.android.com/reference/android/ranging/wifi/rtt/RttRangingCapabilities#hasPeriodicRangingHardwareFeature()` is true, 256 milliseconds otherwise.
- WiFi PD - 128 milliseconds.

<br />

<br />

Constant Value: 3 (0x00000003)

### UPDATE_RATE_INFREQUENT

Added in [API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public static final int UPDATE_RATE_INFREQUENT
```

Infrequent ranging interval.

- UWB - 600 milliseconds.
- BLE RSSI - 3 seconds.
- BLE CS - 5 seconds.
- WiFi Rtt - 8192 milliseconds otherwise.
- WiFi PD - 512 milliseconds.

<br />

<br />

Constant Value: 2 (0x00000002)

### UPDATE_RATE_NORMAL

Added in [API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public static final int UPDATE_RATE_NORMAL
```

Normal ranging interval (Default).

- UWB - 200 milliseconds for config ids `https://developer.android.com/reference/android/ranging/uwb/UwbRangingParams#getConfigId()` with multicast ranging, 240 milliseconds for unicast.
- BLE RSSI - 1 second.
- BLE CS - 200 ms.
- WiFi Rtt - 256 milliseconds if `https://developer.android.com/reference/android/ranging/wifi/rtt/RttRangingCapabilities#hasPeriodicRangingHardwareFeature()` is true, 512 milliseconds otherwise.
- WiFi PD - 256 milliseconds.

<br />

<br />

Constant Value: 1 (0x00000001)

## Fields

### CREATOR

Added in [API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public static final Creator<RawRangingDevice> CREATOR
```

<br />

<br />

## Public methods

### describeContents

Added in [API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
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 `https://developer.android.com/reference/android/os/Parcelable#writeToParcel(android.os.Parcel,%20int)`, the return value of this method must include the `https://developer.android.com/reference/android/os/Parcelable#CONTENTS_FILE_DESCRIPTOR` bit.

<br />

| Returns ||
|---|---|
| `int` | a bitmask indicating the set of special object types marshaled by this Parcelable object instance. Value is either `0` or - `https://developer.android.com/reference/android/os/Parcelable#CONTENTS_FILE_DESCRIPTOR` |

### getBleRssiRangingParams

Added in [API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public BleRssiRangingParams getBleRssiRangingParams ()
```

Returns the BLE rssi ranging parameters, if applicable.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/ranging/ble/rssi/BleRssiRangingParams` | the `https://developer.android.com/reference/android/ranging/ble/rssi/BleRssiRangingParams`, or `null` if not set. <br /> |

### getCsRangingParams

Added in [API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public BleCsRangingParams getCsRangingParams ()
```

Returns the CS ranging parameters, if applicable.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/ranging/ble/cs/BleCsRangingParams` | the `https://developer.android.com/reference/android/ranging/ble/cs/BleCsRangingParams`, or `null` if not set. <br /> |

### getDlTdoaRangingParams

Added in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public DlTdoaRangingParams getDlTdoaRangingParams ()
```

Returns the DL-TDOA ranging parameters, if applicable.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/ranging/uwb/DlTdoaRangingParams` | the `https://developer.android.com/reference/android/ranging/uwb/DlTdoaRangingParams`, or `null` if not set. <br /> |

### getRangingDevice

Added in [API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public RangingDevice getRangingDevice ()
```

Returns the `https://developer.android.com/reference/android/ranging/RangingDevice` associated with this instance.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/ranging/RangingDevice` | the ranging device. This value cannot be `null`. <br /> |

### getRangingIntervalValues

Added in [version 36.1](https://developer.android.com/topic/libraries/support-library/revisions)

```
public Map<Integer, Duration> getRangingIntervalValues ()
```

Returns a map of ranging technologies to their corresponding ranging interval durations for available ranging technologies parameters.

The duration for each technology is determined by its configured `https://developer.android.com/` and, in some cases, technology-specific parameters like `https://developer.android.com/reference/android/ranging/uwb/UwbRangingParams#getConfigId()` for UWB.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/util/Map<https://developer.android.com/reference/java/lang/Integer, https://developer.android.com/reference/java/time/Duration>` | A non-null, possibly empty, map where keys are RangingTechnology integers and values are the calculated `https://developer.android.com/reference/java/time/Duration` for that technology's ranging interval. <br /> |

### getRttRangingParams

Added in [API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public RttRangingParams getRttRangingParams ()
```

Returns the RTT ranging parameters, if applicable.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/ranging/wifi/rtt/RttRangingParams` | the `https://developer.android.com/reference/android/ranging/wifi/rtt/RttRangingParams`, or `null` if not set. <br /> |

### getRttStationRangingParams

Added in [version 36.1](https://developer.android.com/topic/libraries/support-library/revisions)

```
public RttStationRangingParams getRttStationRangingParams ()
```

Returns the Wi-Fi STA-AP ranging parameters, if applicable.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/ranging/wifi/rtt/RttStationRangingParams` | the `https://developer.android.com/reference/android/ranging/wifi/rtt/RttStationRangingParams`, or `null` if not set. <br /> |

### getUwbRangingParams

Added in [API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public UwbRangingParams getUwbRangingParams ()
```

Returns the UWB ranging parameters, if applicable.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/ranging/uwb/UwbRangingParams` | the `https://developer.android.com/reference/android/ranging/uwb/UwbRangingParams`, or `null` if not set. <br /> |

### getWifiPdRangingParams

Added in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public WifiPdRangingParams getWifiPdRangingParams ()
```

Returns the Wi-Fi PD ranging parameters, if applicable.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/ranging/wifi/pd/WifiPdRangingParams` | the `https://developer.android.com/reference/android/ranging/wifi/pd/WifiPdRangingParams`, or `null` if not set. <br /> |

### toString

Added in [API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public String toString ()
```

Returns a string representation of the object.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/String` | a string representation of the object. <br /> |

### writeToParcel

Added in [API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public void writeToParcel (Parcel dest, 
                int flags)
```

Flatten this object in to a Parcel.

<br />

| Parameters ||
|---|---|
| `dest` | `Parcel`: This value cannot be `null`. <br /> |
| `flags` | `int`: Additional flags about how the object should be written. May be 0 or `https://developer.android.com/reference/android/os/Parcelable#PARCELABLE_WRITE_RETURN_VALUE`. Value is either `0` or a combination of the following: - `https://developer.android.com/reference/android/os/Parcelable#PARCELABLE_WRITE_RETURN_VALUE` |