শর্টকাটে ক্ষমতা যোগ করুন

shortcuts.xml-এর ক্ষমতা আপনাকে ব্যবহারকারীর অ্যাকশনের ধরন ঘোষণা করতে দেয়, যা আপনার অ্যাপ চালু করতে এবং সরাসরি নির্দিষ্ট টাস্ক পারফর্ম করতে ব্যবহার করা যেতে পারে। একটি ক্যাপাবিলিটি অ্যাকশনের নাম এবং আপনার অ্যাপে ডেস্টিনেশন টার্গেট করা একটি intent নিয়ে গঠিত হয় যা ইউজার ইনটেন্ট সমাধান করে।

shortcuts.xml-এ কার্যকারিতা নির্ধারণ করা

আপনার Android অ্যাপ ডেভেলপমেন্ট প্রোজেক্টে shortcuts.xml রিসোর্স ফাইলে capability এলিমেন্ট নির্দিষ্ট করেন। capability এলিমেন্ট নির্ধারণ করতে, নিম্নলিখিত ধাপগুলি অনুসরণ করুন:

  1. স্ট্যাটিক শর্টকাট তৈরি করুন লিঙ্কে দেওয়া নির্দেশাবলী অনুসরণ করে shortcuts.xml রিসোর্স তৈরি করুন।
  2. আপনার ক্যাপাবিলিটিতে নিম্নলিখিত প্রয়োজনীয় তথ্য অন্তর্ভুক্ত করুন:

    • ক্ষমতার নাম: আপনি যে অ্যাকশনটি আপনার অ্যাপকে সমর্থন করতে চান। যে ফিচারের জন্য ক্ষমতার সংজ্ঞা প্রয়োজন, তার কম্পোনেন্ট ডকুমেন্টেশন দেখুন।

    • অ্যাপ ডেস্টিনেশন: ব্যবহারকারীর অনুরোধ পূরণ করার জন্য অ্যাকশনটি আপনার অ্যাপের যে ডেস্টিনেশনে লঞ্চ হয়। capability-এর মধ্যে নেস্ট করা intent এলিমেন্ট ব্যবহার করে অ্যাপ ডেস্টিনেশন সংজ্ঞায়িত করুন।

    • প্যারামিটার ম্যাপিং: প্রতিটি intent-এ প্যারামিটার থাকতে পারে যা ইনটেন্টের extra ডেটা হিসেবে পাস করা হবে।

নিচে দেওয়া উদাহরণে shortcuts.xml-এ actions.intent.START_EXERCISE-এর জন্য ক্যাপাবিলিটি ডেফিনেশন দেখানো হয়েছে। এটি এমন একটি BII যা ব্যবহারকারীদের Assistant-এর সাথে ভয়েস কমান্ড ব্যবহার করে ফিটনেস অ্যাপে ওয়ার্কআউট শুরু করতে দেয়:

<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
  <capability android:name="actions.intent.START_EXERCISE">
    <intent
      android:action="android.intent.action.VIEW"
      android:targetPackage="com.example.sampleApp"
      android:targetClass="com.example.sampleApp.ExerciseActivity">
      <parameter
        android:name="exercise.name"
        android:key="exerciseType"/>
    </intent>
  </capability>
</shortcuts>

আগের উদাহরণে, <capability> android:name অ্যাট্রিবিউটটি START_EXERCISE BII-কে রেফার করে। কোনও ব্যবহারকারী Assistant-কে "Ok Google, ExampleApp-এ রান শুরু করো" বলে এই BII চালু করলে, Assistant নেস্ট করা intent এলিমেন্টে প্রদান করা তথ্য ব্যবহার করে ব্যবহারকারীর অনুরোধ পূরণ করে। এই স্যাম্পেলে intent নিম্নলিখিত বিবরণ ব্যাখ্যা করে:

  • android:targetPackage এই ইনটেন্টের জন্য টার্গেট অ্যাপ্লিকেশন প্যাকেজ সেট করে।
  • android:targetClass ফিল্ডটি ডেস্টিনেশন অ্যাক্টিভিটি নির্দিষ্ট করে: com.example.sampleApp.ExerciseActivity.
  • parameter ইনটেন্ট BII প্যারামিটার exercise.name-এর জন্য সাপোর্ট ঘোষণা করে এবং ব্যবহারকারীর থেকে সংগ্রহ করা প্যারামিটার ভ্যালু কীভাবে intent-এ অতিরিক্ত ডেটা হিসেবে পাস করতে হবে তা জানায়।

কোনও ক্ষমতার সাথে শর্টকাট যুক্ত করুন

আপনি কোনও ক্ষমতা সংজ্ঞায়িত করার পরে, এটির সাথে স্ট্যাটিক বা ডাইনামিক শর্টকাট যুক্ত করে এর কার্যকারিতা বাড়াতে পারেন। শর্টকাট কীভাবে capability-এর সাথে লিঙ্ক করা হয় তা নির্ভর করে কোন ফিচার প্রয়োগ করা হচ্ছে এবং ব্যবহারকারীর অনুরোধে কোন আসল শব্দ অন্তর্ভুক্ত করা হয়েছে তার উপর। যেমন, কোনও ব্যবহারকারী Assistant-কে বলে আপনার ফিটনেস ট্র্যাকিং অ্যাপে দৌড়ানো শুরু করলে, "Ok Google, ExampleApp-এ দৌড়ানো শুরু করো।" Assistant capability-এর ইনস্ট্যান্স লঞ্চ করার জন্য শর্টকাট ব্যবহার করতে পারে যা exercise.name প্যারামিটারের জন্য "রান" এক্সারসাইজ এন্টিটি সংজ্ঞায়িত করে।