RangingResultCallback


public abstract class RangingResultCallback
extends Object

java.lang.Object
   ↳ android.net.wifi.rtt.RangingResultCallback


Base class for ranging result callbacks. Should be extended by applications and set when calling WifiRttManager#startRanging(RangingRequest, java.util.concurrent.Executor, RangingResultCallback). If the ranging operation fails in whole (not attempted) then onRangingFailure(int) will be called with a failure code. If the ranging operation is performed for each of the requested peers then the onRangingResults(java.util.List) will be called with the set of results (@link RangingResult, each of which has its own success/failure code RangingResult#getStatus().

Summary

Constants

int STATUS_CODE_FAIL

A failure code for the whole ranging request operation.

int STATUS_CODE_FAIL_RTT_NOT_AVAILABLE

A failure code for the whole ranging request operation.

Public constructors

RangingResultCallback()

Public methods

abstract void onRangingFailure(int code)

Called when a ranging operation failed in whole - i.e.

abstract void onRangingResults(List<RangingResult> results)

Called when a ranging operation was executed.

Inherited methods

Constants

STATUS_CODE_FAIL

Added in API level 28
public static final int STATUS_CODE_FAIL

A failure code for the whole ranging request operation. Indicates a failure.

Constant Value: 1 (0x00000001)

STATUS_CODE_FAIL_RTT_NOT_AVAILABLE

Added in API level 28
public static final int STATUS_CODE_FAIL_RTT_NOT_AVAILABLE

A failure code for the whole ranging request operation. Indicates that the request failed due to RTT not being available - e.g. Wi-Fi was disabled. Use the WifiRttManager#isAvailable() and WifiRttManager#ACTION_WIFI_RTT_STATE_CHANGED to track RTT availability.

Constant Value: 2 (0x00000002)

Public constructors

RangingResultCallback

Added in API level 28
public RangingResultCallback ()

Public methods

onRangingFailure

Added in API level 28
public abstract void onRangingFailure (int code)

Called when a ranging operation failed in whole - i.e. no ranging operation to any of the devices specified in the request was attempted.

Parameters
code int: A status code indicating the type of failure. Value is STATUS_CODE_FAIL, or STATUS_CODE_FAIL_RTT_NOT_AVAILABLE

onRangingResults

Added in API level 28
public abstract void onRangingResults (List<RangingResult> results)

Called when a ranging operation was executed. The list of results corresponds to devices specified in the ranging request.

Parameters
results List: List of range measurements, one per requested device. This value cannot be null.