สคีมาลักษณะ InputSelector สมาร์ทโฮม
action.devices.traits.InputSelector
- ลักษณะนี้ใช้สำหรับอุปกรณ์ที่สามารถสลับอินพุตได้
อินพุตสื่ออาจมีชื่อแบบไดนามิกต่ออุปกรณ์ที่แสดงถึงฟีดเสียงหรือวิดีโอ ฟีดเหล่านี้อาจเป็นแบบใช้สายหรือใช้เครือข่ายก็ได้ แต่ควรตั้งชื่อและคงอยู่อย่างสมเหตุสมผล ลักษณะนี้ไม่รองรับฟีดชั่วคราวที่กําหนดเอง เช่น คลังแบบเครือข่ายที่ค้นหาได้ รองรับต้นทางบลูทูธที่จับคู่แล้ว แหล่งที่มาอาจมีชื่อได้หลายชื่อ จึงรองรับชื่อที่ผู้ใช้สร้างขึ้นและค้นพบ รวมถึงชื่อเริ่มต้น เช่น "hdmi_1" อาจหมายถึง "เครื่องเล่น DVD" หรือ "usb_1" อาจหมายถึง "ฮาร์ดไดรฟ์"
คุณสามารถสั่งซื้ออินพุตสื่อเพื่อรองรับคำสั่ง "ถัดไป" และ "ก่อนหน้า" ได้
เช่นเดียวกับ Toggles และ Modes คุณควรระบุชื่ออินพุตเป็นภาษาทั้งหมดที่ใช้ได้ ซึ่งสำคัญอย่างยิ่งสำหรับชื่อเริ่มต้น
แอตทริบิวต์อุปกรณ์
อุปกรณ์ที่มีลักษณะนี้อาจรายงานแอตทริบิวต์ต่อไปนี้ซึ่งเป็นส่วนหนึ่งของการดำเนินการ SYNC
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ SYNC
ได้ที่การดำเนินการตามคำสั่งซื้อใน Intent
Attributes | ประเภท | คำอธิบาย |
---|---|---|
availableInputs |
อาร์เรย์ |
ต้องระบุ รายการออบเจ็กต์ที่แสดงถึงฟีดเสียงหรือวิดีโออินพุต ฟีดอาจเป็นแบบใช้สายหรือแบบใช้เครือข่ายก็ได้ ฟีดแต่ละรายการควรมีชื่อและคงอยู่อย่างสมเหตุสมผล โปรดกําหนดคําพ้องอย่างรอบคอบเพื่อป้องกันการทริกเกอร์ที่ไม่ต้องการ (มากเกินไป) |
[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
ได้ที่การดำเนินการตาม Intent
รัฐ | ประเภท | คำอธิบาย |
---|---|---|
currentInput |
String |
ต้องระบุ คีย์ของอินพุตที่ใช้อยู่ |
ตัวอย่าง
อุปกรณ์ที่มีอินพุต HDMI ที่เลือกอยู่
{ "currentInput": "hdmi_1" }
คำสั่งของอุปกรณ์
อุปกรณ์ที่มีลักษณะนี้อาจตอบสนองต่อคําสั่งต่อไปนี้ซึ่งเป็นส่วนหนึ่งของการดำเนินการ EXECUTE
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent EXECUTE
ได้ที่การดำเนินการตาม 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
: ขณะนี้ระบบยังไม่รองรับอินพุต