Skema Karakter Saluran Smart Home
action.devices.traits.Channel
- Ciri ini termasuk perangkat yang mendukung saluran TV di perangkat media.
availableChannels
. Daftar ini harus terdiri dari semua channel teratas atau populer yang di-subscribe oleh pengguna atau perangkat. 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 | Jenis | Deskripsi |
---|---|---|
availableChannels |
Array |
Wajib. Daftar objek yang menjelaskan saluran media yang tersedia untuk perangkat ini. Setiap item menjelaskan 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 channel ini. |
[item, ...] |
String |
Nama saluran. |
number |
String |
ID numerik opsional untuk saluran ini. |
commandOnlyChannels |
Boolean |
(Default: 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. |
Contoh
Perangkat yang mendukung dua saluran.
{ "availableChannels": [ { "key": "ktvu2", "names": [ "Fox", "KTVU" ], "number": "2" }, { "key": "abc1", "names": [ "ABC", "ABC East" ], "number": "4-11" } ] }
STATUS Perangkat
Tidak ada.
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.selectChannel
Setel saluran saat ini ke nilai tertentu.
Parameter
Payload berisi salah satu dari hal berikut:
Pilih channel menurut ID
Parameter | Jenis | Deskripsi |
---|---|---|
channelCode |
String |
Wajib. ID unik untuk saluran yang diminta, yang cocok dengan salah satu |
channelName |
String |
Nama channel yang diminta yang mudah digunakan. |
channelNumber |
String |
ID numerik untuk saluran yang diminta. |
Pilih channel menurut nomor
Parameter | Jenis | 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" } }
Error terkait
Terjadi error saat memilih saluran baru pada perangkat.
Nilai yang didukung:
noAvailableChannel
noChannelSubscription
channelSwitchFailed
action.devices.commands.relativeChannel
Sesuaikan saluran saat ini dengan jumlah relatif.
Parameter
Parameter | Jenis | Deskripsi |
---|---|---|
relativeChannelChange |
Integer |
Wajib. Jumlah saluran 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 } }
Error terkait
Terjadi error saat menyesuaikan saluran perangkat.
Nilai yang didukung:
channelSwitchFailed
action.devices.commands.returnChannel
Kembali ke saluran terakhir/sebelumnya tempat pengguna berada.
Parameter
Parameter | Jenis | Deskripsi |
---|---|---|
Tidak ada properti |
Contoh
Kembali ke channel terakhir
{ "command": "action.devices.commands.returnChannel", "params": {} }
Error terkait
Terjadi error saat kembali ke saluran terakhir perangkat.
Nilai yang didukung:
channelSwitchFailed