Skema Trait Saluran Smart Home

action.devices.traits.Channel - Sifat ini termasuk dalam perangkat yang mendukung saluran TV pada perangkat media.

Saluran yang tersedia harus dibagikan sebagai daftar, per pengguna atau perangkat, selama SYNC melalui atribut availableChannels. Daftar ini harus terdiri dari semua saluran teratas atau populer yang digunakan oleh pengguna atau perangkat untuk berlangganan. Untuk memastikan latensi kueri yang rendah, sebaiknya Anda membuat daftar saluran tetap kecil (hingga 30 saluran atau kurang).

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 Type Deskripsi
availableChannels Array

Wajib.

Daftar objek yang menjelaskan saluran media yang tersedia untuk perangkat khusus ini. Setiap item mendeskripsikan saluran yang dapat dipilih pengguna di perangkat ini.
[item, ...] Objek

Saluran media yang tersedia.
key String

Wajib.

ID unik untuk channel ini. Tidak ditampilkan kepada pengguna.
names Array

Wajib.

Daftar nama yang dapat dilihat pengguna untuk saluran ini.
[item, ...] String

Nama saluran.
number String

ID numerik opsional untuk saluran ini.
commandOnlyChannels Boolean

(Default: false)

Menunjukkan apakah perangkat mendukung penggunaan komunikasi satu arah (benar) atau dua arah (salah). Setel atribut ini ke true jika perangkat tidak dapat merespons intent QUERY atau Status Laporan untuk karakteristik ini.

Contoh

Perangkat mendukung dua saluran.

{
  "availableChannels": [
    {
      "key": "ktvu2",
      "names": [
        "Fox",
        "KTVU"
      ],
      "number": "2"
    },
    {
      "key": "abc1",
      "names": [
        "ABC",
        "ABC East"
      ],
      "number": "4-11"
    }
  ]
}

STATE Perangkat

Tidak ada.

PERMINTAAN 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.selectChannel

Tetapkan saluran saat ini ke nilai tertentu.

Parameter

Payload berisi salah satu dari hal berikut:

Pilih channel menurut ID

Parameter Type Deskripsi
channelCode String

Wajib.

ID unik untuk saluran yang diminta, cocok dengan salah satu availableChannels.
channelName String

Nama yang diminta oleh channel yang diminta.
channelNumber String

ID numerik untuk saluran yang diminta.

Pilih channel berdasarkan nomor

Parameter Type Deskripsi
channelNumber String

Wajib.

ID numerik untuk saluran yang diminta.

Contoh

Ubah ke KTVU

{
  "command": "action.devices.commands.selectChannel",
  "params": {
    "channelCode": "ktvu2",
    "channelName": "KTVU"
  }
}

Beralih ke channel ketiga.

{
  "command": "action.devices.commands.selectChannel",
  "params": {
    "channelNumber": "3"
  }
}

Terjadi error saat memilih saluran baru di perangkat.

Nilai yang didukung:

noAvailableChannel
noChannelSubscription
channelSwitchFailed

action.devices.commands.relativeChannel

Sesuaikan saluran saat ini dengan jumlah relatif.

Parameter

Parameter Type Deskripsi
relativeChannelChange Integer

Wajib.

Jumlah channel yang akan ditambah atau dikurangi.

Contoh

Beralih ke channel berikutnya

{
  "command": "action.devices.commands.relativeChannel",
  "params": {
    "relativeChannelChange": 1
  }
}

Beralih ke channel sebelumnya

{
  "command": "action.devices.commands.relativeChannel",
  "params": {
    "relativeChannelChange": -1
  }
}

Terjadi error saat menyesuaikan saluran perangkat.

Nilai yang didukung:

channelSwitchFailed

action.devices.commands.returnChannel

Kembali ke saluran terakhir/sebelumnya tempat pengguna berada.

Parameter

Parameter Type Deskripsi

Tidak ada properti

Contoh

Kembali ke channel terakhir

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

Terjadi error saat kembali ke saluran terakhir perangkat.

Nilai yang didukung:

channelSwitchFailed

ERRORS perangkat

Lihat daftar lengkap error dan pengecualian.