Skema Fitur InputSelector Smart Home

action.devices.traits.InputSelector - Sifat ini digunakan untuk perangkat yang dapat beralih input.

Input media dapat memiliki nama dinamis per perangkat yang merepresentasikan feed audio atau video. Feed ini dapat berupa hardcode atau jaringan, tetapi harus diberi nama dan persisten. Sifat ini tidak mendukung feed ephemeral arbitrer, seperti library berjaringan yang dapat ditelusuri. Sumber Bluetooth yang disambungkan dan diberi nama didukung. Sumber dapat memiliki beberapa nama, jadi nama yang dibuat dan ditemukan pengguna didukung, serta nama default; misalnya, 'hdmi_1' mungkin juga 'Pemutar DVD', atau 'usb_1' juga dapat berupa 'Hard drive'.

Input media dapat diurutkan untuk mendukung perintah 'next' dan 'previous'.

Seperti halnya Toggle dan Mode, nama input harus disediakan dalam semua bahasa yang tersedia; terutama relevan untuk nama default.

ATRIBUT Perangkat

Perangkat dengan karakteristik ini dapat melaporkan atribut berikut sebagai bagian dari operasi SYNC. Untuk mempelajari penanganan intent SYNC lebih lanjut, lihat fulfillment intent.

Atribut	Jenis	Deskripsi
availableInputs	Array	Wajib. Daftar objek yang mewakili feed audio atau video input. Feed dapat di-kabel atau jaringan. Setiap feed harus diberi nama dan dipertahankan secara wajar. Pastikan untuk menentukan sinonim dengan cermat untuk mencegah pemicu yang tidak diinginkan (over-over).
[item, ...]	Objek	Input yang tersedia.
key	String	Wajib. Kunci unik untuk input. Kunci tidak boleh diungkap kepada pengguna dalam ucapan atau respons.
names	Array	Wajib. Daftar nama untuk input untuk semua bahasa yang tersedia.
[item, ...]	Objek	Input untuk bahasa tertentu yang tersedia.
lang	String	Wajib. Kode bahasa.
name_synonym	Array	Wajib. Nama yang mudah digunakan untuk input, dalam bahasa tertentu. Sinonim pertama digunakan dalam respons Asisten Google untuk pengguna.
[item, ...]	String	Nama input.
commandOnlyInputSelector	Boolean	(Default: false) Menunjukkan apakah perangkat mendukung penggunaan komunikasi satu arah (benar) atau dua arah (salah). Tetapkan atribut ini ke true jika perangkat tidak dapat merespons intent QUERY atau Status Laporan untuk fitur ini.
orderedInputs	Boolean	(Default: false) True jika daftar output diurutkan. Hal ini juga menunjukkan bahwa fungsi 'berikutnya' dan 'sebelumnya' tersedia.

Contoh

Perangkat dengan dua input yang diurutkan.

{
  "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
}

STATUS Perangkat

Entitas dengan karakteristik ini dapat melaporkan status berikut sebagai bagian dari operasi QUERY. Untuk mempelajari penanganan intent QUERY lebih lanjut, lihat fulfillment intent.

Negara bagian	Jenis	Deskripsi
currentInput	String	Wajib. Kunci input yang saat ini digunakan.

Contoh

Perangkat dengan input HDMI saat ini dipilih.

{
  "currentInput": "hdmi_1"
}

COMMAND Perangkat

Perangkat dengan karakteristik ini dapat merespons perintah berikut sebagai bagian dari operasi EXECUTE. Untuk mempelajari penanganan intent EXECUTE lebih lanjut, lihat fulfillment intent.

action.devices.commands.SetInput

Menyetel input media.

Parameter

Parameter	Jenis	Deskripsi
newInput	String	Wajib. Kunci input baru.

Contoh

Pilih input USB

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

action.devices.commands.NextInput

Pilih input berikutnya. Hanya berlaku jika atribut orderedInputs disetel ke benar (true).

Perintah ini memerlukan atribut berikut:

{
  "orderedInputs": true
}

Parameter

Parameter	Jenis	Deskripsi
Tidak ada properti

Contoh

Tidak ada parameter

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

action.devices.commands.PreviousInput

Pilih input sebelumnya. Hanya berlaku jika atribut orderedInputs disetel ke benar (true).

Perintah ini memerlukan atribut berikut:

{
  "orderedInputs": true
}

Parameter

Parameter	Jenis	Deskripsi
Tidak ada properti

Contoh

Tidak ada parameter

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

Contoh ucapan

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

Perangkat ERRORS

Lihat daftar lengkap error dan pengecualian.

unsupportedInput: Input saat ini tidak didukung.