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

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

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

shortcuts.xml-এ ক্ষমতা নির্ধারণ করুন

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

1. Create static shortcuts এর নির্দেশাবলী অনুসরণ করে একটি shortcuts.xml রিসোর্স তৈরি করুন।

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

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

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

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

নিম্নলিখিত উদাহরণটি actions.intent.START_EXERCISE এর জন্য shortcuts.xml এ একটি সক্ষমতার সংজ্ঞা প্রদর্শন করে, এটি একটি 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 কে "Hey Google, ExampleApp এ একটি রান শুরু করো" বলে এই BIIটি ব্যবহার করে, তাহলে Assistant নেস্টেড intent এলিমেন্টে প্রদত্ত তথ্য ব্যবহার করে ব্যবহারকারীর অনুরোধ পূরণ করে। এই নমুনার intent নিম্নলিখিত বিবরণগুলি সংজ্ঞায়িত করে:

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

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

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

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