Intent ในตัวสำหรับการดำเนินการของแอป

Intent ในตัว (BII) ทำให้แอปแสดงความสามารถในการดำเนินการตามคำสั่งซื้อได้ Google โดยอัตโนมัติ ด้วยการประกาศความสามารถในไฟล์ shortcuts.xml และ ที่จะแมปพารามิเตอร์ Intent กับ Fulfillment นั้น Google Assistant สามารถเปิดแอปในหน้าจอหนึ่งๆ เพื่อตอบสนองต่อ เพื่อให้ผู้ใช้สามารถทำงานให้เสร็จสิ้นได้

ระบบจะจัดกลุ่ม Intent ในตัวตามหมวดหมู่แอป แต่ละหมวดหมู่ แสดงชุดงานทั่วไปที่ผู้ใช้มักต้องการทำ แอป รายชื่อ BII ที่มีอยู่ทั้งหมด พารามิเตอร์ และตัวอย่าง คำค้นหาที่ใช้สำหรับการทดสอบจะอยู่ในการอ้างอิง Intent ในตัว

BII จำนวนมากมีข้อกำหนดการติดตั้งใช้งานที่เฉพาะเจาะจงและ วิดีโอแนะนำ ข้อกำหนดและคำแนะนำเหล่านี้ช่วยให้แอปของคุณ เพื่อประสบการณ์ที่ดีที่สุดสำหรับผู้ใช้

วันที่
รูปที่ 1 เรียกใช้ START_EXERCISE BII ด้วยเสียง กับ Assistant
วันที่
รูปที่ 2 เปิดแอปไปยังหน้าจอที่ต้องการ เพื่อเริ่มงาน START_EXERCISE
วันที่
รูปที่ 3 แสดงวิดเจ็ตเพื่อตอบคำถาม

​

ใช้ BII และจัดการพารามิเตอร์ความตั้งใจ

สำหรับการดำเนินการของแอป คุณจะต้องประกาศความสามารถและจัดการพารามิเตอร์ BII ในไฟล์ ทางลัด.xml ของคุณ เพื่อนำ BII ไปใช้และจัดการ ให้ทำตามขั้นตอนต่อไปนี้

  1. ประกาศ capability ด้วย BII ที่เลือก
  2. เพิ่มเอลิเมนต์ parameter ที่ฝังไว้สำหรับช่อง BII แต่ละช่องที่ต้องการเพิ่ม
    1. หากคุณใช้ targetClass หรือ targetPackage ให้แมปกับ Android Intent extras โดยใช้ชื่อที่คุณเลือก
    2. หากคุณใช้ URL ของ Deep Link ให้ใช้พารามิเตอร์ที่มีชื่อในการค้นหา สตริงของเทมเพลต URL

ในการจัดการพารามิเตอร์ BII ให้แมปพารามิเตอร์ BII กับพารามิเตอร์ พารามิเตอร์ที่ตรงกันของ Intent ที่ชัดแจ้งของ Android ใน capability จากนั้นคุณจะใช้มูลค่าของแอปได้ แอปของคุณไม่จำเป็นต้องจัดการ พารามิเตอร์ BII อย่างไรก็ตาม ให้พยายามจัดการช่องข้อมูลที่ทําเครื่องหมายว่า "แนะนํา" ในข้อมูลอ้างอิง Intent ในตัว

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

ตัวอย่างเช่น actions.intent.START_EXERCISE Intent แนะนำให้แอปจัดการพารามิเตอร์ exercise.name BII แต่คุณ สามารถใช้ BII ในแอปของคุณได้โดยไม่ต้องมีพารามิเตอร์ คุณอาจต้องการทำเช่นนี้ในกรณีที่คุณต้องการจัดการกับข้อความค้นหาของผู้ใช้โดยไม่มี ชื่อการออกกำลังกาย เช่น "ขอให้แอปตัวอย่างเริ่มติดตามการออกกำลังกาย"

ข้อมูลโค้ดต่อไปนี้มี Fulfillment สำรองที่ไม่มีพารามิเตอร์ที่จำเป็น หากพารามิเตอร์นั้นไม่รวมอยู่ในการค้นหาของผู้ใช้

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

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

คำอธิบาย

อาร์กิวเมนต์ที่ส่งผ่านไปยังแอปของคุณผ่าน <url-parameter> หรือ Intent เพิ่มเติมอาจไม่แสดง ระบุรายการที่คุณต้องการแสดงต่อผู้ใช้โดยไม่ซ้ำกัน ในกรณีนี้ ใช้ค่าอาร์กิวเมนต์เป็นอาร์กิวเมนต์ค้นหาและนำผู้ใช้ไปยังการค้นหา หน้าของแอป สอบถามให้ชัดเจนและเลือกรายการที่เหมาะสมได้

เช่น หากคำค้นหาของผู้ใช้คือ "สั่งอาหารจากร้านตัวอย่าง" สำหรับแอตทริบิวต์ BII ORDER_MENU_ITEM คุณสามารถนำเสนอรายการ ร้านอาหารที่มีชื่อตรงกับคำว่า "Example Restaurant"

การสนับสนุนภาษาและสถานที่

ภาษาที่รองรับสำหรับการพัฒนาและทดสอบโดย App Action BII แต่ละรายการ แสดงอยู่ในข้อมูลอ้างอิง Intent ในตัว BII บางส่วนมี การสนับสนุนภาษาสำหรับการทดสอบของนักพัฒนาซอฟต์แวร์และสำหรับการเรียกผู้ใช้จาก Assistant