Kullanıcıların bir etkinliği ne zaman başlattığını veya sonlandırdığını algılama

Uygulamanızı, kullanıcının yürüme, bisiklete binme veya araç kullanma gibi belirli bir etkinliğe ne zaman başladığını ya da ne zaman durduğunu belirleyecek şekilde tasarlamanız gerekebilir. Örneğin, bir kilometre takip uygulaması, kullanıcı sürüşe başladığında kilometre takibine başlayabilir veya bir mesajlaşma uygulaması, kullanıcı sürüşü durdurana kadar tüm görüşmeleri sessize alabilir.

Hareket Tanıma Geçiş API'si, kullanıcının etkinliğindeki değişiklikleri algılamak için kullanılabilir. Uygulamanız, ilgilenilen etkinliklerdeki bir geçişe abone olur ve API, uygulamanızı yalnızca gerektiğinde bilgilendirir. Bu sayfada, kısaca Geçiş API'si olarak da adlandırılan Hareket Tanıma Geçiş API'sinin nasıl kullanılacağı gösterilmektedir.

Projenizi oluşturma

Uygulamanızda Transition API'yi kullanmak için Google Konum ve Hareket Tanıma API'nin 12.0.0 veya daha yeni bir sürümüne bağımlılık beyan etmeniz ve uygulama manifestinde com.google.android.gms.permission.ACTIVITY_RECOGNITION iznini belirtmeniz gerekir.

  1. API'ye bağımlılık bildirmek için Google Maven deposuna bir referans ekleyin ve uygulamanızın build.gradle dosyasının bağımlılıklar bölümüne com.google.android.gms:play-services-location:12.0.0 için bir uygulama girişi ekleyin. Daha fazla bilgi için Google Play Hizmetleri'ni Kurma başlıklı makaleyi inceleyin.
  2. com.google.android.gms.permission.ACTIVITY_RECOGNITION iznini belirtmek için uygulama manifestine aşağıdaki örnekte gösterildiği gibi bir <uses-permission> öğesi ekleyin:

    <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>
    

Aktivite geçişi güncellemelerine kaydolma

Aktivite geçişleriyle ilgili bildirim almaya başlamak için aşağıdakileri uygulamanız gerekir:

ActivityTransitionRequest nesnesini oluşturmak için, bildirim almak istediğiniz geçişi temsil eden ActivityTransition nesnelerinin bir listesini oluşturmanız gerekir. ActivityTransition nesnesi aşağıdaki verileri içerir:

Aşağıdaki kodda ActivityTransition nesnelerinin listesinin nasıl oluşturulacağı gösterilmektedir:

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());

Aşağıdaki örnekte gösterildiği gibi, ActivityTransitions listesini ActivityTransitionRequest sınıfına ileterek bir ActivityTransitionRequest nesnesi oluşturabilirsiniz:

Kotlin

val request = ActivityTransitionRequest(transitions)

Java

ActivityTransitionRequest request = new ActivityTransitionRequest(transitions);

ActivityTransitionRequest örneğinizi ve PendingIntent nesnenizi requestActivityTransitionUpdates() yöntemine ileterek aktivite geçişi güncellemelerine kaydolabilirsiniz. requestActivityTransitionUpdates() yöntemi, aşağıdaki kod örneğinde gösterildiği gibi başarı veya başarısızlık durumunu kontrol edebileceğiniz bir Task nesnesi döndürür:

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
        }
    }
);

Uygulamanız, aktivite geçişi güncellemelerine başarıyla kaydolduktan sonra kayıtlı PendingIntent içinde bildirimler alır.

Aktivite geçişi etkinliklerini işleme

İstenen etkinlik geçişi gerçekleştiğinde uygulamanız bir Intent geri çağırma alır. Intent nesnesinden bir ActivityTransitionResult nesnesi çıkarabilirsiniz. Bu nesne, ActivityTransitionEvent nesnelerinin bir listesini içerir. Etkinlikler kronolojik olarak sıralanır. Örneğin, bir uygulama ACTIVITY_TRANSITION_ENTER ve ACTIVITY_TRANSITION_EXIT geçişlerinde IN_VEHICLE etkinlik türünü isterse kullanıcı araç kullanmaya başladığında bir ActivityTransitionEvent nesnesi, başka bir etkinliğe geçtiğinde ise başka bir nesne alır.

BroadcastReceiver alt sınıfını oluşturup onReceive yöntemini uygulayarak geri çağırma işlevinizi uygulayabilir ve aktivite geçiş etkinliklerinin listesini alabilirsiniz. Daha fazla bilgi için Yayınlar başlıklı makaleyi inceleyin. Aşağıdaki örnekte, onReceive yönteminin nasıl uygulanacağı gösterilmektedir:

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....
        }
    }
}

Aktivite geçişi güncellemeleri için kaydı iptal etme

Aşağıdaki örnekte gösterildiği gibi, ActivityRecognitionClient sınıfının removeActivityTransitionUpdates() yöntemini çağırıp PendingIntent nesnenizi parametre olarak ileterek aktivite geçişi güncellemelerinin kaydını iptal edebilirsiniz:

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());
        }
    }
);

Ek kaynaklar

Kullanıcı etkinliği tanıma API'sinin kullanımı hakkında daha fazla bilgi edinmek için aşağıdaki materyalleri inceleyin:

Örnekler

Kullanıcı etkinliği tanıma ile ilgili en iyi uygulamaları gösteren örnek.