Skema Karakter Saluran Smart Home

action.devices.traits.Channel - Ciri ini termasuk perangkat yang mendukung saluran TV di perangkat media.

Saluran yang tersedia harus dibagikan sebagai daftar, per pengguna atau perangkat, selama SYNC melalui atribut 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: 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.

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 availableChannels.
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

Perangkat ERRORS

Lihat daftar lengkap error dan pengecualian.