ব্যবহারকারী কখন কোনও অ্যাক্টিভিটি শুরু বা শেষ করছেন তা শনাক্ত করা

ব্যবহারকারী কখন হাঁটা, বাইক চালানো বা গাড়ি চালানোর মতো কোনও নির্দিষ্ট অ্যাক্টিভিটি শুরু বা বন্ধ করেন তা শনাক্ত করার জন্য আপনার অ্যাপ ডিজাইন করার প্রয়োজন হতে পারে। যেমন, কোনও ব্যবহারকারী গাড়ি চালানো শুরু করলে, মাইলেজ ট্র্যাকিং অ্যাপ মাইল ট্র্যাক করা শুরু করতে পারে অথবা ব্যবহারকারী গাড়ি চালানো বন্ধ না করা পর্যন্ত মেসেজিং অ্যাপ সব কথোপকথন মিউট করতে পারে।

ব্যবহারকারীর অ্যাক্টিভিটিতে পরিবর্তন শনাক্ত করতে Activity Recognition Transition API ব্যবহার করা যেতে পারে। আপনার অ্যাপ, আগ্রহের অ্যাক্টিভিটির ট্রানজিশনে সাবস্ক্রাইব করে এবং API শুধুমাত্র প্রয়োজন হলে আপনার অ্যাপকে বিজ্ঞপ্তি পাঠায়। এই পৃষ্ঠায় দেখানো হয়েছে যে কীভাবে অ্যাক্টিভিটি শনাক্তকরণ ট্রানজিশন API ব্যবহার করতে হয়, যাকে সংক্ষেপে ট্রানজিশন API বলা হয়।

আপনার প্রোজেক্ট সেট-আপ করুন

আপনার অ্যাপে ট্রানজিশন API ব্যবহার করতে, আপনাকে অবশ্যই Google লোকেশন এবং অ্যাক্টিভিটি শনাক্তকরণ API ভার্সন ১২.০.০ বা তার বেশি ভার্সনের উপর নির্ভরতা ঘোষণা করতে হবে এবং অ্যাপ ম্যানিফেস্টে com.google.android.gms.permission.ACTIVITY_RECOGNITION অনুমতি নির্দিষ্ট করতে হবে।

  1. API-তে ডিপেন্ডেন্সি ঘোষণা করতে, Google Maven রিপোজিটরিতে একটি রেফারেন্স যোগ করুন এবং আপনার অ্যাপের build.gradle ফাইলের ডিপেন্ডেন্সি বিভাগে com.google.android.gms:play-services-location:12.0.0-এ একটি ইমপ্লিমেন্টেশন এন্ট্রি যোগ করুন। আরও তথ্যের জন্য, Google Play Services সেট-আপ করুন দেখুন।
  2. com.google.android.gms.permission.ACTIVITY_RECOGNITION অনুমতি নির্দিষ্ট করতে, অ্যাপ ম্যানিফেস্টে <uses-permission> এলিমেন্ট যোগ করুন, যেমন নিম্নলিখিত উদাহরণে দেখানো হয়েছে:

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

অ্যাক্টিভিটি ট্রানজিশন আপডেটের জন্য রেজিস্টার করুন

অ্যাক্টিভিটি ট্রানজিশন সম্পর্কে বিজ্ঞপ্তি পাওয়া শুরু করতে, আপনাকে নিম্নলিখিতগুলি প্রয়োগ করতে হবে:

ActivityTransitionRequest অবজেক্ট তৈরি করতে, আপনাকে অবশ্যই ActivityTransition অবজেক্টের একটি তালিকা তৈরি করতে হবে, যা আপনি যে ট্রানজিশন সম্পর্কে বিজ্ঞপ্তি পেতে চান তা দেখায়। ActivityTransition অবজেক্টে নিম্নলিখিত ডেটা অন্তর্ভুক্ত থাকে:

নিম্নলিখিত কোড থেকে জানা যায় যে কীভাবে 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()

জাভা

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

আপনি ActivityTransitionRequest ক্লাসে ActivityTransitions-এর তালিকা পাস করে ActivityTransitionRequest অবজেক্ট তৈরি করতে পারবেন, যেমনটি নিম্নলিখিত উদাহরণে দেখানো হয়েছে:

Kotlin

val request = ActivityTransitionRequest(transitions)

জাভা

ActivityTransitionRequest request = new ActivityTransitionRequest(transitions);

আপনি ActivityTransitionRequest-এর ইনস্ট্যান্স এবং PendingIntent অবজেক্ট requestActivityTransitionUpdates() পদ্ধতিতে পাস করে অ্যাক্টিভিটি ট্রানজিশন আপডেটের জন্য রেজিস্টার করতে পারবেন। requestActivityTransitionUpdates() পদ্ধতিটি একটি Task অবজেক্ট রিটার্ন করে যা আপনি সফল বা ব্যর্থতার জন্য চেক করতে পারেন, যেমনটি নিম্নলিখিত কোড উদাহরণে দেখানো হয়েছে:

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
}

জাভা

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

অ্যাক্টিভিটি ট্রানজিশন আপডেটের জন্য রেজিস্টার করার পরে, আপনার অ্যাপ রেজিস্টার করা PendingIntent-এ বিজ্ঞপ্তি পায়।

অ্যাক্টিভিটি ট্রানজিশন ইভেন্ট প্রসেস করুন

অনুরোধ করা অ্যাক্টিভিটি ট্রানজিশন হলে, আপনার অ্যাপ একটি Intent কলব্যাক পায়। আপনি Intent থেকে একটি ActivityTransitionResult অবজেক্ট এক্সট্র্যাক্ট করতে পারবেন, যার মধ্যে ActivityTransitionEvent অবজেক্টের একটি তালিকা অন্তর্ভুক্ত আছে। ইভেন্টগুলি কালানুক্রমিকভাবে সাজানো হয়; উদাহরণস্বরূপ, যদি কোনও অ্যাপ ACTIVITY_TRANSITION_ENTER এবং ACTIVITY_TRANSITION_EXIT ট্রানজিশনে IN_VEHICLE অ্যাক্টিভিটি টাইপের অনুরোধ করে, তাহলে ব্যবহারকারী গাড়ি চালানো শুরু করলে এটি একটি ActivityTransitionEvent অবজেক্ট পায় এবং ব্যবহারকারী অন্য কোনও অ্যাক্টিভিটিতে ট্রানজিশন করলে আরেকটি অবজেক্ট পায়।

আপনি BroadcastReceiver-এর সাবক্লাস তৈরি করে এবং অ্যাক্টিভিটি ট্রানজিশন ইভেন্টের তালিকা পেতে onReceive পদ্ধতি প্রয়োগ করে আপনার কলব্যাক প্রয়োগ করতে পারবেন। আরও তথ্যের জন্য, ব্রডকাস্ট দেখুন। নিচের উদাহরণে দেখানো হয়েছে যে কীভাবে 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....
        }
    }
}

জাভা

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

অ্যাক্টিভিটি ট্রানজিশন আপডেট থেকে রেজিস্টার বাতিল করুন

আপনি ActivityRecognitionClient-এর removeActivityTransitionUpdates() পদ্ধতি কল করে এবং প্যারামিটার হিসেবে আপনার PendingIntent অবজেক্ট পাস করে অ্যাক্টিভিটি ট্রানজিশন আপডেট থেকে ডিরেজিস্টার করতে পারবেন, যেমনটি নিম্নলিখিত উদাহরণে দেখানো হয়েছে:

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

জাভা

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

অতিরিক্ত রিসোর্স

ব্যবহারকারীর অ্যাক্টিভিটি শনাক্তকরণ API-এর ব্যবহার সম্পর্কে আরও জানতে, নিম্নলিখিত তথ্য দেখুন:

নমুনা

ব্যবহারকারীর অ্যাক্টিভিটি শনাক্তকরণের জন্য পেশাদার পদ্ধতি প্রদর্শন করতে স্যাম্পেল।