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

shortcuts.xml এর Capabilities আপনাকে নির্ধারণ করতে দেয় যে, ব্যবহারকারীরা আপনার অ্যাপ চালু করতে এবং সরাসরি একটি নির্দিষ্ট কাজ সম্পাদন করতে কী ধরনের পদক্ষেপ নিতে পারবে।

উদাহরণস্বরূপ, গুগল অ্যাসিস্ট্যান্ট অ্যাপ অ্যাকশনস ‘ক্যাপাবিলিটি’ ব্যবহার করে ডেভেলপারদেরকে অ্যাপের ভেতরের ফিচারগুলোকে বিল্ট -ইন ইন্টেন্ট (BII)-এর সাথে সংযুক্ত করার সুযোগ দেয়, যার ফলে ব্যবহারকারীরা কথ্য কমান্ডের মাধ্যমে সেই ফিচারগুলো সক্রিয় ও নিয়ন্ত্রণ করতে পারেন। একটি ক্যাপাবিলিটিতে থাকে অ্যাকশনটির নাম এবং একটি intent , যা আপনার অ্যাপের সেই নির্দিষ্ট গন্তব্যকে লক্ষ্য করে যেখানে ব্যবহারকারীর উদ্দেশ্যটি পূরণ হয়।

shortcuts.xml-এ সক্ষমতাগুলো সংজ্ঞায়িত করুন।

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

1. "স্ট্যাটিক শর্টকাট তৈরি করুন" অংশে দেওয়া নির্দেশাবলী অনুসরণ করে একটি shortcuts.xml রিসোর্স তৈরি করুন।

2. আপনার সক্ষমতার মধ্যে নিম্নলিখিত প্রয়োজনীয় তথ্য অন্তর্ভুক্ত করুন:

   • ক্যাপাবিলিটি নেম: যে অ্যাকশনটি আপনি আপনার অ্যাপে সাপোর্ট করাতে চান। যে ফিচারের জন্য ক্যাপাবিলিটি ডেফিনিশন প্রয়োজন, তার জন্য কম্পোনেন্ট ডকুমেন্টেশন দেখুন। অ্যাপ অ্যাকশনস-এর ভয়েস-এনাবলড কমান্ডগুলো ক্যাপাবিলিটি নেমের জন্য BII Action ID ব্যবহার করে, যা আপনি BII রেফারেন্সে খুঁজে পেতে পারেন। উদাহরণস্বরূপ, GET_THING BII-এর Action ID হলো actions.intent.GET_THING ।

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

   • প্যারামিটার ম্যাপিং: প্রতিটি intent প্যারামিটার থাকতে পারে, যা ইন্টেন্টের extra ডেটা হিসেবে পাস করা হয়। উদাহরণস্বরূপ, প্রতিটি অ্যাপ অ্যাকশন BII-তে এমন ফিল্ড অন্তর্ভুক্ত থাকে যা সেইসব তথ্যের প্রতিনিধিত্ব করে, যা ব্যবহারকারীরা প্রায়শই BII-টি ট্রিগার করে এমন কোয়েরিতে প্রদান করে থাকেন।

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

<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-কে নির্দেশ করে। যদি কোনো ব্যবহারকারী অ্যাসিস্ট্যান্টকে "হে গুগল, ExampleApp-এ একটি দৌড় শুরু করো" বলে এই BII-টি চালু করেন, তাহলে অ্যাসিস্ট্যান্ট নেস্টেড intent এলিমেন্টে দেওয়া তথ্য ব্যবহার করে ব্যবহারকারীর অনুরোধটি পূরণ করে। এই স্যাম্পলের intent নিম্নলিখিত বিবরণগুলো সংজ্ঞায়িত করে:

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

শর্টকাটকে একটি সক্ষমতার সাথে যুক্ত করুন।

একবার আপনি একটি ক্যাপাবিলিটি সংজ্ঞায়িত করলে, এর সাথে স্ট্যাটিক বা ডাইনামিক শর্টকাট যুক্ত করে এর কার্যকারিতা বাড়াতে পারেন। শর্টকাটগুলো একটি capability সাথে কীভাবে যুক্ত হবে তা নির্ভর করে বাস্তবায়িত ফিচার এবং ব্যবহারকারীর অনুরোধে থাকা প্রকৃত শব্দগুলোর উপর। উদাহরণস্বরূপ, যখন একজন ব্যবহারকারী আপনার ফিটনেস ট্র্যাকিং অ্যাপে অ্যাসিস্ট্যান্টকে "হে গুগল, ExampleApp-এ একটি দৌড় শুরু করো" বলে জিজ্ঞাসা করে দৌড় শুরু করেন, তখন অ্যাসিস্ট্যান্ট exercise.name প্যারামিটারের জন্য "run" নামক একটি বৈধ এক্সারসাইজ এনটিটি সংজ্ঞায়িত করে এমন একটি capability ইনস্ট্যান্স চালু করতে একটি শর্টকাট ব্যবহার করতে পারে।

অ্যাপ অ্যাকশনের সাথে শর্টকাট যুক্ত করার বিষয়ে আরও তথ্যের জন্য, অ্যাপ অ্যাকশন ওভারভিউ দেখুন।