สคีมาลักษณะ 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 บูลีน

(ค่าเริ่มต้น: false)

ระบุว่าอุปกรณ์รองรับการสื่อสารแบบทางเดียว (จริง) หรือ 2 ทาง (เท็จ) ตั้งค่าแอตทริบิวต์นี้เป็น "จริง" หากอุปกรณ์ตอบสนองต่อ Intent ของ QUERY หรือสถานะรายงานสำหรับลักษณะนี้ไม่ได้

orderedInputs บูลีน

(ค่าเริ่มต้น: false)

จริง หากรายการเอาต์พุตมีการจัดเรียง ซึ่งบ่งบอกว่าฟังก์ชัน "ถัดไป" และ "ก่อนหน้า" พร้อมใช้งานด้วย

ตัวอย่าง

อุปกรณ์ที่มีอินพุตแบบเรียงลำดับ 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: ขณะนี้ระบบยังไม่รองรับอินพุต