অ্যাপ অ্যাকশন (লেভেল 2) সহ Google সহকারীতে একটি Android অ্যাপ প্রসারিত করুন

1. সংক্ষিপ্ত বিবরণ

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

প্রথম অ্যাপ অ্যাকশন কোডল্যাবে , আপনি শিখেছেন কিভাবে স্বাস্থ্য ও ফিটনেস BII বিভাগ থেকে বিল্ট-ইন ইনটেন্টস (BII) বাস্তবায়নের মাধ্যমে Google Assistant কে একটি নমুনা ফিটনেস অ্যাপে সম্প্রসারিত করতে হয়। BII গুলিকে বিভিন্ন বিভাগে সংগঠিত করা হয়েছে যা ব্যবহারকারীরা প্রায়শই Assistant কে যে ধরণের কাজ করতে বলেন তার প্রতিনিধিত্ব করে।

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

এই কোডল্যাবটিতে অ্যাপ অ্যাকশনের মাধ্যমে ডেভেলপমেন্টের জন্য মধ্যবর্তী স্তরের ধারণাগুলি অন্তর্ভুক্ত রয়েছে। আপনার অ্যান্ড্রয়েড অ্যাপ তৈরি এবং অ্যান্ড্রয়েড উদ্দেশ্য বাস্তবায়নের পূর্ব অভিজ্ঞতা থাকতে হবে।

তুমি কী তৈরি করবে

এই কোডল্যাবে, আপনি একটি নমুনা করণীয় তালিকা অ্যাপে দুটি সাধারণ BII যোগ করবেন, যার ফলে ব্যবহারকারীরা সহকারীকে নিম্নলিখিতগুলি করতে বলতে পারবেন:

  • actions.intent.OPEN_APP_FEATURE BII ব্যবহার করে অ্যাপের মধ্যে থাকা বৈশিষ্ট্যগুলিতে নেভিগেট করুন।
  • actions.intent.GET_THING BII ব্যবহার করে অ্যাপ-মধ্যস্থ অনুসন্ধান ব্যবহার করে সামগ্রী অনুসন্ধান করুন।

তিনটি প্রগতিশীল স্ক্রিন যেখানে গুগল অ্যাসিস্ট্যান্ট একটি অ্যাপে সক্রিয় কাজগুলি প্রদর্শন করে।

চিত্র ১. তিনটি প্রগতিশীল স্ক্রিন যেখানে গুগল অ্যাসিস্ট্যান্ট একটি অ্যাপে সক্রিয় কাজগুলি প্রদর্শন করে।

তুমি কি শিখবে

আপনি শিখবেন কিভাবে বেশিরভাগ অ্যান্ড্রয়েড অ্যাপে অ্যাসিস্ট্যান্ট সম্প্রসারিত করতে কমন ক্যাটাগরি BII ব্যবহার করতে হয়। আপনি অ্যান্ড্রয়েড স্টুডিওর জন্য গুগল অ্যাসিস্ট্যান্ট প্লাগইন দিয়ে কমন BII পরীক্ষা করতেও শিখবেন।

পূর্বশর্ত

  • গিট ইনস্টল করে শেল কমান্ড চালানোর জন্য একটি টার্মিনাল।
  • অ্যান্ড্রয়েড স্টুডিওর সর্বশেষ স্থিতিশীল সংস্করণ।
  • আপনার ক্রিয়া পরীক্ষা করার জন্য গুগল প্লে স্টোরে ইন্টারনেট অ্যাক্সেস সহ একটি ভৌত ​​বা ভার্চুয়াল অ্যান্ড্রয়েড ডিভাইস।
  • আপনার একই Google অ্যাকাউন্টটি Android Studio তে এবং আপনার পরীক্ষামূলক ডিভাইসে Google অ্যাপ এবং Google Assistant অ্যাপ উভয়েই সাইন ইন করতে হবে।

এই কোডল্যাবে, আপনি আপনার অ্যাকশন পরীক্ষা করার জন্য একটি অ্যান্ড্রয়েড ডিভাইস (ফিজিক্যাল বা ভার্চুয়াল) ব্যবহার করেন। যদি কোনও ফিজিক্যাল ডিভাইস ব্যবহার করেন, তাহলে নিশ্চিত করুন যে এটি আপনার স্থানীয় ডেভেলপমেন্ট মেশিনের সাথে সংযুক্ত আছে। আপনাকে ডিভাইসে Google অ্যাপে সাইন ইন করতে হবে এবং একই Google অ্যাকাউন্ট ব্যবহার করে Android Studio তে সাইন ইন করতে হবে । ডিভাইসে Google Assistant অ্যাপও ইনস্টল থাকতে হবে।

2. এটি কীভাবে কাজ করে তা বুঝুন

অ্যাপ অ্যাকশনগুলি গুগল অ্যাসিস্ট্যান্ট থেকে ব্যবহারকারীদের আপনার অ্যান্ড্রয়েড অ্যাপের সাথে সংযুক্ত করে। কিন্তু তারা কীভাবে কাজ করে?

যখন কোনও ব্যবহারকারী Assistant-কে আপনার অ্যাপ ব্যবহার করার ইঙ্গিত দেয়, তখন Assistant একটি shortcuts.xml ফাইল থেকে আপনার অ্যাপে নিবন্ধিত অ্যাপ অ্যাকশনগুলি অনুসন্ধান করে। এই ফাইলটিতে অ্যাপের ক্ষমতা রয়েছে, যা একটি Assistant বিল্ট-ইন ইন্টেন্ট বা কাস্টম ইন্টেন্টকে একটি Android ইন্টেন্ট বা ডিপ লিঙ্কের সাথে লিঙ্ক করে।

যখন কোনও ব্যবহারকারী Assistant-কে কোনও প্রশ্ন করেন, Assistant ব্যবহারকারীর ইনপুট পার্স করে এবং এটি একটি App Actions intent-এর সাথে মেলায় (এই codelab-এ, এটি একটি BII হবে)। Assistant আপনার Android অ্যাপের shortcuts.xml ফাইল থেকে জানে যে আপনি কোন ক্ষমতাগুলি সমর্থন করেন। intent match-এর মাধ্যমে, সেই BII-এর ক্ষমতায় আপনি কীভাবে সেই অনুরোধটি পূরণ করতে চান তা থাকে। এই codelab-এ, পূরণ হল একটি Android intent যা আপনার অ্যাপে একটি কার্যকলাপ চালু করে।

নিম্নলিখিত চিত্রটি এই সহকারী প্রবাহটি দেখায়:

একটি ফ্লো যা বর্ণনা করে যে কীভাবে একটি ব্যবহারকারীর ভয়েস কোয়েরি Google Assistant দ্বারা প্রক্রিয়া করা হয়। চিত্র ২। গুগল অ্যাসিস্ট্যান্ট কীভাবে একটি ভয়েস কোয়েরি প্রক্রিয়া করে তা বর্ণনা করে একটি প্রবাহ।

shortcuts.xml প্রজেক্ট ফাইলে প্রতিটি অ্যাপ অ্যাকশনের জন্য নিম্নলিখিত তথ্য রয়েছে:

  • অ্যাপ অ্যাকশন কোন বিল্ট-ইন ইন্টেন্ট বা কাস্টম ইন্টেন্ট ব্যবহার করে
  • ব্যবহারকারীকে কোন অ্যান্ড্রয়েড অ্যাক্টিভিটি বা ডিপ লিঙ্ক প্রদান করা উচিত
  • ব্যবহারকারীর দ্বারা সহকারীকে প্রদত্ত তথ্যের জন্য বিল্ট-ইন ইনটেন্ট ম্যাপের প্যারামিটারগুলি কীভাবে

আপনার অ্যান্ড্রয়েড অ্যাক্টিভিটি এরপর ব্যবহারকারীকে তাদের পছন্দসই কার্যকারিতা প্রদানের জন্য প্রদত্ত অ্যান্ড্রয়েড ইনটেন্ট বা ডিপ লিঙ্ক ফিল্টার করে এবং পরিচালনা করে। এর ফলে ব্যবহারকারীর অভিজ্ঞতা বৃদ্ধি পায় যেখানে অ্যাসিস্ট্যান্ট ব্যবহারকারীর প্রশ্নের উত্তরে আপনার অ্যাপের কার্যকারিতা ব্যবহার করে।

৩. আপনার উন্নয়ন পরিবেশ প্রস্তুত করুন

এই কোডল্যাবটি অ্যান্ড্রয়েডের জন্য করণীয় তালিকার নমুনা অ্যাপ ব্যবহার করে। এই নমুনা অ্যাপটি করণীয় তালিকায় আইটেম যোগ করতে, বিভাগ অনুসারে আইটেম অনুসন্ধান করতে এবং সম্পন্ন কাজ সম্পর্কে তথ্য দেখতে পারে।

আপনার বেস ফাইলগুলি ডাউনলোড করুন

নমুনা অ্যাপের GitHub সংগ্রহস্থল ক্লোন করতে নিম্নলিখিত কমান্ডটি চালান:

git clone --branch codelab-start https://github.com/actions-on-google/appactions-common-biis-kotlin.git

একবার আপনি রিপোজিটরিটি ক্লোন করার পরে, এটি অ্যান্ড্রয়েড স্টুডিওতে খুলতে এই পদক্ষেপগুলি অনুসরণ করুন:

  1. Welcome to Android Studio ডায়ালগে, Import project এ ক্লিক করুন।
  2. আপনি যে ফোল্ডারে রিপোজিটরিটি ক্লোন করেছেন সেটি খুঁজুন এবং নির্বাচন করুন।

সম্পূর্ণ কোডল্যাবের প্রতিনিধিত্বকারী অ্যাপের একটি সংস্করণ দেখতে, --branch master ফ্ল্যাগ ব্যবহার করে নমুনা অ্যাপ রেপো ক্লোন করুন।

অ্যান্ড্রয়েড অ্যাপ্লিকেশন আইডি আপডেট করুন

অ্যাপের অ্যাপ্লিকেশন আইডি আপডেট করলে আপনার পরীক্ষামূলক ডিভাইসে অ্যাপটি অনন্যভাবে শনাক্ত করা যায় এবং অ্যাপটি Play Console-এ আপলোড করা হলে "ডুপ্লিকেট প্যাকেজ নাম" ত্রুটি এড়ানো যায়। অ্যাপ্লিকেশন আইডি আপডেট করতে, app/build.gradle খুলুন:

android {
...
  defaultConfig {
    applicationId "com.MYUNIQUENAME.android.fitactions"
    ...
  }
}

applicationId ক্ষেত্রের "MYUNIQUENAME" এর পরিবর্তে আপনার জন্য অনন্য কিছু লিখুন।

আপনার ডিভাইসে অ্যাপটি পরীক্ষা করুন

অ্যাপটিতে আরও পরিবর্তন আনার আগে, নমুনা অ্যাপটি কী করতে পারে তার একটি ধারণা নেওয়া সহায়ক। আপনার এমুলেটরে অ্যাপটি চালাতে, এই পদক্ষেপগুলি অনুসরণ করুন:

  1. অ্যান্ড্রয়েড স্টুডিওতে, রান > রান অ্যাপ নির্বাচন করুন অথবা রান এ ক্লিক করুন টুলবারে।
  2. Select Deployment Target ডায়ালগে, একটি ডিভাইস নির্বাচন করুন এবং OK এ ক্লিক করুন। প্রস্তাবিত OS সংস্করণটি হল Android 10 (API লেভেল 30) বা তার বেশি, যদিও Actions Android 5 (API লেভেল 21) এর ডিভাইসগুলিতে চলে।
  3. অ্যাসিস্ট্যান্ট সেট আপ করতে এবং এটি কাজ করছে কিনা তা যাচাই করতে হোম বোতামটি দীর্ঘক্ষণ টিপুন। যদি আপনি ইতিমধ্যেই অ্যাসিস্ট্যান্টে সাইন ইন না করে থাকেন তবে আপনাকে আপনার ডিভাইসে অ্যাসিস্ট্যান্টে সাইন ইন করতে হবে।

অ্যান্ড্রয়েড ভার্চুয়াল ডিভাইস সম্পর্কে আরও তথ্যের জন্য, ভার্চুয়াল ডিভাইস তৈরি এবং পরিচালনা দেখুন।

অ্যানিমেশনটি টোডো তালিকার নমুনা অ্যাপটি প্রদর্শন করছে

চিত্র ৩। করণীয় তালিকার নমুনা অ্যাপটি প্রদর্শনকারী একটি অ্যানিমেশন।

অ্যাপটি কী করতে পারে তা দেখার জন্য সংক্ষেপে অ্যাপটি অন্বেষণ করুন। প্লাস আইকনে ট্যাপ করলে একটি নতুন টাস্ক আইটেম তৈরি হয় এবং উপরের ডানদিকের মেনু আইটেমগুলি আপনাকে সমাপ্তির স্থিতি অনুসারে টাস্ক আইটেমগুলি অনুসন্ধান এবং ফিল্টার করার অনুমতি দেয়।

পরীক্ষা প্লাগইন ইনস্টল করুন

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

  1. ফাইল > সেটিংস ( অ্যান্ড্রয়েড স্টুডিও > ম্যাকওএস-এ পছন্দসমূহ ) এ যান।
  2. প্লাগইন বিভাগে, মার্কেটপ্লেসে যান এবং "গুগল অ্যাসিস্ট্যান্ট" অনুসন্ধান করুন। আপনি নিজেও পরীক্ষামূলক সরঞ্জামটি ডাউনলোড এবং ইনস্টল করতে পারেন।
  3. টুলটি ইনস্টল করুন এবং অ্যান্ড্রয়েড স্টুডিও পুনরায় চালু করুন।

৪. Get Thing BII ক্ষমতা যোগ করুন

actions.intent.GET_THING BII আপনার অ্যাপ-মধ্যস্থ অনুসন্ধান কার্যকারিতা Google Assistant-এ প্রসারিত করে। এই ধাপে, আপনি GET_THING BII বাস্তবায়ন এবং পরীক্ষা করবেন, যার ফলে ব্যবহারকারীরা নমুনা অ্যাপে নির্দিষ্ট কাজগুলি অনুসন্ধান করতে পারবেন।

Get Thing ক্ষমতা নির্ধারণ করুন

অনুসন্ধান-সম্পর্কিত অ্যাপ অ্যাকশনের সময়, সহকারী ব্যবহারকারীর কোয়েরি থেকে thing.name BII প্যারামিটারে অনুসন্ধান শব্দগুলি বের করে, তারপর সেই মানটি অ্যান্ড্রয়েড অ্যাপ্লিকেশনে প্রেরণ করে।

আপনার অ্যাপে GET_THING BII যোগ করতে, app/src/main/res/xml নমুনা প্রকল্প ডিরেক্টরিতে অবস্থিত shortcuts.xml আপডেট করুন, এবং উপরের স্তরের <shortcuts> ট্যাগের মধ্যে একটি <capability> উপাদান ব্যবহার করুন:

শর্টকাটস.এক্সএমএল 

<shortcuts ....>
    <capability android:name="actions.intent.GET_THING">
        <intent
            android:action="android.intent.action.VIEW"
            android:targetPackage="com.yourApplicationId.appaction"
            android:targetClass="com.example.android.architecture.blueprints.todoapp.tasks.TasksActivity">
            <parameter
                android:name="thing.name"
                android:key="q"/>
        </intent>
    </capability>
</shortcuts>

উপরের কনফিগারেশন:

  1. ঘোষণা করে যে অ্যাপটি GET_THING BII-তে সাড়া দেয়।
  2. সেই BII-এর প্রতিক্রিয়ায় অ্যাপটি চালু করার জন্য একটি Android ইন্টেন্ট কীভাবে তৈরি করবেন তা নির্দিষ্ট করে।
    • targetPackage এবং targetClass ব্যবহার করে কার্যকলাপটি সনাক্ত করা হয়।
    • BII প্যারামিটার thing.name q নামক Intent Extra- তে ম্যাপ করা হয়েছে।

নামযুক্ত কার্যকলাপটি অবশ্যই অ্যাপের ম্যানিফেস্টে উপস্থিত থাকতে হবে এবং রপ্তানি করতে হবে।

প্রদত্ত অ্যান্ড্রয়েড অ্যাপ্লিকেশনটিতে মেটাডেটা রয়েছে তাই অ্যান্ড্রয়েডম্যানিফেস্ট shortcuts.xml ফাইলটি সম্পর্কে সচেতন:

<meta-data
   android:name="android.app.shortcuts"
   android:resource="@xml/shortcuts" />

আপনার অ্যাপ অ্যাকশন পরীক্ষা করুন

Assistant থেকে আপনার অ্যাপের জন্য অ্যাপ-মধ্যস্থ অনুসন্ধান পরীক্ষা করতে, এই পদক্ষেপগুলি অনুসরণ করুন:

  1. আপনার অ্যান্ড্রয়েড ডিভাইসটি সংযুক্ত আছে কিনা তা নিশ্চিত করুন।
  2. টুলস > গুগল অ্যাসিস্ট্যান্ট > অ্যাপ অ্যাকশন টেস্ট টুল -এ যান।
  3. অ্যাপের নাম এবং লোকেলের ডিফল্ট মান গ্রহণ করতে "পূর্বরূপ তৈরি করুন" এ ক্লিক করুন। যদি জিজ্ঞাসা করা হয়, তাহলে অ্যাপ অ্যাকশন নীতি এবং পরিষেবার শর্তাবলী পর্যালোচনা করুন এবং গ্রহণ করুন।
  4. প্রথম ধাপে যেখানে টুলটি আপনাকে একটি BII নির্বাচন এবং কনফিগার করতে বলবে, সেখানে actions.intent.GET_THING নির্বাচন করুন। name মানটি running shoes থেকে milk এ পরিবর্তন করুন।
  5. রান অ্যাপ অ্যাকশন ক্লিক করুন।

এই পরীক্ষায়, GET_THING BII "দুধ" ধারণকারী কাজগুলি অনুসন্ধান করার জন্য অ্যাপটিতে name অ্যাট্রিবিউট ব্যবহার করে। পূর্ববর্তী অ্যাপ অ্যাকশনের মতো, আপনি পরীক্ষা সরঞ্জাম ব্যবহার করে আপনার ক্রিয়া পরীক্ষা করতে পারেন, অথবা আপনার পরীক্ষামূলক ডিভাইসে কেবল "Hey Google, Task List-এ কেক মিক্স অনুসন্ধান করুন" বা অন্যান্য অনুসন্ধান বাক্যাংশ বলতে পারেন।

৫. ওপেন অ্যাপ বৈশিষ্ট্য BII ক্ষমতা যোগ করুন

এই ধাপে, আপনি Open app বৈশিষ্ট্য BII বাস্তবায়ন করবেন, যার ফলে ব্যবহারকারীরা Assistant ব্যবহার করে তাদের সক্রিয় এবং সম্পন্ন কাজগুলি দেখতে পারবেন। এটি করার জন্য, shortcuts.xml এ ক্ষমতাটি সম্পূর্ণ করুন যেখানে ক্ষমতাটি কীভাবে ট্রিগার করা হয়, কীভাবে প্যারামিটারগুলি পাস করা হয় এবং কোন Android ব্যবহার করতে চায় সে সম্পর্কে তথ্য রয়েছে। এই কোডল্যাবের জন্য, আপনি OPEN_APP_FEATURE BII ব্যবহার করবেন। এই BII বাস্তবায়নের পরে, আপনি আপনার ডিভাইসে অ্যাকশন পরীক্ষা করবেন।

ওপেন অ্যাপ বৈশিষ্ট্যের ক্ষমতা যোগ করুন

Get Thing Capability উপাদানের নীচে shortcuts.xml এ Open app বৈশিষ্ট্যের জন্য দ্বিতীয় ক্ষমতা যোগ করুন:

শর্টকাটস.এক্সএমএল 

<capability android:name="actions.intent.OPEN_APP_FEATURE">
   <intent
       android:action="android.intent.action.VIEW"
       android:targetPackage="yourApplicationId"
       android:targetClass="com.example.android.architecture.blueprints.todoapp.tasks.TasksActivity">
       <parameter
           android:name="feature"
           android:key="feature"/>
   </intent>
</capability>

এই ক্ষমতাটি ওপেন অ্যাপ বৈশিষ্ট্য BII এবং অ্যান্ড্রয়েড ইন্টেন্টকে একসাথে ম্যাপ করে, তাই যখন ওপেন অ্যাপ বৈশিষ্ট্যটি ট্রিগার করা হবে, তখন অ্যান্ড্রয়েড ইন্টেন্টটি ট্রিগার হবে।

অ্যান্ড্রয়েড ইনটেন্ট চালু করার আগে, ব্যবহারকারীর ইনপুট থেকে সমর্থিত প্যারামিটারগুলি নেওয়া হয়। OPEN_APP_FEATURE BII একটি প্যারামিটার, feature , সমর্থন করে, যা ব্যবহারকারীর ক্যোয়ারী থেকে নেওয়া অ্যাপ বৈশিষ্ট্যের প্রতিনিধিত্ব করে। এই অ্যাপ্লিকেশনটি দুটি ধরণের বৈশিষ্ট্য সমর্থন করবে: সক্রিয় কার্য এবং সম্পূর্ণ কার্য। এই বৈশিষ্ট্যগুলি ব্যবহারকারীদের তাদের কাজের তালিকার ফিল্টার করা ভিউ সহ অ্যাপটি খুলতে দেয়। এই বৈশিষ্ট্যগুলি সমর্থন করার জন্য আপনাকে ইনলাইন ইনভেন্টরি ব্যবহার করতে হবে।

ইনলাইন ইনভেন্টরি ব্যবহার করে ইন্টেন্ট প্যারামিটারগুলি পরিচালনা করুন

ইন্টেন্ট প্যারামিটারগুলি ব্যবহারকারীর কোয়েরি থেকে নেওয়া উপাদানগুলিকে প্রতিনিধিত্ব করে। উদাহরণস্বরূপ, যদি কোনও ব্যবহারকারী "হে গুগল, ExampleApp থেকে একটি পিৎজা অর্ডার করো" এর মতো কিছু বলে, তাহলে Assistant "pizza" কে food.item schema.org ইন্টেন্ট প্যারামিটারে এক্সট্র্যাক্ট করে এবং প্যারামিটারটি আপনার পরিচালনা করার জন্য অ্যাকশনে প্রেরণ করে।

ওপেন অ্যাপ ফিচার BII একটি প্যারামিটার, feature , সমর্থন করে, যা ব্যবহারকারীর ক্যোয়ারী থেকে নেওয়া অ্যাপ ফিচারের প্রতিনিধিত্ব করে। এই প্যারামিটারের জন্য একটি ইনলাইন ইনভেন্টরি প্রয়োজন, যা Assistant-কে প্যারামিটারের মান মেলানোর জন্য সমর্থিত অ্যাপ ফিচার নামের একটি সেট প্রদান করে।

feature ইনটেন্ট প্যারামিটারটি পরিচালনা করতে, আপনার shortcuts.xml এ একটি শর্টকাট যোগ করুন যাতে Open app বৈশিষ্ট্যের ক্ষমতার উপরে নিম্নলিখিত কোডটি থাকে:

শর্টকাটস.এক্সএমএল 

<shortcut
   android:shortcutId="active_tasks"
   android:shortcutShortLabel="@string/label_active"
   android:enabled="false">
   <capability-binding
       android:key="actions.intent.OPEN_APP_FEATURE">
       <parameter-binding
           android:key="feature"
           android:value="@array/active_tasks_synonyms" />
   </capability-binding>
</shortcut>

<shortcut
   android:shortcutId="completed_tasks"
   android:shortcutShortLabel="@string/label_completed"
   android:enabled="false">
   <capability-binding
       android:key="actions.intent.OPEN_APP_FEATURE">
       <parameter-binding
           android:key="feature"
           android:value="@array/completed_tasks_synonyms" />
   </capability-binding>
</shortcut>

উপরের কোডে আপনি একটি ইনলাইন ইনভেন্টরি সংজ্ঞায়িত করেছেন, যা ক্ষমতা এবং প্যারামিটার বাইন্ডিং সহ shortcut উপাদান হিসাবে উপস্থাপিত হয়। শর্টকাটগুলি BII প্যারামিটারের জন্য ইনভেন্টরি হিসাবে ব্যবহার করা যেতে পারে। Google Assistant ব্যবহারকারীর কোয়েরিটি Shortcuts-এর প্যারামিটার-বাইন্ডিংয়ের মানগুলির সাথে মেলায়। একটি মিলে যাওয়া প্যারামিটার মানের জন্য, shortcutId পূরণের উদ্দেশ্যে যোগ করা হবে। যখন একজন ব্যবহারকারী OPEN_APP_FEATURE BII একটি অনুরোধের সাথে সক্রিয় করে, Assistant বৈশিষ্ট্য প্যারামিটার মানটিকে একটি শর্টকাটের মান বৈশিষ্ট্যের সাথে মেলায়, Extra এ একটি parameter হিসাবে targetClass এ মানটি পাস করে।

উদাহরণস্বরূপ, যদি কোনও ব্যবহারকারী "হে গুগল, ExampleApp-এ আমার সম্পন্ন কাজগুলি দেখাও" বলে, তাহলে Assistant ফিচার ইন্টেন্ট প্যারামিটারের মান, "সম্পূর্ণ কাজগুলি", সংশ্লিষ্ট ইনভেন্টরি শর্টকাটের সাথে মেলায়, যা সেই মানটিকে OPEN_APP_FEATURE ক্ষমতায় পাস করে। Assistant তারপর Android ইন্টেন্ট ট্রিগার করে।

আপনার অ্যাপ অ্যাকশন পরীক্ষা করুন

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

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

  1. আপনার ফিজিক্যাল অ্যান্ড্রয়েড টেস্ট ডিভাইসটি সংযুক্ত করুন, অথবা আপনার অ্যান্ড্রয়েড এমুলেটর শুরু করুন
  2. যদি টেস্ট টুলটি দৃশ্যমান না হয়, তাহলে Tools > Google Assistant > App Actions Test Tool এ গিয়ে এটি খুলুন।
  3. আপনার প্রিভিউ রিফ্রেশ করতে আপডেট বোতামে ক্লিক করুন।
  4. প্রথম ধাপে যেখানে টুলটি আপনাকে একটি BII নির্বাচন এবং কনফিগার করতে বলবে, সেখানে actions.intent.OPEN_APP_FEATURE নির্বাচন করুন।
  5. ফিচার বক্সে, Completed tasks দিয়ে ডিফল্ট History মান আপডেট করুন।
  6. রান অ্যাপ অ্যাকশন ক্লিক করুন।

বিকল্প হিসেবে, আপনি আপনার ডিভাইসের Assistant অ্যাপে সরাসরি invocation নাম ব্যবহার করে আপনার অ্যাপ অ্যাকশন ব্যবহার করে দেখতে পারেন। উদাহরণস্বরূপ, আপনি বলতে পারেন "Hey Google, Task List-এ সম্পন্ন কাজগুলি দেখাও" ।

৬. পরবর্তী পদক্ষেপ

অভিনন্দন!

এখন আপনার কাছে সাধারণ BII ব্যবহার করে প্রায় যেকোনো অ্যান্ড্রয়েড অ্যাপকে গুগল অ্যাসিস্ট্যান্টের সাথে কাজ করার ক্ষমতা আছে।

আমরা যা কভার করেছি

এই কোডল্যাবে, আপনি শিখেছেন:

  • অ্যাসিস্ট্যান্ট ব্যবহার করে ব্যবহারকারীদের নির্দিষ্ট অ্যাপ বৈশিষ্ট্যগুলিতে কীভাবে গভীরভাবে ডুব দেওয়া যায়।
  • ব্যবহারকারীরা কীভাবে অ্যাসিস্ট্যান্ট থেকে অ্যাপ-মধ্যস্থ অনুসন্ধান অ্যাক্সেস করতে পারবেন।
  • গুগল অ্যাসিস্ট্যান্ট প্লাগইন ব্যবহার করে সাধারণ BII গুলি কীভাবে পরীক্ষা করবেন।

এরপর কি?

এখান থেকে, আপনি আপনার করণীয় তালিকা অ্যাপটিতে আরও পরিমার্জন করার চেষ্টা করতে পারেন। সমাপ্ত প্রকল্পটি উল্লেখ করতে, GitHub-এর repo –master শাখাটি দেখুন।

অ্যাপ অ্যাকশনের মাধ্যমে এই অ্যাপটি কীভাবে সম্প্রসারিত করা যায় সে সম্পর্কে আরও জানার জন্য এখানে কিছু পরামর্শ দেওয়া হল:

আপনার অ্যাকশনস অন গুগল যাত্রা চালিয়ে যেতে, এই রিসোর্সগুলি ঘুরে দেখুন:

আমাদের সর্বশেষ ঘোষণাগুলি পেতে টুইটারে @ActionsOnGoogle- এ আমাদের অনুসরণ করুন, এবং আপনার তৈরি করা জিনিসগুলি শেয়ার করতে #AoGDevs- এ টুইট করুন!

প্রতিক্রিয়া জরিপ

অবশেষে, এই কোডল্যাবের সাথে আপনার অভিজ্ঞতা সম্পর্কে মতামত জানাতে দয়া করে এই জরিপটি পূরণ করুন।