دمج "مهام التطبيقات" مع تطبيقات Android المصغّرة

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);
    }

}

اقتراحات نمط النص المحوَّل إلى كلام

استخدام الاقتراحات التالية بشأن التصاميم لتحسين التطبيق المصغّر المخصّص مقدمات "تحويل النص إلى كلام" والطلبات المعروضة.

تثبيت مشغّل التطبيقات

تسمح مكتبة إضافات التطبيقات المصغّرة بعرض الزر إضافة هذا التطبيق المصغّر. باستخدام تطبيقك المصغّر في "مساعد Google" لتفعيل التثبيت، أضِف المُستلِم التالي تعريف إلى 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" الإضافي "استوديو Android": لاختبار التطبيقات المصغّرة على جهاز فعلي أو افتراضي. للاستخدام أداة الاختبار، اتبع الخطوات التالية:

1. اربط جهاز الاختبار بالتطبيق قيد التشغيل.
2. في "استوديو Android"، انتقِل إلى الأدوات >. الإجراءات في التطبيق > اختبار "مهامّ في التطبيقات" الأداة.
3. انقر على إنشاء معاينة.
4. باستخدام "استوديو Android"، يمكنك تشغيل تطبيقك على جهاز الاختبار.
5. يُرجى استخدام تطبيق "مساعد Google" على الجهاز الاختباري لاختبار إجراء التطبيق. بالنسبة على سبيل المثال، يمكنك قول "Ok Google، كم ميلاً مشيت؟ هذا الأسبوع على ExampleApp؟"
6. راقِب سلوك تطبيقك أو استخدِم برنامج تصحيح الأخطاء في "استوديو Android" من أجل للتحقق من نتيجة الإجراء المطلوبة.

إرشادات الجودة

يسلط هذا القسم الضوء على المتطلبات الأساسية وأفضل الممارسات عند دمج "مهامّ في التطبيقات" مع التطبيقات المصغّرة

المحتوى في التطبيقات المصغّرة

• (مطلوب) عدم عرض إعلانات في أدواتك.
• تركيز محتوى الأداة بالكامل على تحقيق الهدف. الإجراءات غير المستحسنة محاولة تحقيق أغراض متعددة باستخدام أداة واحدة أو إضافة محتوى غير ملائم

التعامل مع المصادقة

• (مطلوب) عندما تكون مصادقة المستخدم مطلوبة لإكمال تدفق المستخدم، إرجاع أداة توضح أن المستخدم بحاجة إلى المتابعة في التطبيق. مصادقة المستخدم المضمّنة في "مساعد Google" غير متاحة للتطبيق الإجراءات.
• إذا سمح المستخدمون لتطبيقك بعرض بيانات باستخدام الأدوات، يمكنك عرض تطبيق خطأ في وقت التشغيل للمستخدمين غير المصرح لهم.

الأهداف الاحتياطية

• (مطلوب) في shortcuts.xml، احرِص دائمًا على توفير خيار احتياطي. <intent> بالإضافة إلى تنفيذ الأداة قدرات معينة. الغرض الاحتياطي هو عنصر <intent> بدون الحاجة إلى <parameter> من القيم.

  يتيح ذلك لخدمة "مساعد Google" تنفيذ إجراء معيّن عند أنّ طلب بحث المستخدم لا يحتوي على مَعلمات مطلوبة في طريقة التنفيذ الأخرى والعناصر المحددة في القدرة. والاستثناء من ذلك هو عندما لا تكون هناك والمعايير المطلوبة لتلك الإمكانية، وفي هذه الحالة سيكون التطبيق المصغَّر مطلوبة.

• استخدِم الغرض الاحتياطي لفتح التطبيق على الشاشة ذات الصلة وليس الشاشة الرئيسية.

يوضح الرمز التالي من نموذج ملف shortcuts.xml <capability> مع إجراء <intent> احتياطي يتوافق مع شبكة أساسية توصيل الطلب <app-widget>:

<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

يسرد هذا القسم بيانات المستخدمين النهائيين التي تم جمعها من خلال أحدث إصدار مكتبة إضافات Widgets.

ترسل حزمة تطوير البرامج (SDK) هذه ردودًا من مطوّر البرامج على ميزة تحويل النص إلى كلام. أعلن عنه "مساعد Google" للمستخدم باستخدام الكلام في "مساعد Google" التكنولوجيا. ولا تخزِّن Google هذه المعلومات.

قد تتضمن الإجراءات على التطبيق أيضًا جمع البيانات الوصفية لتطبيقات العميل للأغراض التالية:

• مراقبة معدلات استخدام إصدارات مختلفة من حزمة SDK
• لقياس استخدام ميزة حزمة تطوير البرامج (SDK) في جميع التطبيقات