Potrebbe essere necessario progettare l'app in modo che identifichi quando un utente inizia o interrompe un'attività specifica, ad esempio camminare, andare in bicicletta o guidare. Ad esempio, un'app di monitoraggio del chilometraggio potrebbe iniziare a monitorare i chilometri quando un utente inizia a guidare oppure un'app di messaggistica potrebbe disattivare l'audio di tutte le conversazioni finché l'utente non smette di guidare.
L'API Activity Recognition Transition può essere utilizzata per rilevare i cambiamenti nell'attività dell'utente. La tua app si iscrive a una transizione nelle attività di interesse e l'API la avvisa solo quando necessario. Questa pagina mostra come utilizzare l'API Activity Recognition Transition, chiamata anche API Transition.
Configura il progetto
Per utilizzare l'API Transition nella tua app, devi dichiarare una dipendenza dall'API Google Location and Activity Recognition versione 12.0.0 o successive e specificare l'autorizzazione com.google.android.gms.permission.ACTIVITY_RECOGNITION nel file manifest dell'app.
- Per dichiarare una dipendenza dall'API, aggiungi un riferimento al repository Maven di Google e una voce di implementazione a
com.google.android.gms:play-services-location:12.0.0nella sezione delle dipendenze del filebuild.gradledella tua app. Per saperne di più, consulta Configura Google Play Services. Per specificare l'autorizzazione
com.google.android.gms.permission.ACTIVITY_RECOGNITION, aggiungi un elemento<uses-permission>nel manifest dell'app, come mostrato nell'esempio seguente:<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.example.myapp"> <uses-permission android:name="com.google.android.gms.permission.ACTIVITY_RECOGNITION" /> … </manifest>
Registrati per ricevere aggiornamenti sulla transizione delle attività
Per iniziare a ricevere notifiche sulle transizioni di attività, devi implementare quanto segue:
- Un oggetto
ActivityTransitionRequestche specifica il tipo di attività e transizione. - Un callback
PendingIntentin cui la tua app riceve le notifiche. Per saperne di più, consulta Utilizzo di un pending intent.
Per creare l'oggetto ActivityTransitionRequest, devi creare un elenco di oggetti ActivityTransition, che rappresentano la transizione per cui vuoi ricevere notifiche. Un oggetto ActivityTransition include i
seguenti dati:
- Un tipo di attività, rappresentato dalla classe
DetectedActivity. L'API Transition supporta le seguenti attività: - Un tipo di transizione
ACTIVITY_TRANSITION_ENTERoACTIVITY_TRANSITION_EXIT. Per saperne di più, consulta la classeActivityTransition.
Il seguente codice mostra come creare un elenco di oggetti ActivityTransition:
Kotlin
val transitions = mutableListOf<ActivityTransition>()
transitions +=
ActivityTransition.Builder()
.setActivityType(DetectedActivity.IN_VEHICLE)
.setActivityTransition(ActivityTransition.ACTIVITY_TRANSITION_ENTER)
.build()
transitions +=
ActivityTransition.Builder()
.setActivityType(DetectedActivity.IN_VEHICLE)
.setActivityTransition(ActivityTransition.ACTIVITY_TRANSITION_EXIT)
.build()
transitions +=
ActivityTransition.Builder()
.setActivityType(DetectedActivity.WALKING)
.setActivityTransition(ActivityTransition.ACTIVITY_TRANSITION_EXIT)
.build()
Java
List<ActivityTransition> transitions = new ArrayList<>();
transitions.add(
new ActivityTransition.Builder()
.setActivityType(DetectedActivity.IN_VEHICLE)
.setActivityTransition(ActivityTransition.ACTIVITY_TRANSITION_ENTER)
.build());
transitions.add(
new ActivityTransition.Builder()
.setActivityType(DetectedActivity.IN_VEHICLE)
.setActivityTransition(ActivityTransition.ACTIVITY_TRANSITION_EXIT)
.build());
transitions.add(
new ActivityTransition.Builder()
.setActivityType(DetectedActivity.WALKING)
.setActivityTransition(ActivityTransition.ACTIVITY_TRANSITION_EXIT)
.build());
Puoi creare un oggetto ActivityTransitionRequest passando l'elenco di
ActivityTransitions alla classe ActivityTransitionRequest, come mostrato nell'esempio
seguente:
Kotlin
val request = ActivityTransitionRequest(transitions)
Java
ActivityTransitionRequest request = new ActivityTransitionRequest(transitions);
Puoi registrarti per ricevere gli aggiornamenti sulle transizioni di attività passando la tua istanza di
ActivityTransitionRequest e il tuo oggetto PendingIntent al
metodo requestActivityTransitionUpdates(). Il metodo requestActivityTransitionUpdates() restituisce un oggetto Task che puoi controllare per verificare l'esito positivo o negativo, come mostrato nell'esempio di codice seguente:
Kotlin
// myPendingIntent is the instance of PendingIntent where the app receives callbacks.
val task = ActivityRecognition.getClient(context)
.requestActivityTransitionUpdates(request, myPendingIntent)
task.addOnSuccessListener {
// Handle success
}
task.addOnFailureListener { e: Exception ->
// Handle error
}
Java
// myPendingIntent is the instance of PendingIntent where the app receives callbacks.
Task<Void> task = ActivityRecognition.getClient(context)
.requestActivityTransitionUpdates(request, myPendingIntent);
task.addOnSuccessListener(
new OnSuccessListener<Void>() {
@Override
public void onSuccess(Void result) {
// Handle success
}
}
);
task.addOnFailureListener(
new OnFailureListener() {
@Override
public void onFailure(Exception e) {
// Handle error
}
}
);
Dopo aver eseguito la registrazione per gli aggiornamenti delle transizioni di attività, la tua app riceve notifiche nel PendingIntent registrato.
Elabora gli eventi di transizione dell'attività
Quando si verifica la transizione dell'attività richiesta, la tua app riceve un callback Intent. Puoi estrarre un oggetto ActivityTransitionResult da Intent, che include un elenco di oggetti ActivityTransitionEvent. Gli eventi sono ordinati
cronologicamente; ad esempio, se un'app richiede il tipo di attività IN_VEHICLE
per le transizioni ACTIVITY_TRANSITION_ENTER e
ACTIVITY_TRANSITION_EXIT, riceve un
oggetto ActivityTransitionEvent quando l'utente inizia a guidare e un altro
quando l'utente passa a un'altra attività.
Puoi implementare il callback creando una sottoclasse di
BroadcastReceiver e implementando il metodo onReceive per ottenere
l'elenco degli eventi di transizione dell'attività. Per saperne di più, consulta
Trasmissioni. L'esempio seguente mostra come implementare il metodo onReceive:
Kotlin
override fun onReceive(context: Context, intent: Intent) {
if (ActivityTransitionResult.hasResult(intent)) {
val result = ActivityTransitionResult.extractResult(intent)!!
for (event in result.transitionEvents) {
// chronological sequence of events....
}
}
}
Java
@Override
public void onReceive(Context context, Intent intent) {
if (ActivityTransitionResult.hasResult(intent)) {
ActivityTransitionResult result = ActivityTransitionResult.extractResult(intent);
for (ActivityTransitionEvent event : result.getTransitionEvents()) {
// chronological sequence of events....
}
}
}
Annulla la registrazione per gli aggiornamenti sulla transizione dell'attività
Puoi annullare la registrazione per gli aggiornamenti delle transizioni di attività chiamando il metodo removeActivityTransitionUpdates() di ActivityRecognitionClient e passando l'oggetto PendingIntent come parametro, come mostrato nell'esempio seguente:
Kotlin
// myPendingIntent is the instance of PendingIntent where the app receives callbacks.
val task = ActivityRecognition.getClient(context)
.removeActivityTransitionUpdates(myPendingIntent)
task.addOnSuccessListener {
myPendingIntent.cancel()
}
task.addOnFailureListener { e: Exception ->
Log.e("MYCOMPONENT", e.message)
}
Java
// myPendingIntent is the instance of PendingIntent where the app receives callbacks.
Task<Void> task = ActivityRecognition.getClient(context)
.removeActivityTransitionUpdates(myPendingIntent);
task.addOnSuccessListener(
new OnSuccessListener<Void>() {
@Override
public void onSuccess(Void result) {
myPendingIntent.cancel();
}
}
);
task.addOnFailureListener(
new OnFailureListener() {
@Override
public void onFailure(Exception e) {
Log.e("MYCOMPONENT", e.getMessage());
}
}
);
Risorse aggiuntive
Per scoprire di più sull'utilizzo dell'API User Activity Recognition, consulta i seguenti materiali:
Esempi
Esempio per dimostrare le best practice per il riconoscimento dell'attività utente.