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

แบบแผน Smart Input ของ Smart Home

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

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

สามารถเรียงลําดับอินพุตสื่อเพื่อรองรับคําสั่ง "ถัดไป" และ "ก่อนหน้า" ได้

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

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

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

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

ต้องระบุ

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

[item, ...] ออบเจ็กต์

อินพุตที่มี

key สตริง

ต้องระบุ

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

names อาร์เรย์

ต้องระบุ

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

[item, ...] ออบเจ็กต์

อินพุตสําหรับภาษาที่ระบุ

lang สตริง

ต้องระบุ

รหัสภาษา

name_synonym อาร์เรย์

ต้องระบุ

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

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

ป้อนชื่อ

commandOnlyInputSelector บูลีน

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

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

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
}

อุปกรณ์ STATES

เอนทิตีที่มีลักษณะนี้อาจรายงานสถานะต่อไปนี้เป็นส่วนหนึ่งของการดําเนินการ QUERY หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ QUERY โปรดดูการดําเนินการ Intent

รัฐ Type คำอธิบาย
currentInput สตริง

ต้องระบุ

คีย์ของอินพุตที่ใช้งานอยู่ในปัจจุบัน

ตัวอย่าง

อุปกรณ์ที่เลือกอินพุต HDMI อยู่

{
  "currentInput": "hdmi_1"
}

อุปกรณ์ COMMANDS

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

action.devices.commands.SetInput

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

พารามิเตอร์

พารามิเตอร์ Type คำอธิบาย
newInput สตริง

ต้องระบุ

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

ตัวอย่าง

เลือกอินพุต USB

{
  "command": "action.devices.commands.SetInput",
  "params": {
    "newInput": "usb_1"
  }
}

action.devices.commands.NextInput

เลือกอินพุตถัดไป ใช้ได้เฉพาะเมื่อตั้งค่าแอตทริบิวต์ orderedInputs เป็น "จริง"

คําสั่งนี้จําเป็นต้องมีแอตทริบิวต์ต่อไปนี้
{
  "orderedInputs": true
}

พารามิเตอร์

พารามิเตอร์ Type คำอธิบาย

ไม่มีพร็อพเพอร์ตี้

ตัวอย่าง

ไม่มีพารามิเตอร์

{
  "command": "action.devices.commands.NextInput",
  "params": {}
}

action.devices.commands.PreviousInput

เลือกอินพุตก่อนหน้า ใช้ได้เฉพาะเมื่อตั้งค่าแอตทริบิวต์ orderedInputs เป็น "จริง"

คําสั่งนี้จําเป็นต้องมีแอตทริบิวต์ต่อไปนี้
{
  "orderedInputs": true
}

พารามิเตอร์

พารามิเตอร์ Type คำอธิบาย

ไม่มีพร็อพเพอร์ตี้

ตัวอย่าง

ไม่มีพารามิเตอร์

{
  "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: ยังไม่รองรับการป้อนข้อมูลในขณะนี้