অ্যাপ অ্যাকশনের জন্য অন্তর্নির্মিত উদ্দেশ্য

বিল্ট-ইন ইনটেন্টস (BIIs) আপনার অ্যাপকে Google-এর কাছে তার পরিপূর্ণতার ক্ষমতা প্রকাশ করার অনুমতি দেয়। আপনার shortcuts.xml ফাইলে ক্ষমতা ঘোষণা করে এবং পরিপূর্ণতার জন্য অভিপ্রায়ের প্যারামিটার ম্যাপ করার মাধ্যমে, আপনি Google Assistant-এর জন্য একটি প্রশ্নের উত্তরে আপনার অ্যাপটি একটি নির্দিষ্ট স্ক্রিনে চালু করা সম্ভব করে তোলেন, যাতে ব্যবহারকারী একটি টাস্ক সম্পূর্ণ করতে পারে।

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

অনেক BII-এর নির্দিষ্ট স্থাপনার প্রয়োজনীয়তা এবং সুপারিশ রয়েছে। এই প্রয়োজনীয়তা এবং সুপারিশগুলি আপনার অ্যাপটিকে আপনার ব্যবহারকারীদের সর্বোত্তম সম্ভাব্য অভিজ্ঞতা প্রদান করতে সহায়তা করে।

চিত্র 1. সহকারীকে একটি ভয়েস ক্যোয়ারী সহ START_EXERCISE BII আহ্বান করুন৷
চিত্র 2. START_EXERCISE টাস্ক শুরু করতে একটি নির্দিষ্ট স্ক্রিনে অ্যাপটি চালু করুন৷
চিত্র 3. একটি প্রশ্নের উত্তরে একটি উইজেট প্রদর্শন করুন।

আমি

BII প্রয়োগ করুন এবং উদ্দেশ্য প্যারামিটারগুলি পরিচালনা করুন

অ্যাপ অ্যাকশনের জন্য, আপনি ক্ষমতা ঘোষণা করেন এবং আপনার shortcuts.xml ফাইলে BII প্যারামিটার পরিচালনা করেন। একটি BII বাস্তবায়ন করতে এবং এর পরামিতিগুলি পরিচালনা করতে, এই পদক্ষেপগুলি অনুসরণ করুন:

  1. নির্বাচিত BII এর সাথে capability ঘোষণা করুন।
  2. আপনি যোগ করতে চান এমন প্রতিটি BII ক্ষেত্রের জন্য নেস্টেড parameter উপাদান যোগ করুন।
    1. আপনি যদি targetClass বা targetPackage ব্যবহার করেন, তাহলে আপনার বেছে নেওয়া একটি নাম ব্যবহার করে অ্যান্ড্রয়েড অভিপ্রায় extras তাদের ম্যাপ করুন।
    2. আপনি যদি একটি গভীর লিঙ্ক URL ব্যবহার করেন, URL টেমপ্লেটের ক্যোয়ারী স্ট্রিং-এ নাম দেওয়া প্যারামিটারগুলি ব্যবহার করুন৷

একটি BII প্যারামিটার পরিচালনা করতে, BII প্যারামিটারটিকে আপনার capability একটি সুস্পষ্ট Android অভিপ্রায়ের সংশ্লিষ্ট প্যারামিটারে ম্যাপ করুন৷ তারপর, আপনি আপনার অ্যাপে এর মান ব্যবহার করতে পারেন। BII প্যারামিটারগুলি পরিচালনা করার জন্য আপনার অ্যাপের প্রয়োজন নেই। যাইহোক, অন্তর্নির্মিত অভিপ্রায় রেফারেন্সে "প্রস্তাবিত" হিসাবে চিহ্নিত ডেটা ক্ষেত্রগুলি পরিচালনা করার চেষ্টা করুন৷

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

উদাহরণ স্বরূপ, actions.intent.START_EXERCISE অভিপ্রায় সুপারিশ করে যে আপনার অ্যাপটি exercise.name BII প্যারামিটার পরিচালনা করে, কিন্তু আপনি কোনো প্যারামিটার ছাড়াই আপনার অ্যাপে BII প্রয়োগ করতে পারেন। আপনি এটি করতে পারেন যদি আপনি নির্দিষ্ট ব্যায়ামের নাম ছাড়া ব্যবহারকারীর প্রশ্নগুলি পরিচালনা করতে চান, যেমন "ট্র্যাকিং ব্যায়াম শুরু করতে উদাহরণ অ্যাপকে জিজ্ঞাসা করুন।"

নিম্নোক্ত স্নিপেটে কোনো প্রয়োজনীয় প্যারামিটার ছাড়াই একটি পূর্ণতার জন্য একটি ফলব্যাক আছে যদি প্যারামিটারগুলি ব্যবহারকারীর ক্যোয়ারীতে অন্তর্ভুক্ত না হয়:

<?xml version="1.0" encoding="utf-8"?>
<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:targetClass="com.example.myapplication.Activity1"
            android:targetPackage="com.example.myapplication">
            <parameter
                android:name="exercise.name"
                android:key="exerciseType"
                android:required="true"
                />
        </intent>
        <intent
            android:action="android.intent.action.VIEW"
            android:targetClass="com.example.myapplication.Activity2">
        </intent>
    </capability>
</shortcuts>

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

একটি অতিরিক্ত প্রয়োজন হিসাবে, আপনি চান না যে আপনার অ্যাপ সরাসরি এমন একটি ক্রিয়া সম্পাদন করুক যা ব্যবহারকারীর বাস্তব-বিশ্বের অবস্থাকে পরিবর্তন করে (উদাহরণস্বরূপ, অর্থ স্থানান্তর করা, একটি অর্ডার দেওয়া বা একটি বার্তা পাঠানো) ব্যবহারকারীর সাথে ক্রিয়াটি নিশ্চিত না করেই৷

দ্ব্যর্থতা

আপনার অ্যাপ্লিকেশানে <url-parameter> এর মাধ্যমে পাস করা আর্গুমেন্টগুলি বা অভিপ্রায় অতিরিক্তগুলি অনন্যভাবে আইটেমটিকে সনাক্ত করতে পারে না যা আপনি ব্যবহারকারীকে দেখাতে চান৷ এই ক্ষেত্রে, আর্গুমেন্ট ভ্যালুটিকে সার্চ আর্গুমেন্ট হিসেবে ব্যবহার করুন এবং ব্যবহারকারীকে অ্যাপের সার্চ পেজে নিয়ে যান। তারা দ্ব্যর্থতা নিরসন করতে পারে এবং সঠিক আইটেমটি বেছে নিতে পারে।

উদাহরণস্বরূপ, যদি একজন ব্যবহারকারীর প্রশ্নটি BII ORDER_MENU_ITEM এর জন্য "উদাহরণ রেস্তোরাঁ থেকে অর্ডার" হয়, তাহলে আপনি ব্যবহারকারীর কাছে রেস্তোরাঁর একটি তালিকা উপস্থাপন করতে পারেন যার নাম "Example Restaurant" শব্দটির সাথে মেলে৷

ভাষা এবং লোকেল সমর্থন

প্রতিটি অ্যাপ অ্যাকশন BII দ্বারা বিকাশ এবং পরীক্ষার জন্য সমর্থিত লোকেলগুলি অন্তর্নির্মিত অভিপ্রায় রেফারেন্সে তালিকাভুক্ত করা হয়েছে৷ কিছু BII ডেভেলপার টেস্টিং এবং অ্যাসিস্ট্যান্ট থেকে ব্যবহারকারী ট্রিগার করার জন্য আলাদা লোকেল সমর্থন করে।