Assistant-এ ডায়নামিক শর্টকাট পুশ করুন

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

যেমন, আপনার নোট নেওয়ার অ্যাপে ব্যবহারকারীর তৈরি করা প্রতিটি নোটের জন্য আপনি একটি শর্টকাট পুশ করতে পারেন। আপনার প্রোজেক্টে Google Shortcuts Integration Jetpack লাইব্রেরি যোগ করে, আপনি Assistant-এর মতো Google সারফেসে দেখানোর জন্য ডায়নামিক লিঙ্ক উপযুক্ত করে তোলেন। এই লাইব্রেরি Assistant-কে আপনার পুশ করা ডায়নামিক শর্টকাট নিতে দেয়, যা আপনি ShortcutManagerCompat ক্লাস ব্যবহার করে করেন। এটি ShortcutManager API-এর জন্য Jetpack র‍্যাপার।

আপনার অ্যাপে Google শর্টকাট ইন্টিগ্রেশন লাইব্রেরি ব্যবহার করলে, Google-এ পুশ করা ডায়নামিক শর্টকাট, ব্যবহারকারীরা Assistant অ্যাপে ভয়েস শর্টকাট সাজেশন হিসেবে দেখতে পাবেন। আপনি ShortcutManagerCompat লাইব্রেরির pushDynamicShortcut() পদ্ধতি ব্যবহার করে Assistant-এ আনলিমিটেড সংখ্যক ডায়নামিক শর্টকাট পুশ করতে পারবেন।

আপনার ডেভেলপমেন্ট প্রোজেক্ট কনফিগার করুন

আপনার অ্যাপে ডায়নামিক শর্টকাট কার্যকারিতা যোগ করতে Google Shortcuts Integration লাইব্রেরি প্রয়োজন, যা একটি Android Jetpack লাইব্রেরি। এই লাইব্রেরি অন্তর্ভুক্ত করার জন্য আপনার অ্যাপ ডেভেলপমেন্ট প্রোজেক্ট কীভাবে কনফিগার করবেন তা এই বিভাগে বর্ণনা করা হয়েছে।

এই Jetpack লাইব্রেরি যোগ করতে এবং আপনার প্রোজেক্ট কনফিগার করতে, এই ধাপগুলি অনুসরণ করুন:

  1. Jetpack লাইব্রেরি ম্যানেজ করতে আপনার gradle.properties ফাইল আপডেট করুন:

    gradle.properties

    android.useAndroidX=true
# Automatically convert third-party libraries to use AndroidX
android.enableJetifier=true

  2. আপনার build.gradle-এ Jetpack লাইব্রেরি ডিপেন্ডেন্সি যোগ করুন:

    app/build.gradle

    dependencies {
 implementation "androidx.core:core:1.6.0"
 implementation "androidx.core:core-google-shortcuts:1.0.1"
 ...
}

    আগের স্যাম্পেল কোডে, আপনি দুটি Jetpack লাইব্রেরিকে ডিপেন্ডেন্সি হিসেবে তালিকাভুক্ত করেছেন। androidx.core:core:1.6.0 লাইব্রেরিতে ShortcutManagerCompat ক্লাস থাকে, যা আপনি Google-এ ডায়নামিক শর্টকাট পুশ করতে ব্যবহার করেন।

    androidx.core:core-google-shortcuts:1.0.1 হল Google Shortcuts Integration লাইব্রেরি। এই লাইব্রেরিতে ডেভেলপার-ফেসিং API নেই। ডিপেনডেন্সি হিসেবে এটি যোগ করার মাধ্যমে, আপনি Assistant-কে ShortcutManagerCompat ক্লাস ব্যবহার করে পুশ করা ডায়নামিক শর্টকাট গ্রহণ করার অনুমতি দেন।

ডায়নামিক শর্টকাট পুশ করুন

Assistant-এ দেখানোর জন্য উপযুক্ত ডায়নামিক শর্টকাট পুশ করতে, প্রথমে ShortcutInfoCompat.Builder() ক্লাস ব্যবহার করে শর্টকাট তৈরি করুন।

তারপর আপনি ShortcutManagerCompat.pushDynamicShortcut() পদ্ধতি ব্যবহার করে শর্টকাট পুশ করেন। ব্যবহারকারী আপনার অ্যাপে কোনও প্রাসঙ্গিক অ্যাকশন সম্পূর্ণ করলেই শর্টকাট পুশ করা হয়। নিম্নলিখিত স্যাম্পেল কোডটি ব্যবহারকারী নোট ও তালিকা অ্যাপে তালিকা তৈরি করলেই শর্টকাট পুশ করে।

ExampleOrderActivity

Kotlin

// Define the dynamic shortcut for an item
var intent = Intent(context, DisplayOrderActivity::class.java)
intent.action = Intent.ACTION_VIEW
var shortcutInfo = ShortcutInfoCompat.Builder(context, id)
    .setShortLabel("Running")
    .setLongLabel("Start running")
    .addCapabilityBinding(
        "actions.intent.CREATE_ITEM_LIST", "itemList.name", Arrays.asList("My First List")
    )
    .setIntent(intent) // Push the shortcut
    .build()

// Push the shortcut
ShortcutManagerCompat.pushDynamicShortcut(context, shortcutInfo)

জাভা

// Define the dynamic shortcut for an item
Intent intent = new Intent(context, DisplayOrderActivity.class);
intent.setAction(Intent.ACTION_VIEW);

ShortcutInfoCompat.Builder shortcutInfo = new ShortcutInfoCompat.Builder(context, id)
    .setShortLabel("Running")
    .setLongLabel("Start running")
    .addCapabilityBinding(
      "actions.intent.CREATE_ITEM_LIST", "itemList.name", Arrays.asList("My First List"))
    .setIntent(intent)
    .build();

// Push the shortcut
ShortcutManagerCompat.pushDynamicShortcut(context, shortcutInfo);

আগের স্যাম্পেল কোডে ShortcutInfoCompat.Builder পদ্ধতিতে উল্লেখ করা id, ফলাফল হিসেবে পাওয়া শর্টকাট অবজেক্টের shortcutId নির্ধারণ করে। এই id অবশ্যই একটি অনন্য স্ট্রিং লিটারেল হতে হবে। বিস্তারিত জানতে, Android শর্টকাট ডকুমেন্টেশন দেখুন।

আগের উদাহরণে, addCapabilityBinding পদ্ধতিটি ডাইনামিক শর্টকাটকে shortcuts.xml-এ সংজ্ঞায়িত একই android:name-এর capability-এর সাথে বাইন্ড করে। এই পদ্ধতি আপনাকে শর্টকাটকে একটি সিম্যান্টিক বিল্ট-ইন ইনটেন্ট (BII) প্যারামিটারের সাথে যুক্ত করতে দেয়।

ডায়নামিক শর্টকাট কখনও কখনও কোনও নির্দিষ্ট BII প্যারামিটার অ্যাসোসিয়েশন ছাড়াই পুশ করা হয়। ব্যবহারকারী চালু করলে, Assistant অ্যাকশনটি সম্পূর্ণ করার জন্য শর্টকাটে সংজ্ঞায়িত intent ট্রিগার করে। নিম্নলিখিত উদাহরণে কোনও প্যারামিটার অ্যাসোসিয়েশন ছাড়া ডায়নামিক শর্টকাট দেখানো হয়েছে:

Kotlin

var intent: Intent = Intent(context, DisplayOrderActivity::class.java)
intent.setPackage(this, "com.sample.app")
intent.setAction(Intent.ACTION_VIEW)

var shortcutInfo: ShortcutInfoCompat = ShortcutInfoCompat.Builder(context, id)
    .setShortLabel("Create a list")
    .setLongLabel("Create a list")
    .addCapabilityBinding("actions.intent.CREATE_ITEM_LIST")
    .setIntent(intent)
    .build()

ShortcutManagerCompat.pushDynamicShortcut(context, shortcutInfo);

জাভা

Intent intent = new Intent(context, DisplayOrderActivity.class);
intent.setPackage(this, "com.sample.app");
intent.setAction(Intent.ACTION_VIEW);

ShortcutInfoCompat shortcutInfo = new ShortcutInfoCompat.Builder(context, id)
  .setShortLabel("Create a list")
  .setLongLabel("Create a list")
  .addCapabilityBinding("actions.intent.CREATE_ITEM_LIST")
  .setIntent(intent)
  .build();

ShortcutManagerCompat.pushDynamicShortcut(context, shortcutInfo);

Assistant-এর মাধ্যমে ডায়নামিক শর্টকাট পরীক্ষা করুন

Google Assistant আপনার অ্যাপ্লিকেশন থেকে ডাইনামিক শর্টকাট গ্রহণ করলে, Assistant Android অ্যাপে ভয়েস শর্টকাট সাজেশন হিসেবে শর্টকাটটি দেখানোর জন্য উপযুক্ত হয়। Assistant অ্যাপ আপনার অ্যাপের মাধ্যমে পুশ করা সবচেয়ে সাম্প্রতিক শর্টকাট সাজেস্ট করে।

Assistant-এর মাধ্যমে আপনার ডায়নামিক শর্টকাট পরীক্ষা করতে, এই ধাপগুলি অনুসরণ করুন:

  1. আপনার অ্যাপ অ্যাকশনের প্রিভিউ তৈরি করুন এবং Google Assistant প্লাগ-ইন-এর জন্য প্রয়োজনীয় সেট-আপ অনুসরণ করে অ্যাকশন টেস্ট করার জন্য আপনার টেস্ট ডিভাইস বা এমুলেটর প্রস্তুত করুন।
  2. আপনার অ্যাপ খুলুন এবং পুশ করার জন্য একটি ডায়নামিক শর্টকাট নির্ধারণ করুন। তারপর একটি অ্যাকশন সম্পূর্ণ করুন। যেমন, আপনার নোট নেওয়ার অ্যাপে যখনই কোনও নোট তৈরি করা হয়, তখন আপনি যদি কোনও শর্টকাট পুশ করেন, তাহলে নতুন নোট তৈরি করুন।
  3. আপনার ডিভাইসে Assistant সেটিংস অ্যাপে শর্টকাট খুলুন। আপনার ডায়নামিক শর্টকাট আপনার অ্যাপের তালিকায় দেখা যায়।