RecordingClient

public class RecordingClient extends GoogleApi<Api.ApiOptions.HasGoogleSignInAccountOptions>

Client which enables low-power, always-on background collection of sensor data into the Google Fit store. Sensor subscriptions are active when the requesting app is not running, and persisted through system restarts. Collected data can be queried using the History Client.

Unlike the Sensors Client, the Recording Client does not support delivery of live sensor events. When live data is needed (such as when the app is open in the foreground), a listener should be added with the Sensors Client. An app can have both an active subscription and an active listener at the same time. Unlike listeners, subscriptions don't need to be removed and re-added periodically.

The Recording Client should be accessed from the Fitness entry point. Example:

    GoogleSignInOptionsExtension fitnessOptions =
        FitnessOptions.builder()
            .addDataType(DataType.TYPE_ACTIVITY_SAMPLES, FitnessOptions.ACCESS_READ)
            .build();

    GoogleSignInAccount googleSignInAccount =
        GoogleSignIn.getAccountForExtension(this, fitnessOptions);

    // Samples the user's activity once per minute.
    Task<Void> response = Fitness.getRecordingClient(this, googleSignInAccount)
        .subscribe(DataType.TYPE_ACTIVITY_SAMPLES);
 

Creating a subscription for a particular data type requires user permission for access to data of that type, and permissions can be revoked by the user through Google Play Services settings.

Inherited Field Summary

From class com.google.android.gms.common.api.GoogleApi

protected final GoogleApiManager

zabo

Public Method Summary

Task<List<Subscription>>	listSubscriptions() Reads all existing subscriptions for the current application.
Task<List<Subscription>>	listSubscriptions(DataType dataType) Reads all existing subscriptions for the current application to a particular data type.
Task<Void>	subscribe(DataSource dataSource) Subscribe to background collection of data from a specific source on behalf of the current application.
Task<Void>	subscribe(DataType dataType) Subscribe to background collection of data of a specific type on behalf of the current application.
Task<Void>	unsubscribe(Subscription subscription) Unsubscribes from background data collection for the current application.
Task<Void>	unsubscribe(DataType dataType) Unsubscribes from background data collection for the current application for a particular data type.
Task<Void>	unsubscribe(DataSource dataSource) Unsubscribes from background data collection for the current application for a particular data source.

Inherited Method Summary

From class com.google.android.gms.common.api.GoogleApi

GoogleApiClient	asGoogleApiClient()
ClientSettings.Builder	createClientSettingsBuilder()
Task<Boolean>	disconnectService()
<A extends Api.AnyClient, T extends ApiMethodImpl<? extends Result, A>> T	doBestEffortWrite(T arg0)
<TResult, A extends Api.AnyClient> Task<TResult>	doBestEffortWrite(TaskApiCall<A, TResult> arg0)
<A extends Api.AnyClient, T extends ApiMethodImpl<? extends Result, A>> T	doRead(T arg0)
<TResult, A extends Api.AnyClient> Task<TResult>	doRead(TaskApiCall<A, TResult> arg0)
<A extends Api.AnyClient> Task<Void>	doRegisterEventListener(RegistrationMethods<A, ?> arg0)
<A extends Api.AnyClient, T extends RegisterListenerMethod<A, ?>, U extends UnregisterListenerMethod<A, ?>> Task<Void>	doRegisterEventListener(T arg0, U arg1)
Task<Boolean>	doUnregisterEventListener(ListenerKey<?> arg0)
<TResult, A extends Api.AnyClient> Task<TResult>	doWrite(TaskApiCall<A, TResult> arg0)
<A extends Api.AnyClient, T extends ApiMethodImpl<? extends Result, A>> T	doWrite(T arg0)
final Api<Api.ApiOptions.HasGoogleSignInAccountOptions>	getApi()
ApiKey<Api.ApiOptions.HasGoogleSignInAccountOptions>	getApiKey()
Api.ApiOptions.HasGoogleSignInAccountOptions	getApiOptions()
Context	getApplicationContext()
final int	getInstanceId()
Looper	getLooper()
<L> ListenerHolder<L>	registerListener(L arg0, String arg1)
zace	zaa(Context arg0, Handler arg1)
Api.Client	zaa(Looper arg0, zaa<Api.ApiOptions.HasGoogleSignInAccountOptions> arg1)

From class java.lang.Object

Object	clone()
boolean	equals(Object arg0)
void	finalize()
final Class<?>	getClass()
int	hashCode()
final void	notify()
final void	notifyAll()
String	toString()
final void	wait(long arg0, int arg1)
final void	wait(long arg0)
final void	wait()

From interface com.google.android.gms.common.api.HasApiKey

abstract ApiKey<Api.ApiOptions.HasGoogleSignInAccountOptions>

getApiKey()

Public Methods

public Task<List<Subscription>> listSubscriptions ()

Reads all existing subscriptions for the current application.

Returns

• a task containing the found subscriptions.

public Task<List<Subscription>> listSubscriptions (DataType dataType)

Reads all existing subscriptions for the current application to a particular data type.

Parameters

dataType	list only subscriptions to this data type

Returns

• a task containing the found subscriptions.

public Task<Void> subscribe (DataSource dataSource)

Subscribe to background collection of data from a specific source on behalf of the current application.

After the subscription is successfully added, new data points in the requested data stream are persisted to the Google Fit store, and can be queried via the History Client.

If after the subscription is added the data source becomes unavailable (it may be disconnected or disabled, for instance), the subscription remains active, and recording resumes once the data source becomes available again. Data points from the time interval when the data source was unavailable may or may not be recorded, depending on whether batching is supported.

Note that not all data sources are available at all times (external devices may go offline, for instance). If no data sources matching the subscription are currently available, the request will succeed silently. Once data sources become available, recording of data will start.

If the requested subscription already exists, the request will be a no-op.

Subscribing to a DataSource which derives from data collected using activity recognition will require the ACTIVITY_RECOGNITION runtime permission if your app is targeting API level 29. If the permission is lost during recording, the registration will be removed.

Data types which will trigger activity collection include:

• step counts
• calories expended
• activity segments
• distance deltas

Parameters

dataSource	the data source to subscribe to.

Throws

SecurityException	if a required permission is missing for the requested DataSource.

public Task<Void> subscribe (DataType dataType)

Subscribe to background collection of data of a specific type on behalf of the current application.

Specifying a data type instead of a data source means that the default data source will be used to serve this request. The default is based on the data type and the available data sources. The default data source could be a combined data source, and its data might be averaged or filtered. As new data sources for the data type become available, the default data source might change.

After the subscription is successfully added, new data points in the requested data stream are persisted to the Google Fit store, and can be queried via the History Client.

If after the subscription is added the data source becomes unavailable (it may be disconnected or disabled, for instance), the subscription remains active, and recording resumes once the data source becomes available again. Data points from the time interval when the data source was unavailable may or may not be recorded, depending on whether batching is supported.

Note that not all data sources are available at all times (external devices may go offline, for instance). If no data sources matching the subscription are currently available, the request will succeed silently. Once data sources become available, recording of data will start.

If the requested subscription already exists, the request will be a no-op.

Subscribing to a DataType which derives from data collected using activity recognition will require the ACTIVITY_RECOGNITION runtime permission if your app is targeting API level 29. If the permission is lost during recording, the registration will be removed.

Data types which will trigger activity collection include:

• step counts
• calories expended
• activity segments
• distance deltas

Parameters

dataType	the data type to subscribe to.

Throws

SecurityException	if a required permission is missing for the requested DataType.

public Task<Void> unsubscribe (Subscription subscription)

Unsubscribes from background data collection for the current application. Should be called when the application no longer wishes to record data.

Parameters

subscription	the subscription to remove

public Task<Void> unsubscribe (DataType dataType)

Unsubscribes from background data collection for the current application for a particular data type. Should be called when the application no longer wishes to record data.

Parameters

dataType	the data type to remove. All subscriptions to the particular data type will be removed

public Task<Void> unsubscribe (DataSource dataSource)

Unsubscribes from background data collection for the current application for a particular data source. Should be called when the application no longer wishes to record data.

Parameters

dataSource	the data source to unsubscribe from