Rileva quando gli utenti iniziano o terminano un'attività

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.

  1. 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.0 nella sezione delle dipendenze del file build.gradle della tua app. Per saperne di più, consulta Configura Google Play Services.
  2. 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:

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:

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.