Skema Sifat InputSelector Smart Home

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

Input media dapat memiliki nama dinamis per perangkat yang mewakili feed audio atau video. Feed ini dapat dihubungkan secara langsung atau melalui jaringan, tetapi harus diberi nama dan cukup persisten. Sifat ini tidak mendukung feed sementara arbitrer, seperti library jaringan yang dapat ditelusuri. Sumber Bluetooth tersambung dan bernama didukung. Sumber dapat memiliki beberapa nama, sehingga nama yang dibuat dan ditemukan pengguna didukung, serta nama default; misalnya, 'hdmi_1' juga dapat berupa 'Pemutar DVD', atau 'usb_1' juga dapat berupa 'Hard drive'.

Input media dapat diurutkan untuk mendukung perintah 'berikutnya' dan 'sebelumnya'.

Seperti Toggles dan Modes, nama input harus diberikan dalam semua bahasa yang tersedia; hal ini terutama relevan untuk nama default.

ATRIBUT Perangkat

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

Atribut Jenis Deskripsi
availableInputs Array

Wajib.

Daftar objek yang mewakili feed audio atau video input. Feed dapat menggunakan kabel atau jaringan. Setiap feed harus diberi nama dan cukup persisten. Pastikan untuk menentukan sinonim dengan cermat untuk mencegah pemicuan yang tidak diinginkan (berlebihan).

[item, ...] Objek

Input yang tersedia.

key String

Wajib.

Kunci unik untuk input. Kunci tidak boleh ditampilkan 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 kepada pengguna.

[item, ...] String

Masukkan nama.

commandOnlyInputSelector Boolean

(Default: false)

Menunjukkan apakah perangkat mendukung penggunaan komunikasi satu arah (true) atau dua arah (false). Tetapkan atribut ini ke benar (true) jika perangkat tidak dapat merespons intent QUERY atau Status Pelaporan untuk karakteristik 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 yang saat ini dipilih.

{
  "currentInput": "hdmi_1"
}

Perintah Perangkat

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

action.devices.commands.SetInput

Menetapkan 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 ditetapkan ke benar (true).

Perintah ini memerlukan atribut berikut:
{
  "orderedInputs": true
}

Parameter

Parameter Jenis Deskripsi

Tidak ada properti

Contoh

Tanpa parameter

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

action.devices.commands.PreviousInput

Pilih input sebelumnya. Hanya berlaku jika atribut orderedInputs ditetapkan ke 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

ERROR Perangkat

Lihat daftar lengkap error dan pengecualian.

unsupportedInput: Input saat ini tidak didukung.