สคีมาลักษณะของ Smart Home InputSelector
action.devices.traits.InputSelector
- ลักษณะนี้ใช้กับอุปกรณ์ที่สลับอินพุตได้
อินพุตสื่ออาจมีชื่อแบบไดนามิกต่ออุปกรณ์ที่แสดงถึงฟีดเสียงหรือวิดีโอ ฟีดเหล่านี้อาจเป็นแบบ Hardwire หรือเครือข่าย แต่ควรตั้งชื่อและมีความต่อเนื่องมากพอ ลักษณะนี้ไม่รองรับฟีดชั่วคราวที่กำหนดเอง เช่น ไลบรารีในเครือข่ายที่ค้นหาได้ รองรับแหล่งที่มาของบลูทูธที่มีชื่อที่จับคู่แล้ว ซอร์สอาจมีได้หลายชื่อ ดังนั้น ระบบรองรับชื่อที่ผู้ใช้สร้างและที่ค้นพบ ตลอดจนชื่อเริ่มต้น เช่น "hdmi_1" อาจเป็น "DVD Player" หรือ "usb_1" อาจเป็น "Hard Drive" ก็ได้
คุณเรียงลำดับอินพุตสื่อเพื่อรองรับคำสั่ง "ถัดไป" และ "ก่อนหน้า" ได้
คุณควรระบุชื่อข้อมูลที่ป้อนในทุกภาษาที่มีเหมือนกัน เช่นเดียวกับ Toggles และ Modes ซึ่งเกี่ยวข้องกับชื่อเริ่มต้นโดยเฉพาะ
ATTRIBUTES ของอุปกรณ์
อุปกรณ์ที่มีลักษณะเช่นนี้อาจรายงานแอตทริบิวต์ต่อไปนี้ซึ่งเป็นส่วนหนึ่งของการดำเนินการ SYNC
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent SYNC
ได้ที่Fulfillment Intent
Attributes | ประเภท | คำอธิบาย |
---|---|---|
availableInputs |
อาร์เรย์ |
ต้องระบุ รายการออบเจ็กต์ที่แสดงฟีดเสียงหรือวิดีโอของอินพุต ฟีดอาจทำแบบ Hardwire หรือเครือข่าย แต่ละฟีดควรตั้งชื่อและมีความเกี่ยวข้องอย่างเหมาะสม โปรดกำหนดคำพ้องความหมายอย่างรอบคอบเพื่อป้องกันการทริกเกอร์ที่ไม่พึงประสงค์ (เกิน) |
[item, ...] |
ออบเจ็กต์ |
อินพุตที่พร้อมใช้งาน |
key |
String |
ต้องระบุ คีย์ที่ไม่ซ้ำกันสำหรับอินพุต ไม่ควรมองเห็นแป้นดังกล่าวต่อผู้ใช้ในการพูดหรือการตอบสนอง |
names |
อาร์เรย์ |
ต้องระบุ รายชื่อของอินพุตสำหรับภาษาทั้งหมดที่ใช้ได้ |
[item, ...] |
ออบเจ็กต์ |
อินพุตสำหรับภาษาที่มีให้ |
lang |
String |
ต้องระบุ รหัสภาษา |
name_synonym |
อาร์เรย์ |
ต้องระบุ ชื่ออินพุตที่ใช้ง่ายในภาษาหนึ่งๆ คําพ้องความหมายแรกจะใช้ในการตอบสนองของ Google Assistant ต่อผู้ใช้ |
[item, ...] |
String |
ชื่ออินพุต |
commandOnlyInputSelector |
บูลีน |
(ค่าเริ่มต้น: ระบุว่าอุปกรณ์รองรับการสื่อสารทางเดียว (จริง) หรือ 2 ทาง (เท็จ) ตั้งค่าแอตทริบิวต์นี้เป็น "จริง" หากอุปกรณ์ไม่สามารถตอบสนองต่อ Intent ของ QUERY หรือสถานะรายงานสำหรับลักษณะนี้ |
orderedInputs |
บูลีน |
(ค่าเริ่มต้น: เป็นจริงถ้าเรียงลำดับรายการเอาต์พุต สิ่งนี้ยังแสดงว่าสามารถใช้ฟังก์ชัน "ถัดไป" และ "ก่อนหน้า" ได้ |
ตัวอย่าง
อุปกรณ์ที่มีอินพุตตามลำดับ 2 ช่อง
{ "availableInputs": [ { "key": "hdmi_1", "names": [ { "lang": "en", "name_synonym": [ "HDMI 1", "1st HDMI", "DVD Player" ] }, { "lang": "de", "name_synonym": [ "HDMI 1", "Zuerst HDMI", "DVD Spieler" ] } ] }, { "key": "usb_1", "names": [ { "lang": "en", "name_synonym": [ "USB 1", "First USB", "Hard Drive" ] }, { "lang": "de", "name_synonym": [ "USB 1", "Zuerst USB", "Festplatte" ] } ] } ], "orderedInputs": true }
สถานะอุปกรณ์
เอนทิตีที่มีลักษณะนี้อาจรายงานสถานะต่อไปนี้ซึ่งเป็นส่วนหนึ่งของการดำเนินการ QUERY
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent QUERY
ได้ที่Fulfillment Intent
รัฐ | ประเภท | คำอธิบาย |
---|---|---|
currentInput |
String |
ต้องระบุ คีย์ของอินพุตที่ใช้อยู่ในขณะนี้ |
ตัวอย่าง
อุปกรณ์ที่มีอินพุต HDMI เลือกไว้ในขณะนี้
{ "currentInput": "hdmi_1" }
COMMANDS ของอุปกรณ์
อุปกรณ์ที่มีลักษณะเช่นนี้อาจตอบสนองต่อคำสั่งต่อไปนี้โดยเป็นส่วนหนึ่งของการดำเนินการ EXECUTE
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent EXECUTE
ได้ที่Fulfillment Intent
action.devices.commands.SetInput
ตั้งค่าอินพุตสื่อ
พารามิเตอร์
พารามิเตอร์ | ประเภท | คำอธิบาย |
---|---|---|
newInput |
String |
ต้องระบุ คีย์ของอินพุตใหม่ |
ตัวอย่าง
เลือกอินพุต USB
{ "command": "action.devices.commands.SetInput", "params": { "newInput": "usb_1" } }
action.devices.commands.NextInput
เลือกอินพุตถัดไป ใช้ได้เฉพาะเมื่อตั้งค่าแอตทริบิวต์ orderedInputs
เป็น "จริง"
{ "orderedInputs": true }
พารามิเตอร์
พารามิเตอร์ | ประเภท | คำอธิบาย |
---|---|---|
ไม่มีพร็อพเพอร์ตี้ |
ตัวอย่าง
ไม่มีพารามิเตอร์
{ "command": "action.devices.commands.NextInput", "params": {} }
action.devices.commands.PreviousInput
เลือกอินพุตก่อนหน้า ใช้ได้เฉพาะเมื่อตั้งค่าแอตทริบิวต์ orderedInputs
เป็น "จริง"
{ "orderedInputs": true }
พารามิเตอร์
พารามิเตอร์ | ประเภท | คำอธิบาย |
---|---|---|
ไม่มีพร็อพเพอร์ตี้ |
ตัวอย่าง
ไม่มีพารามิเตอร์
{ "command": "action.devices.commands.PreviousInput", "params": {} }
ตัวอย่างการเปล่งเสียง
de-DE
- Ändere den Eingangskanal auf AUX .
en-US
- change input mode to HDMI 1
es-ES
- cambia a hdmi 1
fr-FR
- Activation du mode HDMI1 .
- Mets la télé sur HDMI 1 .
hi-IN
- टीवी की इनपुट HDMI 1 में स्विच करो
it-IT
- metti ingresso aux sulla tv
ja-JP
- テレビ HDMI1 にして
ko-KR
- TV HDMI 1 로 바꿔 줘
nl-NL
- zet de TV op bluetooth
pt-BR
- Muda a entrada da TV para HDMI2 .
- mudar a entrada para AUX
sv-SE
- Sätt på hdmi 1
ข้อผิดพลาดเกี่ยวกับอุปกรณ์
ดูรายการข้อผิดพลาดและข้อยกเว้นทั้งหมดunsupportedInput
: ปัจจุบันยังไม่รองรับอินพุต