অ্যান্ড্রয়েড উইজেটগুলির সাথে অ্যাপ অ্যাকশনগুলিকে একীভূত করুন৷

package com.example.exampleapp

//... Other module imports
import com.google.assistant.appactions.widgets.AppActionsWidgetExtension

/**
 * Implementation of App Widget functionality.
 */
object MyAppWidget : AppWidgetProvider() {
    fun updateAppWidget(
        context: Context?,
        appWidgetManager: AppWidgetManager,
        appWidgetId: Int
    ) {
        val appActionsWidgetExtension = AppActionsWidgetExtension.newBuilder(appWidgetManager)
            .setResponseSpeech("Hello world") // TTS to be played back to the user
            .setResponseText("Hello world!") // Response text to be displayed in Assistant
            .build()

        // Update widget with TTS
        appActionsWidgetExtension.updateWidget(appWidgetId)

        // Update widget UI
        appWidgetManager.updateAppWidget(appWidgetId, views)
    }
}

package com.example.exampleapp;

//... Other module imports
import com.google.assistant.appactions.widgets.AppActionsWidgetExtension;

/**
 * Implementation of App Widget functionality.
 */
public class MyAppWidget extends AppWidgetProvider {

  static void updateAppWidget(Context context, AppWidgetManager appWidgetManager,
    int appWidgetId) {

    AppActionsWidgetExtension appActionsWidgetExtension = AppActionsWidgetExtension.newBuilder(appWidgetManager)
      .setResponseSpeech("Hello world")  // TTS to be played back to the user
      .setResponseText("Hello world!")  // Response text to be displayed in Assistant
      .build();

      // Update widget with TTS
      appActionsWidgetExtension.updateWidget(appWidgetId);

      // Update widget UI
      appWidgetManager.updateAppWidget(appWidgetId, views);
    }

}

TTS শৈলী সুপারিশ

TTS এবং প্রদর্শিত প্রম্পটের জন্য আপনার কাস্টম উইজেট ভূমিকা অপ্টিমাইজ করতে নিম্নলিখিত শৈলী সুপারিশগুলি ব্যবহার করুন৷

লঞ্চার পিনিং

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

<application>
  <receiver android:name="com.google.assistant.appactions.widgets.pinappwidget.PinAppWidgetBroadcastReceiver"
    android:exported="false">
    <intent-filter>
      <action android:name="com.google.assistant.appactions.widgets.COMPLETE_PIN_APP_WIDGET" />
    </intent-filter>
  </receiver>
  <service
    android:name=
    "com.google.assistant.appactions.widgets.pinappwidget.PinAppWidgetService"
    android:enabled="true"
    android:exported="true">
    <intent-filter>
      <action
        android:name="com.google.assistant.appactions.widgets.PIN_APP_WIDGET" />
    </intent-filter>
  </service>
</application>

ইনভেন্টরি প্রাপ্যতা

BII গুলি ইনলাইন ইনভেন্টরি বা ওয়েব ইনভেন্টরি সমর্থন করে এই ইনভেন্টরিগুলিকে আপনার উইজেট পূরণে প্রসারিত করতে পারে৷

ইনলাইন ইনভেন্টরি

একটি নমুনা shortcuts.xml ফাইল থেকে নিম্নলিখিত কোড ইনলাইন ইনভেন্টরি এবং উইজেট পূরণের জন্য কনফিগার করা একটি START_EXERCISE BII ক্ষমতা প্রদর্শন করে:

<capability
  android:name="actions.intent.START_EXERCISE">
  <app-widget
    android:identifier="START_EXERCISE_1"
    android:targetClass="com.example.exampleapp.StartExerciseAppWidgetProvider">
    <parameter
      android:name="exercise.name"
      android:key="exerciseName"
      app:shortcutMatchRequired="true">
    </parameter>
  </app-widget>
</capability>

<shortcut android:shortcutId="RunningShortcut">
  <intent
    android:action="android.intent.action.VIEW"
    android:targetClass="com.example.exampleapp.StartExcerciseActivity" />
  <capability-binding
    android:capability="actions.intent.START_EXERCISE"
    android:parameter="exercise.name"
    android:value="running;runs" />
</shortcut>

পূর্ববর্তী নমুনায়, যখন একজন ব্যবহারকারী সহকারীকে "ExampleApp দিয়ে চালানো শুরু করুন" বলে এই ক্ষমতাটি ট্রিগার করেন, তখন <app-widget> পূরণের বিকল্প বান্ডলে নিম্নলিখিত কী-মান জোড়া থাকে:

• কী = “exerciseName”
• মান = “RunningShortcut”

ওয়েব ইনভেন্টরি

একটি নমুনা shortcuts.xml ফাইল থেকে নিম্নলিখিত কোডটি ওয়েব ইনভেন্টরি এবং উইজেট পূরণের জন্য সক্ষম একটি সক্ষমতা দেখায়:

<shortcuts>
  <capability
    android:name="actions.intent.START_EXERCISE">
    <app-widget
      android:identifier="START_EXERCISE_1"
      android:targetClass="com.example.exampleapp.CreateTaxiAppWidgetProvider">
      <parameter
        android:name="exercise.name"
        android:key="exerciseName"
        android:mimeType="text/*">
        <data android:pathPattern="https://exampleapp.com/exercise/.*" />
      </parameter>
    </app-widget>
  </capability>
</shortcuts>

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

একটি শারীরিক বা ভার্চুয়াল ডিভাইসে উইজেট পরীক্ষা করতে অ্যাপ অ্যাকশন টেস্ট টুল, অ্যান্ড্রয়েড স্টুডিওর জন্য Google সহকারী প্লাগইন- এর একটি বৈশিষ্ট্য ব্যবহার করুন। পরীক্ষার টুল ব্যবহার করতে, এই পদক্ষেপগুলি অনুসরণ করুন:

1. আপনার অ্যাপ চলমান সঙ্গে আপনার পরীক্ষা ডিভাইস সংযোগ করুন.
2. অ্যান্ড্রয়েড স্টুডিওতে, টুলস > অ্যাপ অ্যাকশন > অ্যাপ অ্যাকশন টেস্ট টুলে যান।
3. পূর্বরূপ তৈরি করুন ক্লিক করুন।
4. অ্যান্ড্রয়েড স্টুডিও ব্যবহার করে, আপনার পরীক্ষা ডিভাইসে আপনার অ্যাপ চালান।
5. আপনার অ্যাপ অ্যাকশন পরীক্ষা করতে আপনার টেস্ট ডিভাইসে অ্যাসিস্ট্যান্ট অ্যাপ ব্যবহার করুন। উদাহরণ স্বরূপ, আপনি "Hey Google, ExampleApp এ এই সপ্তাহে আমি কত মাইল দৌড়েছি?" এর মত কিছু বলতে পারেন?
6. আপনার অ্যাপের আচরণ পর্যবেক্ষণ করুন বা পছন্দসই ক্রিয়া ফলাফল যাচাই করতে Android স্টুডিও ডিবাগার ব্যবহার করুন।

গুণমানের নির্দেশিকা

আপনি যখন উইজেটগুলির সাথে অ্যাপ অ্যাকশনগুলিকে সংহত করেন তখন এই বিভাগটি মূল প্রয়োজনীয়তা এবং সর্বোত্তম অনুশীলনগুলিকে হাইলাইট করে৷

উইজেট মধ্যে বিষয়বস্তু

• ( প্রয়োজনীয় ) আপনার উইজেটে বিজ্ঞাপন দেখাবেন না।
• উইজেট বিষয়বস্তু সম্পূর্ণভাবে উদ্দেশ্য পূরণের উপর ফোকাস করুন। একটি উইজেট দিয়ে একাধিক উদ্দেশ্য পূরণ করার চেষ্টা করবেন না বা অপ্রাসঙ্গিক বিষয়বস্তু যোগ করবেন না।

প্রমাণীকরণ হ্যান্ডেল

• ( প্রয়োজনীয় ) যেখানে ব্যবহারকারীর প্রবাহ সম্পূর্ণ করার জন্য ব্যবহারকারীর প্রমাণীকরণ প্রয়োজন, সেখানে একটি উইজেট ফেরত দিন যা ব্যাখ্যা করে যে ব্যবহারকারীকে অ্যাপে চালিয়ে যেতে হবে। Google অ্যাসিস্ট্যান্টে ইনলাইন ব্যবহারকারী প্রমাণীকরণ অ্যাপ অ্যাকশনের জন্য সমর্থিত নয়।
• ব্যবহারকারীরা আপনার অ্যাপকে উইজেট ব্যবহার করে ডেটা দেখানোর অনুমতি দিলে, আপনি অননুমোদিত ব্যবহারকারীদের জন্য রানটাইমে একটি ত্রুটি উইজেট ফেরত দিতে পারেন।

পতনের অভিপ্রায়

• ( প্রয়োজনীয় ) আপনার shortcuts.xml এ, একটি প্রদত্ত ক্ষমতার জন্য আপনার উইজেট পূর্ণতা ছাড়াও সর্বদা একটি ফলব্যাক <intent> প্রদান করুন। একটি ফলব্যাক অভিপ্রায় হল একটি <intent> উপাদান যার কোনো <parameter> মান নেই।

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

• আপনার অ্যাপটিকে প্রাসঙ্গিক স্ক্রিনে খুলতে ফলব্যাক অভিপ্রায় ব্যবহার করুন, হোম স্ক্রীনে নয়।

একটি নমুনা shortcuts.xml ফাইল থেকে নিম্নলিখিত কোড একটি প্রাথমিক <app-widget> পূর্ণতা সমর্থন করে একটি ফলব্যাক <intent> সহ একটি <capability> প্রদর্শন করে:

<shortcuts>
  <capability
    android:name="actions.intent.CREATE_TAXI_RESERVATION">
    <!-- Widget with required parameter, specified using the "android:required" attribute. -->
    <app-widget
      android:identifier="CREATE_TAXI_RESERVATION_1"
      android:targetClass="com.example.myapplication.CreateTaxiAppWidgetProvider">
      <parameter
        android:name="taxiReservation.dropoffLocation.name"
        android:key="dropoff"
        android:required="true">
      </parameter>
    </app-widget>
    <!-- Fallback intent with no parameters required to successfully execute. -->
    <intent
      android:identifier="CREATE_TAXI_RESERVATION_3"
      android:action="myapplication.intent.CREATE_TAXI_RESERVATION_1"
      android:targetClass="com.example.myapplication.TaxiReservationActivity">
    </intent>
  </capability>
</shortcuts>

Google Play ডেটা প্রকাশ

এই বিভাগটি উইজেট এক্সটেনশন লাইব্রেরির সর্বশেষ সংস্করণ দ্বারা সংগৃহীত শেষ-ব্যবহারকারীর ডেটা তালিকাভুক্ত করে।

এই SDK ডেভেলপার-প্রদত্ত টেক্সট-টু-স্পিচ (TTS) প্রতিক্রিয়া পাঠায় যেগুলি অ্যাসিস্ট্যান্টের স্পিচ প্রযুক্তি ব্যবহার করে Google অ্যাসিস্ট্যান্ট ব্যবহারকারীকে ঘোষণা করে। এই তথ্য Google দ্বারা সংরক্ষণ করা হয় না.

অ্যাপ অ্যাকশনগুলি নিম্নলিখিত উদ্দেশ্যে ক্লায়েন্ট অ্যাপ মেটাডেটাও সংগ্রহ করতে পারে:

• বিভিন্ন SDK সংস্করণের গ্রহণের হার নিরীক্ষণ করতে।
• অ্যাপ্লিকেশান জুড়ে SDK বৈশিষ্ট্য ব্যবহারের পরিমাণ নির্ধারণ করতে।