เมื่อคุณระบุฟังก์ชันการทำงานในแอปและ Intent ในตัว (BII) ที่เกี่ยวข้องซึ่งจะนำไปใช้งานแล้ว ให้ประกาศ BII ที่ฟังก์ชันของคุณรองรับโดยกำหนดองค์ประกอบ capability
ในไฟล์ทรัพยากร shortcuts.xml
การประกาศ BII ในฐานะ capability
จะลงทะเบียนการรองรับจุดประสงค์ทางความหมายดังกล่าวในแอปของคุณ และช่วยให้ดำเนินการตามความตั้งใจได้ด้วยการใช้ Google Assistant
Assistant จะใช้การประมวลผลภาษาธรรมชาติเพื่อดึงพารามิเตอร์จากคำค้นหาของผู้ใช้ ข้อมูลอ้างอิงเกี่ยวกับ Intent ในตัวจะแสดงรายการช่องที่ BII แต่ละรายการดึงข้อมูลจากคำค้นหาของผู้ใช้ที่เกี่ยวข้องได้ ตัวอย่างเช่น หากผู้ใช้เรียกใช้ความสามารถ [actions.intent.GET_FOOD_OBSERVATION
][] ในแอปโดยพูดว่า "Ok Google ขอให้ ExampleApp บอกฉันว่าฉันกินอะไรเป็นอาหารกลางวันวันศุกร์ที่ผ่านมา" Assistant จะดึงข้อมูลพารามิเตอร์ BII ต่อไปนี้จากคําขอของผู้ใช้
foodObservation.forMeal
= "https://schema.googleapis.com/MealTypeLunch"foodObservation.startTime
= "2024-09-06T00:00:00"foodObservation.endTime
= "2024-09-06T23:59:59"
Assistant จะส่งพารามิเตอร์ BII ไปยัง Fulfillment intent
ที่กำหนดไว้ใน capability
คุณกำหนดเอลิเมนต์ intent
อย่างน้อย 1 รายการในความสามารถเพื่อรองรับวิธีที่ผู้ใช้อาจเรียกใช้ BII ได้ เช่น คุณอาจกําหนด Fulfillment intent
ที่จําเป็นต้องใช้ทั้งพารามิเตอร์ BII ในตัวอย่างนี้ จากนั้นคุณอาจกำหนด Intent รายการที่ 2 ซึ่งต้องใช้พารามิเตอร์ BII รายการเดียว foodObservation.forMeal
ซึ่งจะรายงานสำหรับอาหารทุกมื้อในวันหนึ่งๆ เช่น "Ok Google ขอให้ ExampleApp บอกฉันว่าฉันกินอะไรเป็นอาหารกลางวัน"
ภาพรวม
คุณกำหนดค่าการดำเนินการของแอปโดยใช้ไฟล์ shortcuts.xml
ที่วางไว้ในไดเรกทอรี res/xml
ของโปรเจ็กต์แอป แล้วสร้างการอ้างอิงไปยัง shortcuts.xml
ในไฟล์ Manifest ของแอป เพิ่มการอ้างอิง shortcuts.xml
ในไฟล์ Manifest ของแอปโดยทำตามขั้นตอนต่อไปนี้
ในไฟล์ Manifest ของแอป (
AndroidManifest.xml
) ให้ค้นหากิจกรรมที่มีการตั้งค่าตัวกรอง Intent เป็นการดำเนินการandroid.intent.action.MAIN
และหมวดหมู่android.intent.category.LAUNCHER
เพิ่มการอ้างอิงไปยัง
shortcuts.xml
ในAndroidManifest.xml
โดยใช้แท็ก<meta-data>
ในActivity
ที่มีตัวกรอง Intent สำหรับทั้งMAIN
และLAUNCHER
ดังนี้<meta-data android:name="android.app.shortcuts" android:resource="@xml/shortcuts" />
ตัวอย่างข้างต้นจะประกาศทรัพยากร XML สำหรับไฟล์ xml/shortcuts.xml
ใน APK ดูรายละเอียดเพิ่มเติมเกี่ยวกับการกำหนดค่าทางลัดได้ที่หัวข้อสร้างทางลัดแบบคงที่ในเอกสารประกอบสำหรับนักพัฒนาแอป Android
คุณต้องมีไลบรารี Jetpack androidx.core:core:1.6.0
(หรือสูงกว่า) ในโปรเจ็กต์ Android เพื่อหลีกเลี่ยงข้อผิดพลาดในการคอมไพล์เมื่อกำหนดความสามารถของการดำเนินการของแอปใน shortcuts.xml
โปรดดูรายละเอียดที่หัวข้อเริ่มต้นใช้งาน Android Jetpack
แป้นพิมพ์ลัดแบบคงที่
เมื่อกําหนด capability
คุณสามารถประกาศองค์ประกอบ shortcut
แบบคงที่ใน shortcuts.xml
เพื่อขยายฟังก์ชันการทํางานของความสามารถ Assistant จะนำเข้าทางลัดแบบคงที่เมื่อคุณอัปโหลดรุ่นไปยัง Google Play Console
เนื่องจากทางลัดแบบคงที่สามารถสร้างและอัปเดตได้โดยการเผยแพร่เวอร์ชันใหม่เท่านั้น ทางลัดจึงมีประโยชน์มากที่สุดในการไฮไลต์กิจกรรมและเนื้อหาทั่วไปในแอป
คุณเปิดใช้ฟังก์ชันการทำงานของแอปต่อไปนี้ได้ด้วยทางลัดแบบคงที่
แป้นพิมพ์ลัดของความสามารถ สร้างทางลัดที่เปิดอินสแตนซ์ของ
capability
ที่มีค่าพารามิเตอร์intent
ที่กำหนดไว้ล่วงหน้า เช่น คุณอาจประกาศทางลัดของแอป "เริ่มการวิ่ง" ซึ่งจะเรียกใช้ความสามารถ BII ของSTART_EXERCISE
ในแอปฟิตเนสซึ่งจะมีแอตทริบิวต์
intent
,shortLabel
และlongLabel
ทำให้มีสิทธิ์ได้รับการแนะนำและแสดงเป็นชิปในแพลตฟอร์มที่ทำงานแบบเชิงรุก เช่น Assistant หรือเมื่อกดไอคอนแอปบน Launcher ของ Android ค้างไว้ ทางลัดการดําเนินการยังสามารถเป็นทางลัดเอนทิตีตามรายละเอียดด้านล่าง โดยเชื่อมโยงทางลัดกับcapability
โดยใช้แท็ก<capability-binding>
แป้นพิมพ์ลัดของเอนทิตี ทางลัดเอนทิตีแสดงรายการค่าพารามิเตอร์ที่รองรับสำหรับการตอบสนองการค้นหาด้วยเสียงของ
capability
เช่น แป้นพิมพ์ลัดเอนทิตีที่มีรายการประเภทการออกกำลังกาย ("ปีนเขา" "วิ่ง" ฯลฯ) ที่เชื่อมโยงกับพารามิเตอร์exercise.name
BII ของความสามารถSTART_EXERCISE
หากคำพูดของผู้ใช้ตรงกับเอนทิตี ระบบจะส่งรหัสshortcutId
ไปยัง Intent แทนค่าการค้นหาของผู้ใช้แบบดิบแป้นพิมพ์ลัด
Entity
ไม่ได้กำหนดแอตทริบิวต์intent
,shortLabel
หรือlongLabel
จึงไม่แนะนำให้ใช้ในแพลตฟอร์มเชิงรุก โปรดดูรายละเอียดที่หัวข้อพื้นที่โฆษณาแบบอินไลน์สำหรับการดำเนินการของแอป
สคีมาความสามารถ
ตารางต่อไปนี้อธิบายสคีมาการดําเนินการของแอปสําหรับองค์ประกอบ capability
ใน shortcuts.xml
เมื่อใส่แท็ก จะต้องระบุแอตทริบิวต์ทั้งหมดของแท็กนั้น เว้นแต่จะระบุว่า "ไม่บังคับ"
แท็ก Shortcuts.xml | อยู่ใน | แอตทริบิวต์ |
---|---|---|
<capability> |
<shortcuts> |
|
<intent> |
<capability> |
|
<url-template> |
<intent> |
|
<extra> |
<intent> |
ใช้ได้กับการเรียกใช้แอปที่ทำงานอยู่เบื้องหน้าเท่านั้น |
<parameter> |
<intent> |
|
<shortcut-fulfillment> |
<capability> |
ใช้ได้กับพื้นที่โฆษณาในบรรทัดเท่านั้น |
<parameter> |
<shortcut-fulfillment> |
android:name |
<slice> |
<capability> |
ใช้ได้กับ Android Slice เท่านั้น |
คำอธิบายสคีมาความสามารถ
ส่วนนี้จะอธิบายองค์ประกอบสคีมา capability
<capability>
capability
ที่กําหนด Intent การดําเนินการของแอปที่แอปของคุณรองรับ องค์ประกอบ <capability>
แต่ละรายการในไฟล์ shortcuts.xml
ต้องมี <intent>
อย่างน้อย 1 รายการเพื่อจัดการการดำเนินการ
แอตทริบิวต์:
android:name
: รหัสการดำเนินการของ Intent ในตัว (เช่น [actions.intent.GET_FOOD_OBSERVATION
][]) ดูรายการ Intent ในตัวที่รองรับได้ที่ข้อมูลอ้างอิง Intent ในตัวapp:queryPatterns
: ทรัพยากรอาร์เรย์สตริงของคําค้นหาที่คาดหวังจากผู้ใช้สำหรับความตั้งใจนี้ แอตทริบิวต์นี้ใช้ได้เฉพาะกับความตั้งใจที่กำหนดเอง เนื่องจาก BII มีโมเดลวิธีทั่วไปที่ผู้ใช้แสดงงานที่ตนพยายามทำ หรือข้อมูลที่ผู้ใช้ค้นหาอยู่แล้ว
<intent>
องค์ประกอบ intent
ของ Android ที่กําหนดวิธีตอบสนองคําค้นหาของผู้ใช้โดยใช้ฟังก์ชันการทํางานในแอป นักพัฒนาซอฟต์แวร์อาจมีแท็ก <intent>
หลายรายการใน capability
Assistant จะพยายามดำเนินการตามคำค้นหาของผู้ใช้โดยใช้ <intent>
รายการแรกใน capability
ที่มีพารามิเตอร์ที่จำเป็นทั้งหมด
แอตทริบิวต์:
android:action
: ประเภท IntentAction
ค่าเริ่มต้นคือACTION_VIEW
android:targetClass
: คลาสกิจกรรมเป้าหมาย เช่น"com.example.exercise.ExerciseActivity"
android:targetPackage
: แพ็กเกจที่มีคลาสกิจกรรมเป้าหมาย เช่น"com.example.exercise
android:data
:<url-template>
จะเขียนทับฟิลด์นี้หากมีการประกาศแท็กนั้นในintent
<เทมเพลต URL>
เทมเพลตสำหรับสร้าง URI ของ Deep Link ที่จะเปิดในอุปกรณ์ ระบบอาจขยายเทมเพลตด้วยพารามิเตอร์ Intent ในตัว หากมีพารามิเตอร์ที่จําเป็นสําหรับเทมเพลตทั้งหมด ดูตัวอย่างเทมเพลต URL ของ HTTP ได้ที่บทความใน Wikipedia เกี่ยวกับเทมเพลต URL รูปแบบเทมเพลตเป็นไปตามข้อกำหนดของเทมเพลต URI RFC6570
ตัวอย่างค่าเทมเพลต URL มีดังนี้
เทมเพลต | ค่า | ค่าแบบขยาย |
---|---|---|
https://example.com/test{?foo,bar} |
"foo": "123"
|
https://example.com/test?foo=123&bar=456 |
https://example.com/test?utm_campaign=appactions{&foo,bar} |
"foo": "123"
|
https://example.com/test?utm_campaign=appactions&foo=123&bar=456 |
https://example.com/test?utm_campaign=appactions{#foo} |
"foo": "123" |
https://example.com/test?utm_campaign=appactions#foo=123 |
myapp://example/{foo} |
"foo": "123" |
myapp://example/123 |
ดูข้อมูลเพิ่มเติมเกี่ยวกับการกําหนดค่าเทมเพลต URL ได้ที่เทมเพลต URL ในการจำหน่าย
<extra>
กําหนดข้อมูลเพิ่มเติมสําหรับ intent
สำหรับการดำเนินการของแอป ระบบจะใช้ช่องนี้เพื่อเปิดใช้ [การเรียกใช้แอปที่ทำงานอยู่เบื้องหน้า][] สำหรับ capability
เท่านั้น
<พารามิเตอร์>
แมปพารามิเตอร์ BII กับค่าพารามิเตอร์ Intent ดูข้อมูลเพิ่มเติมได้ที่ข้อมูลพารามิเตอร์และการจับคู่
แอตทริบิวต์:
android:name
: ชื่อพารามิเตอร์ BII ที่จะเชื่อมโยงกับพารามิเตอร์intent
นี้ ชื่อควรเป็นช่องระดับใบของพารามิเตอร์ BII (เช่นfoodObservation.aboutFood.name
)android:key
: คีย์ที่นักพัฒนาแอปกำหนดสำหรับค่าพารามิเตอร์ BII เช่น คุณอาจกำหนดcontact_name
สำหรับพารามิเตอร์ BIImessage.recipient.name
android:mimeType
: mimeType ของพารามิเตอร์ เช่นtext/*
ต้องระบุช่องนี้สำหรับพารามิเตอร์ของIntent ที่กําหนดเองเท่านั้นandroid:required
: ประกาศว่าข้อความค้นหาของผู้ใช้ต้องระบุพารามิเตอร์นี้หรือไม่เพื่อให้ระบบใช้ความตั้งใจนี้เพื่อการดำเนินการ หากไม่มีพารามิเตอร์นี้ Assistant จะพยายามดำเนินการตามคำค้นหาของผู้ใช้โดยใช้intent
รายการถัดไปที่กําหนดไว้สําหรับcapability
<ทางลัดสำหรับการดำเนินการตามคำสั่งซื้อ>
ระบุว่าให้ใช้ intent
ที่กําหนดไว้ในทางลัดพื้นที่โฆษณาในบรรทัดสําหรับพารามิเตอร์ที่ระบุเพื่อการดำเนินการตามคำสั่งซื้อ
โปรดดูรายละเอียดที่หัวข้อการดำเนินการโดยใช้ Intent ทางลัด
<parameter> (สำหรับ <shortcut-fulfillment>
)
แอตทริบิวต์ที่ไม่บังคับซึ่งแมปพารามิเตอร์ BII รายการเดียวกับการแสดงสินค้าคงคลังในบรรทัดเพื่อดำเนินการตามคำสั่งซื้อ โปรดดูรายละเอียดที่หัวข้อการดำเนินการโดยใช้ Intent ทางลัด
แอตทริบิวต์:
android:name
: ชื่อพารามิเตอร์ BII เพื่อเชื่อมโยงกับการแสดงโฆษณาในพื้นที่โฆษณาในบรรทัด การตอบสนองทางลัด ชื่อควรเป็นช่องระดับใบของพารามิเตอร์ BII (เช่นmenuItem.name
)
<slice>
ช่วยให้ Assistant สามารถฝังผลการค้นหาที่ตรงกับ capability
นี้เป็นการแบ่งข้อมูล Android ดูรายละเอียดได้ที่
ผสานรวมการดำเนินการของแอปกับ Android Slice
สคีมาทางลัด
ตารางต่อไปนี้อธิบายแอตทริบิวต์ขององค์ประกอบ shortcut
ที่ใช้เพื่อเปิดใช้ฟังก์ชันการทํางานของแอป เมื่อรวมแท็ก คุณต้องระบุแอตทริบิวต์ทั้งหมดของแท็ก เว้นแต่จะระบุว่า "ไม่บังคับ"
แท็ก Shortcuts.xml | อยู่ใน | แอตทริบิวต์ |
---|---|---|
<shortcut> |
<shortcuts> |
|
<intent> |
<shortcut> |
|
<capability-binding> |
|
|
<parameter-binding> |
<capability-binding> |
|
<extra> |
<shortcut> |
ใช้ได้กับการจับคู่พารามิเตอร์ Enum เท่านั้น |
คำอธิบายสคีมาทางลัด
ส่วนนี้จะอธิบายองค์ประกอบสคีมา shortcut
<ทางลัด>
<shortcut>
ของ Android ที่กําหนดไว้ใน shortcuts.xml
ซึ่งมีแอตทริบิวต์บางอย่างที่เกี่ยวข้องกับการกระทําของแอป ค่าสตริงสำหรับช่อง shortcutShortLabel
และ shortcutLongLabel
มีการอ้างอิงผ่านทรัพยากรสตริงของ APK
แอตทริบิวต์:
android:shortcutId
: ตัวระบุสำหรับทางลัดนี้android:shortcutShortLabel
: ทรัพยากรสตริงที่แสดงวลีทางลัดสั้นๆ เช่น"@string/callDavidShort"
ที่แสดงค่า "โทรหา David"android:shortcutLongLabel
: ทรัพยากรสตริงที่แสดงวลีทางลัดแบบยาว เช่น"@string/callDavidLong"
ที่แสดงค่า "โทรเสียงหา David"
<intent>
Intent ของ Android ที่เชื่อมโยงกับทางลัดนี้ ระบบจะเรียกใช้ intent
นี้เมื่อผู้ใช้เปิดทางลัดนี้โดยใช้เสียงหรือการแตะ
แอตทริบิวต์ Intent shortcut
เหมือนกับแอตทริบิวต์ capability
intent
<capability-binding>
เชื่อมโยง shortcut
กับ capability
การดำเนินการของแอป การเพิ่มองค์ประกอบนี้ลงใน shortcut
จะเปิดใช้การตอบสนองด้วยเสียงโดยใช้ Assistant
แอตทริบิวต์:
android:key
: แอตทริบิวต์android:name
ของcapability
ที่เชื่อมโยงกับshortcut
เช่นactions.intent.START_EXERCISE
<parameter-binding>
แอตทริบิวต์ที่ไม่บังคับซึ่งเชื่อมโยง shortcut
กับพารามิเตอร์เดียวของ App Action capability
หากมีการกําหนด parameter-binding
สําหรับ shortcut
คุณจะใช้ทางลัดเพื่อระบุเอนทิตีสินค้าคงคลังในบรรทัดให้กับพารามิเตอร์ BII ได้
โปรดดูรายละเอียดเพิ่มเติมที่หัวข้อพื้นที่โฆษณาในบรรทัดสําหรับ App Actions
แอตทริบิวต์:
android:key
: ชื่อพารามิเตอร์ BIIcapability
ที่จะเชื่อมโยงกับทางลัดนี้ เช่นexercise.name
android:value
: ค่าentity
ซึ่งอาจเป็นentity
รายการเดียวหรือรายการทรัพยากรก็ได้
<extra>
extra
แพ็กเกจข้อมูลสำหรับทางลัด sameAs เป็นข้อมูลเดียวที่เกี่ยวข้องกับองค์ประกอบ shortcut
ของ App Actions URL sameAs หมายถึงหน้าเว็บอ้างอิงที่ระบุเอนทิตีอย่างชัดเจน ใช้เพื่อระบุค่า Enum เฉพาะในกรณีที่ประเภทพารามิเตอร์ Intent เป็นประเภทย่อยของ schema.org/Enumeration และต้องระบุสำหรับช่องพารามิเตอร์
ที่มีประเภทย่อยของ schema.org/Enumeration
(เช่น
MealTypeBreakfast
)
แอตทริบิวต์:
android:key
: ค่าที่รองรับสำหรับการดำเนินการของแอปคือsameAs
android:value
: ค่า URLsameAs
ดูรายละเอียดเพิ่มเติมได้ที่การจับคู่ค่าพารามิเตอร์แบบแจกแจง
ตัวเลือกการดำเนินการตาม Intent
คุณกําหนดองค์ประกอบ intent
ภายใน <capability>
เพื่อประกาศวิธีที่ Assistant จะตอบสนองหรือดําเนินการตามคําสั่งเสียงของผู้ใช้ที่ตรงกับความสามารถดังกล่าว การกำหนดค่าวิธีที่ intent
เปิดใช้งานปลายทางการจำหน่ายสินค้าในแอปมีหลายวิธี โดยขึ้นอยู่กับโครงสร้างการนําทางของแอป
ตัวเลือกการจำหน่ายที่ใช้ได้มีดังนี้
Intent ที่ชัดเจน: เปิดคอมโพเนนต์แอปที่เฉพาะเจาะจงโดยกำหนดแอตทริบิวต์
targetClass
และtargetPackage
สำหรับintent
ซึ่งเป็นวิธีการดำเนินการของแอปที่แนะนำDeep Link: เปิดปลายทางแอปโดยใช้ Deep Link ของ Android โดยกําหนดแท็ก
<url-template>
ภายในองค์ประกอบintent
วิธีนี้มีประโยชน์หากการนำทางของแอปใช้ Deep Link อยู่แล้วข้อมูล Intent: คุณสามารถระบุ URI การจำหน่ายสินค้าในแอตทริบิวต์
intent
android:data
ระบบจะเขียนทับข้อมูล<url-template>
ลงในช่องนี้หากมีการกําหนดแท็กนั้นภายในintent
ด้วย
ข้อมูลและการจับคู่พารามิเตอร์
โดยค่าเริ่มต้น Assistant จะส่งพารามิเตอร์ BII ที่ดึงมาจากคำค้นหาของผู้ใช้ไปยังแอปของคุณเป็นข้อมูล extra
ของ intent
Android ที่ระบุไว้ใน capability
หรือจะประกาศแท็ก <url-template>
ใน capability
ที่มีตัวยึดตําแหน่งสําหรับพารามิเตอร์แบบไดนามิกก็ได้ เทมเพลตนี้จะแมปกับกิจกรรม Android รายการใดรายการหนึ่งโดยใช้ App Links URL, สคีมที่กำหนดเอง หรือ URL ตาม Intent
การใช้ Intent Extras
ตัวอย่างต่อไปนี้แสดง Intent ที่ชัดเจนซึ่งกําหนดไว้สําหรับการตอบสนอง capability
<capability android:name="actions.intent.START_EXERCISE">
<intent
android:targetPackage="com.example.myapp"
android:targetClass="com.example.myapp.ExerciseActivity">
<parameter android:name="exercise.name" android:key="exercise" />
</intent>
</capability>
จากตัวอย่างข้างต้น สำหรับการค้นหาของผู้ใช้อย่าง "Ok Google สั่งลาเต้จาก ExampleApp" แอปจะได้รับ intent
ที่เรียกคอมโพเนนต์ดังนี้ targetPackage
, targetClass
คอมโพเนนต์ได้รับ Extra ด้วย key = "exercise"
, value = "Running"
การใช้เทมเพลต URL สําหรับ Deep Link ของ Android
หากแอปจัดการ URL ที่ลิงก์กับแอปอยู่แล้วด้วยพารามิเตอร์แบบไดนามิก คุณจะกำหนด <url-template>
ใน intent
เพื่อสร้าง Deep Link ของ Android สำหรับ Fulfillment ได้ ตัวอย่างต่อไปนี้จะกําหนด <url-template>
<capability android:name="actions.intent.START_EXERCISE">
<intent>
<url-template android:value="myapp://start{?exercise}" />
<parameter android:name="exercise.name" android:key="exercise" />
</intent>
</capability>
จากตัวอย่างข้างต้น เมื่อผู้ใช้ค้นหาว่า "Ok Google สั่งลาเต้จาก ExampleApp" แอปจะได้รับ URL ที่สร้างขึ้น ซึ่งก็คือ "myapp://start?exercise=Running"
หากต้องการแมปพารามิเตอร์ BII กับตําแหน่งใน URL ให้ใช้แอตทริบิวต์ android:name
ของแท็ก <parameter>
แอตทริบิวต์นี้ตรงกับค่า android:key
ในเทมเพลต URL ที่ต้องการแทนที่ด้วยข้อมูลจากผู้ใช้ ค่า android:key
ต้องอยู่ใน <url-template>
และอยู่ในวงเล็บปีกกา ({}
)
จับคู่ค่าพารามิเตอร์ที่แจกแจง
พารามิเตอร์ BII บางรายการระบุค่าที่ระบุรายการสำหรับความตั้งใจในการดำเนินการ เช่น ค่าข้อความที่รองรับของ BII RECORD_FOOD_OBSERVATION
สำหรับพารามิเตอร์เหล่านี้ Assistant จะจับคู่การค้นหาของผู้ใช้ ("Breakfast") กับเอนทิตีที่มีค่า sameAs
ตรงกับ URL สคีมา enum (https://schema.googleapis.com/MealTypeBreakfast
) หากต้องการเชื่อมโยงค่า enum สำหรับ entity
ที่รองรับ คุณต้องประกาศการเชื่อมโยง sameAs
ใน shortcut
ตัวอย่างต่อไปนี้แสดงการเชื่อมโยง sameAs
สําหรับทางลัดเอนทิตีในบรรทัด
<shortcut android:shortcutId="meal_breakfast" >
<capability-binding android:key="actions.intent.RECORD_FOOD_OBSERVATION">
<parameter-binding android:key="foodObservation.forMeal" />
</capability-binding>
<extra
android:key="sameAs"
android:value="http://schema.googleapis.com/MealTypeBreakfast" />
</shortcut>
<capability android:name="actions.intent.RECORD_FOOD_OBSERVATION">
<intent targetPackage="com.example.app" targetClass="com.example.app.Class">
<parameter android:name="foodObservation.forMeal" android:key="for_meal" />
</intent>
</capability>
ในตัวอย่างข้างต้น หากความสามารถ RECORD_FOOD_OBSERVATION
ทริกเกอร์การจับคู่สำหรับประเภทอาหาร "breakfast" ระบบจะส่งข้อมูลเพิ่มเติมต่อไปนี้พร้อมกับการตอบสนอง intent
key = "for_meal"
value = "meal_breakfast"
ฟีเจอร์
ฟีเจอร์การดำเนินการของแอปต่อไปนี้พร้อมให้บริการใน shortcuts.xml
พื้นที่โฆษณาในบรรทัดสําหรับการดําเนินการของแอป
สำหรับพารามิเตอร์ BII บางรายการ แป้นพิมพ์ลัดสามารถใช้เป็นแนวทางในการดึงข้อมูลเอนทิตีไปยังชุดเอนทิตีที่รองรับซึ่งระบุไว้ใน shortcuts.xml
ซึ่งเรียกว่า "พื้นที่โฆษณาแบบอินไลน์" โปรดดูรายละเอียดที่หัวข้อพื้นที่โฆษณาแบบอินไลน์
ความตั้งใจที่กำหนดเอง
คุณสามารถประกาศ Intent ที่กำหนดเองใน shortcuts.xml
เพื่อเปิดใช้ฟีเจอร์เปิดใช้ฟีเจอร์ในแอปซึ่งไม่ตรงกับ BII ที่ให้บริการด้วยเสียง แม้ว่าจะคล้ายกับคำจำกัดความ BII ในด้านฟังก์ชันการทำงาน แต่ Intent ที่กําหนดเองต้องมีแอตทริบิวต์เพิ่มเติม 2 รายการใน shortcuts.xml
ดังนี้
app:queryPatterns
: ทรัพยากรอาร์เรย์ที่ประกาศรูปแบบการค้นหาต่างๆ สำหรับความตั้งใจที่กำหนดเองandroid:mimeType
: ประเภทพารามิเตอร์ของความตั้งใจที่กําหนดเอง ช่องนี้ไม่จําเป็นสําหรับ BII ที่ทราบประเภทพารามิเตอร์ สําหรับพารามิเตอร์ Intent ที่กําหนดเอง คุณต้องประกาศประเภทเชิงอรรถที่รองรับ
โปรดดูรายละเอียดเพิ่มเติมที่หัวข้อIntent ที่กําหนดเอง