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

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

(ค่าเริ่มต้น: 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 ได้ที่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: ปัจจุบันยังไม่รองรับอินพุต