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

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

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

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

আপনার উন্নয়ন প্রকল্প কনফিগার করুন

আপনার অ্যাপে গতিশীল শর্টকাট কার্যকারিতা যোগ করার জন্য Google শর্টকাট ইন্টিগ্রেশন লাইব্রেরি প্রয়োজন, যা একটি Android 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"
    ...
   }
   

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

   androidx.core:core-google-shortcuts:1.0.1 হল Google শর্টকাট ইন্টিগ্রেশন লাইব্রেরি। এই লাইব্রেরিতে কোনো ডেভেলপার-মুখী API নেই। এটিকে নির্ভরতা হিসেবে যোগ করার মাধ্যমে, আপনি ShortcutManagerCompat ক্লাস ব্যবহার করে যে গতিশীল শর্টকাটগুলি পুশ করেন তা নিতে সহকারীকে সক্ষম করেন।

গতিশীল শর্টকাট পুশ করুন

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

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

উদাহরণঅর্ডারঅ্যাক্টিভিটি

// Define the dynamic shortcut for a menu item
var intent = Intent(context, DisplayOrderActivity::class.java)
intent.action = Intent.ACTION_VIEW
var shortcutInfo = ShortcutInfoCompat.Builder(context, id)
    .setShortLabel("Cappuccino")
    .setLongLabel("Order another cappuccino")
    .addCapabilityBinding(
        "actions.intent.ORDER_MENU_ITEM", "menuItem.name", Arrays.asList("cappuccino")
    )
    .setIntent(intent) // Push the shortcut
    .build()

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

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

ShortcutInfoCompat.Builder shortcutInfo = new ShortcutInfoCompat.Builder(context, id)
    .setShortLabel("Cappuccino")
    .setLongLabel("Order another cappuccino")
    .addCapabilityBinding(
      "actions.intent.ORDER_MENU_ITEM", "menuItem.name", Arrays.asList("cappuccino"))
    .setIntent(intent)
    .build();

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

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

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

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

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("Order coffee")
    .setLongLabel("Order a cup of coffee")
    .addCapabilityBinding("actions.intent.ORDER_MENU_ITEM")
    .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("Order coffee")
  .setLongLabel("Order a cup of coffee")
  .addCapabilityBinding("actions.intent.ORDER_MENU_ITEM")
  .setIntent(intent)
  .build();

ShortcutManagerCompat.pushDynamicShortcut(context, shortcutInfo);

অ্যাসিস্ট্যান্টের সাথে ডায়নামিক শর্টকাট পরীক্ষা করুন

যখন Google অ্যাসিস্ট্যান্ট সফলভাবে আপনার অ্যাপ্লিকেশান থেকে একটি ডায়নামিক শর্টকাট নেয়, তখন শর্টকাটটি অ্যাসিস্ট্যান্ট অ্যান্ড্রয়েড অ্যাপে ভয়েস শর্টকাট সাজেশন হিসেবে দেখানোর যোগ্য। অ্যাসিস্ট্যান্ট অ্যাপটি আপনার অ্যাপ দ্বারা পুশ করা সাম্প্রতিকতম শর্টকাটগুলির পরামর্শ দেয়।

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

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