ยินดีต้อนรับสู่ Google Home Developer Center แหล่งใหม่เรียนรู้วิธีพัฒนาการดําเนินการในบ้านอัจฉริยะ หมายเหตุ: คุณจะสร้างการดําเนินการต่างๆ ต่อไปในคอนโซลการดําเนินการ
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

สคีมาของแอตทริบิวต์อินพุตบ้านอัจฉริยะ

action.devices.traits.InputSelector - ลักษณะเฉพาะเหล่านี้ใช้กับอุปกรณ์ที่เปลี่ยนอินพุตได้

อินพุตสื่ออาจมีชื่อแบบไดนามิกต่ออุปกรณ์ 1 เครื่องที่แสดงถึงฟีดเสียงหรือฟีดวิดีโอ ฟีดเหล่านี้อาจเป็นแบบเดินสายไฟหรือแบบเครือข่ายได้ แต่ควรมีการตั้งชื่อและคงอยู่ถาวรอย่างสมเหตุสมผล รูปแบบนี้ไม่รองรับฟีดชั่วคราวที่กําหนดเอง เช่น ไลบรารีเครือข่ายที่ค้นหาได้ รองรับการจับคู่อุปกรณ์บลูทูธที่มีชื่อ แหล่งที่มาอาจมีหลายชื่อ เราจึงรองรับชื่อที่ผู้ใช้สร้างขึ้นและที่ค้นพบ ตลอดจนชื่อเริ่มต้น เช่น "hdmi_1" อาจเป็น "เครื่องเล่น DVD" หรือ "usb_1" อาจเป็น "ฮาร์ดไดรฟ์" ก็ได้

สามารถป้อนข้อมูลสื่อเพื่อรองรับคําสั่ง "ถัดไป" และ "ก่อนหน้า"

เช่นเดียวกับสลับและโหมด คุณควรระบุชื่ออินพุตในทุกภาษาที่ใช้ได้ โดยเฉพาะอย่างยิ่งสําหรับชื่อเริ่มต้น

แอตทริบิวต์อุปกรณ์

อุปกรณ์ที่มีลักษณะเฉพาะนี้อาจรายงานแอตทริบิวต์ต่อไปนี้เป็นส่วนหนึ่งของการดําเนินการ SYNC ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ SYNC ได้ที่การดําเนินการตามความตั้งใจ

แอตทริบิวต์ ประเภท คำอธิบาย
availableInputs อาร์เรย์

ต้องระบุ

รายการออบเจ็กต์ที่แสดงฟีดเสียงหรือฟีดอินพุต ฟีดอาจเป็นแบบใช้สายหรือเครือข่ายได้ แต่ละฟีดควรตั้งชื่อและคงอยู่อย่างสมเหตุสมผล กําหนดคํานิยามของคําพ้องความหมายอย่างละเอียดเพื่อป้องกันทริกเกอร์ (ที่ไม่พึงประสงค์) ที่ไม่พึงประสงค์

[item, ...] วัตถุ

ข้อมูลที่ป้อน

key สตริง

ต้องระบุ

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

names อาร์เรย์

ต้องระบุ

รายชื่ออินพุตสําหรับภาษาทั้งหมดที่พร้อมใช้งาน

[item, ...] วัตถุ

การป้อนข้อมูลสําหรับภาษาที่มีให้บริการ

lang สตริง

ต้องระบุ

รหัสภาษา

name_synonym อาร์เรย์

ต้องระบุ

ชื่อที่ใช้งานได้ง่ายสําหรับการป้อนข้อมูลในภาษาที่ระบุ คําพ้องความหมายแรกจะใช้ในการตอบสนองของผู้ใช้ Google Assistant

[item, ...] สตริง

ชื่ออินพุต

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 ได้ที่การดําเนินการตามความตั้งใจ

รัฐ ประเภท คำอธิบาย
currentInput สตริง

ต้องระบุ

คีย์ของอินพุตที่ใช้งานอยู่ในขณะนี้

ตัวอย่าง

อุปกรณ์ที่มีการป้อนข้อมูล HDMI ที่เลือกไว้ในปัจจุบัน

{
  "currentInput": "hdmi_1"
}

คําสั่งของอุปกรณ์

อุปกรณ์ที่มีลักษณะเฉพาะนี้อาจตอบสนองต่อคําสั่งต่อไปนี้ซึ่งเป็นส่วนหนึ่งของการดําเนินการ EXECUTE ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ EXECUTE ได้ที่การดําเนินการตามความตั้งใจ

action.devices.commands.SetInput

ตั้งค่าอินพุตสื่อ

พารามิเตอร์

พารามิเตอร์ ประเภท คำอธิบาย
newInput สตริง

ต้องระบุ

คีย์ของอินพุตใหม่

ตัวอย่าง

เลือกอินพุต 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

อุปกรณ์ ERRORS

ดูรายการข้อผิดพลาดและข้อยกเว้นทั้งหมด

unsupportedInput: ยังไม่รองรับอินพุตนี้ในขณะนี้