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

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

উদাহরণস্বরূপ, Google অ্যাসিস্ট্যান্ট অ্যাপ অ্যাকশনগুলি বিকাশকারীদের অ্যাপ-মধ্যস্থ বৈশিষ্ট্যগুলিকে অন্তর্নির্মিত অভিপ্রায়ে (BIIs) প্রসারিত করতে দেয়, ব্যবহারকারীদের কথ্য কমান্ড ব্যবহার করে সেই বৈশিষ্ট্যগুলিকে সক্রিয় এবং নিয়ন্ত্রণ করতে দেয়। একটি ক্ষমতার মধ্যে কর্মের নাম এবং আপনার অ্যাপে গন্তব্যকে লক্ষ্য করে একটি 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 উপাদানগুলি ব্যবহার করে অ্যাপের গন্তব্যগুলিকে সংজ্ঞায়িত করুন৷

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

নিম্নলিখিত উদাহরণটি actions.intent.START_EXERCISE জন্য shortcuts.xml এ একটি সক্ষমতার সংজ্ঞা প্রদর্শন করে।

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

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

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

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

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