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.
- API'ye bağımlılık bildirmek için Google Maven deposuna bir referans ekleyin ve uygulamanızın
build.gradledosyasının bağımlılıklar bölümünecom.google.android.gms:play-services-location:12.0.0için bir uygulama girişi ekleyin. Daha fazla bilgi için Google Play Hizmetleri'ni Kurma başlıklı makaleyi inceleyin. com.google.android.gms.permission.ACTIVITY_RECOGNITIONiznini 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:
- Etkinlik ve geçiş türünü belirten bir
ActivityTransitionRequestnesnesi. - Uygulamanızın bildirim aldığı bir
PendingIntentgeri çağırma işlevi. Daha fazla bilgi için Beklemede olan intent kullanma başlıklı makaleyi inceleyin.
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:
DetectedActivitysınıfıyla temsil edilen bir etkinlik türü. Transition API aşağıdaki etkinlikleri destekler:ACTIVITY_TRANSITION_ENTERveyaACTIVITY_TRANSITION_EXITgeçiş türü. Daha fazla bilgi içinActivityTransitionsınıfına bakın.
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.