MeasureClient

fun getCapabilitiesAsync(): ListenableFuture<MeasureCapabilities>

Returns the MeasureCapabilities of this client for the device.

This can be used to determine what DeltaDataTypes this device supports for live measurement. Clients should use the capabilities to inform their requests since Health Services will typically reject requests made for DeltaDataTypes which are not enabled for measurement.

fun registerMeasureCallback(
    dataType: DeltaDataType<*, *>,
    callback: MeasureCallback
): Unit

Registers the app for live measurement of the specified DeltaDataType.

The callback will be called on the main application thread. To move calls to an alternative thread use registerMeasureCallback.

Even if data is registered for live capture, it can still be sent out in batches depending on the application processor state.

Registering a DeltaDataType for live measurement capture is expected to increase the sample rate on the associated sensor(s); this is typically used for one-off measurements. Do not use this method for background capture or workout tracking. The client is responsible for ensuring that their requested DeltaDataType is supported on this device by checking the MeasureCapabilities. The returned future will fail if the request is not supported on a given device.

The callback will continue to be called until the app is killed or unregisterMeasureCallbackAsync is called.

If the same callback is already registered for the given DeltaDataType, this operation is a no-op.

fun registerMeasureCallback(
    dataType: DeltaDataType<*, *>,
    executor: Executor,
    callback: MeasureCallback
): Unit

Same as registerMeasureCallback, except the callback is called on the given Executor.

fun unregisterMeasureCallbackAsync(
    dataType: DeltaDataType<*, *>,
    callback: MeasureCallback
): ListenableFuture<Void>

Unregisters the given MeasureCallback for updates of the given DeltaDataType.

suspend fun MeasureClient.getCapabilities(): MeasureCapabilities

Returns the MeasureCapabilities of this client for the device.

This can be used to determine what DeltaDataTypes this device supports for live measurement. Clients should use the capabilities to inform their requests since Health Services will typically reject requests made for DeltaDataTypes which are not enabled for measurement.

suspend fun MeasureClient.unregisterMeasureCallback(
    dataType: DeltaDataType<*, *>,
    callback: MeasureCallback
): Void

Unregisters the given MeasureCallback for updates of the given DeltaDataType.