Skema Karakteristik Channel Smart Home

action.devices.traits.Channel - Ciri ini dimiliki oleh perangkat yang mendukung channel TV di perangkat media.

Saluran yang tersedia harus dibagikan sebagai daftar, per pengguna atau perangkat, selama SINKRONISASI melalui atribut availableChannels. Daftar ini harus terdiri dari semua channel populer atau teratas yang disubscribe oleh pengguna atau perangkat. Untuk memastikan latensi kueri yang rendah, sebaiknya jaga agar daftar channel tetap kecil (hingga 30 channel atau kurang).

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

Wajib.

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

Saluran media yang tersedia.
key String

Wajib.

ID unik untuk saluran 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). Tetapkan atribut ini ke benar (true) jika perangkat tidak dapat merespons intent QUERY atau Report State untuk karakteristik 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.

PERINTAH perangkat

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

action.devices.commands.selectChannel

Menetapkan saluran saat ini ke nilai tertentu.

Parameter

Payload berisi salah satu hal berikut:

Pilih channel menurut ID

Parameter Jenis Deskripsi
channelCode String

Wajib.

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

Nama channel yang diminta dan mudah digunakan.
channelNumber String

ID numerik untuk saluran yang diminta.

Pilih channel berdasarkan nomor

Parameter Jenis Deskripsi
channelNumber String

Wajib.

ID numerik untuk saluran yang diminta.

Contoh

Perubahan pada KTVU

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

Pindah ke channel tiga.

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

Terjadi error saat memilih channel baru di perangkat.

Nilai yang didukung:

noAvailableChannel
noChannelSubscription
channelSwitchFailed

action.devices.commands.relativeChannel

Menyesuaikan saluran saat ini dengan jumlah relatif.

Parameter

Parameter Jenis Deskripsi
relativeChannelChange Bilangan Bulat

Wajib.

Jumlah saluran yang akan ditambah atau dikurangi.

Contoh

Beralih ke channel berikutnya

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

Beralih ke saluran sebelumnya

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

Terjadi error saat menyesuaikan channel perangkat.

Nilai yang didukung:

channelSwitchFailed

action.devices.commands.returnChannel

Kembali ke channel terakhir/sebelumnya yang ditonton pengguna.

Parameter

Parameter Jenis Deskripsi

Tidak ada properti

Contoh

Kembali ke channel terakhir

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

Terjadi error saat kembali ke channel terakhir perangkat.

Nilai yang didukung:

channelSwitchFailed

ERROR Perangkat

Lihat daftar lengkap error dan pengecualian.