ผสานรวมการดำเนินการของแอปกับวิดเจ็ต 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);
    }

}

คำแนะนำเกี่ยวกับรูปแบบ TTS

ใช้คำแนะนำเรื่องสไตล์ต่อไปนี้เพื่อเพิ่มประสิทธิภาพวิดเจ็ตที่กำหนดเอง ข้อมูลเบื้องต้นสำหรับ TTS และข้อความแจ้งที่แสดง

การปักหมุด Launcher

ไลบรารีส่วนขยายของวิดเจ็ตจะแสดงปุ่มเพิ่มวิดเจ็ตนี้ ด้วยวิดเจ็ตของคุณใน Assistant หากต้องการเปิดใช้การปักหมุด ให้เพิ่มผู้รับต่อไปนี้ คำจำกัดความของ 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>

ความพร้อมใช้งานของพื้นที่โฆษณา

BI ที่รองรับพื้นที่โฆษณาในบรรทัดหรือพื้นที่โฆษณาบนเว็บจะขยายสิ่งเหล่านี้ได้ พื้นที่โฆษณาทั้งหมดในการดำเนินการวิดเจ็ตของคุณ

พื้นที่โฆษณาแบบอินไลน์

โค้ดต่อไปนี้จากไฟล์ shortcuts.xml ตัวอย่างแสดง ความสามารถ START_EXERCISE BII กำหนดค่าสำหรับพื้นที่โฆษณาในบรรทัดและ Fulfillment วิดเจ็ต

<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>

ในตัวอย่างก่อนหน้านี้ เมื่อผู้ใช้เรียกใช้ความสามารถนี้ด้วยการถาม Assistant "Start running with ExampleApp" คือชุดตัวเลือกสำหรับ Fulfillment <app-widget> มีคู่คีย์-ค่าต่อไปนี้

• คีย์ = “exerciseName”
• ค่า = “RunningShortcut”

พื้นที่โฆษณาในเว็บ

โค้ดต่อไปนี้จากไฟล์ shortcuts.xml ตัวอย่างแสดงความสามารถ เปิดใช้สำหรับพื้นที่โฆษณาเว็บและ Fulfillment วิดเจ็ต:

<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 Assistant สำหรับ Android Studio เพื่อทดสอบวิดเจ็ตบนอุปกรณ์จริงหรืออุปกรณ์เสมือน หากต้องการใช้งาน เครื่องมือทดสอบ ให้ทำตามขั้นตอนต่อไปนี้

1. เชื่อมต่ออุปกรณ์ทดสอบกับที่แอปทำงานอยู่
2. ใน Android Studio ไปที่เครื่องมือ > การดำเนินการของแอป > การทดสอบการดำเนินการของแอป เครื่องมือ
3. คลิกสร้างตัวอย่าง
4. ใช้ Android Studio เพื่อเรียกใช้แอปในอุปกรณ์ทดสอบ
5. ใช้แอป Assistant ในอุปกรณ์ทดสอบเพื่อทดสอบการดำเนินการของแอป สำหรับ เช่น พูดว่า "Ok Google ฉันวิ่งไปแล้วกี่กิโลเมตร ในสัปดาห์นี้บน ExampleApp ได้อย่างไรบ้าง"
6. สังเกตลักษณะการทำงานของแอปหรือใช้โปรแกรมแก้ไขข้อบกพร่องของ Android Studio เพื่อ ยืนยันผลการดำเนินการที่ต้องการ

หลักเกณฑ์ด้านคุณภาพ

ส่วนนี้จะเน้นที่ข้อกำหนดหลักและแนวทางปฏิบัติแนะนำเมื่อ คุณผสานรวมการดำเนินการของแอปเข้ากับวิดเจ็ต

เนื้อหาในวิดเจ็ต

• (จำเป็น) อย่าแสดงโฆษณาในวิดเจ็ต
• เน้นเนื้อหาของวิดเจ็ตให้บรรลุความตั้งใจโดยสมบูรณ์ สิ่งที่ไม่ควรทำ พยายามเติมเต็มความตั้งใจหลายอย่างด้วยวิดเจ็ตเดียว หรือเพิ่มเนื้อหาที่ไม่เกี่ยวข้อง

จัดการการตรวจสอบสิทธิ์

• (จำเป็น) ในกรณีที่ต้องมีการตรวจสอบสิทธิ์ผู้ใช้เพื่อให้โฟลว์ผู้ใช้เสร็จสมบูรณ์ แสดงวิดเจ็ตที่อธิบายว่าผู้ใช้ต้องดำเนินการต่อในแอป แอปไม่รองรับการตรวจสอบสิทธิ์ผู้ใช้ในบรรทัดใน Google Assistant การดำเนินการ
• หากผู้ใช้อนุญาตให้แอปของคุณแสดงข้อมูลโดยใช้วิดเจ็ต คุณสามารถส่งคืน วิดเจ็ตแสดงข้อผิดพลาดขณะรันไทม์สำหรับผู้ใช้ที่ไม่ได้รับอนุญาต

Intent สำรอง

• (ต้องระบุ) ใน shortcuts.xml ให้ระบุวิดีโอสำรองเสมอ <intent> นอกเหนือจากการจำหน่ายวิดเจ็ตสำหรับ ความสามารถที่กำหนดไว้ Intent สำรองเป็นองค์ประกอบ <intent> ที่ไม่มีความจําเป็น <parameter>

  การดําเนินการนี้จะช่วยให้ Assistant ดําเนินการให้เสร็จสิ้นได้ การค้นหาของผู้ใช้ไม่มีพารามิเตอร์ที่ Fulfillment อื่นต้องการ องค์ประกอบที่กำหนดในความสามารถนี้ มีข้อยกเว้นคือเมื่อไม่มี พารามิเตอร์ที่จำเป็นสำหรับความสามารถนั้นๆ ซึ่งในกรณีนี้มีเพียงวิดเจ็ต จำเป็นต้องมีการดำเนินการตามคำสั่งซื้อ

• ใช้ Intent สำรองเพื่อเปิดแอปไปยังหน้าจอที่เกี่ยวข้อง ไม่ใช่หน้าจอหลัก

โค้ดต่อไปนี้จากไฟล์ 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

ส่วนนี้จะแสดงข้อมูลผู้ใช้ปลายทางที่รวบรวมโดยเวอร์ชันล่าสุดของ ไลบรารีส่วนขยายของวิดเจ็ต

SDK นี้ส่งการตอบกลับการอ่านออกเสียงข้อความ (TTS) จากนักพัฒนาซอฟต์แวร์ที่ Google Assistant ประกาศให้ผู้ใช้ทราบโดยใช้เสียงพูดของ Assistant เทคโนโลยี ข้อมูลนี้ไม่ได้จัดเก็บโดย Google

การดำเนินการของแอปยังอาจ รวบรวมข้อมูลเมตาของแอปไคลเอ็นต์เพื่อวัตถุประสงค์ต่อไปนี้

• เพื่อตรวจสอบอัตราการรับไปใช้งานของ SDK เวอร์ชันต่างๆ
• เพื่อวัดการใช้ฟีเจอร์ SDK ในแอปต่างๆ