Akıllı Ev Kanalı Özelliği Şeması

action.devices.traits.Channel - Bu özellik, bir medya cihazında TV kanallarını destekleyen cihazlara aittir.

Kullanılabilir kanallar, availableChannels özelliği aracılığıyla SYNC sırasında kullanıcı veya cihaz başına bir liste olarak paylaşılmalıdır. Bu liste, kullanıcının veya cihazın abone olduğu tüm popüler kanalları içermelidir. Sorgu gecikmesinin düşük olması için kanal listesini küçük tutmanızı (30 kanal veya daha az) öneririz.

Cihaz ÖZELLİKLERİ

Bu özelliğe sahip cihazlar, SYNC işlemi kapsamında aşağıdaki özellikleri bildirebilir. SYNC amaçlarını ele alma hakkında daha fazla bilgi edinmek için Amacı karşılama başlıklı makaleyi inceleyin.

Özellikler Tür Açıklama
availableChannels Array

Zorunlu.

Bu cihazda kullanılabilen medya kanallarını açıklayan nesnelerin listesi. Her öğe, kullanıcının bu cihazda seçebileceği bir kanalı açıklar.
[item, ...] Nesne

Kullanılabilir medya kanalı.
key String

Zorunlu.

Bu kanalın benzersiz tanımlayıcısı. Kullanıcılara gösterilmez.
names Array

Zorunlu.

Bu kanalın kullanıcı tarafından görülebilen adlarının listesi.
[item, ...] String

Kanal adı.
number String

Bu kanal için isteğe bağlı sayısal tanımlayıcı.
commandOnlyChannels Boole

(Varsayılan: false)

Cihazın tek yönlü (doğru) veya iki yönlü (yanlış) iletişimi destekleyip desteklemediğini gösterir. Cihaz, bu özellik için QUERY amacına veya Durum Raporu'na yanıt veremiyorsa bu özelliği doğru olarak ayarlayın.

Örnekler

İki kanalı destekleyen cihaz.

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

Cihaz DURUMLARI

Yok.

Cihaz KOMUTLARI

Bu özelliğe sahip cihazlar, EXECUTE işlemi kapsamında aşağıdaki komutlara yanıt verebilir. EXECUTE amaçlarını ele alma hakkında daha fazla bilgi edinmek için Amacı karşılama başlıklı makaleyi inceleyin.

action.devices.commands.selectChannel

Geçerli kanalı belirli bir değere ayarlayın.

Parametreler

Yük aşağıdakilerden birini içeriyor:

Kimliğe göre kanal seçme

Parametreler Tür Açıklama
channelCode String

Zorunlu.

İstenen kanalın benzersiz tanımlayıcısıdır ve availableChannels değerlerinden biriyle eşleşir.
channelName String

İstenen kanalın kullanıcı dostu adı.
channelNumber String

İstenen kanalın sayısal tanımlayıcısı.

Kanalı numarasına göre seçme

Parametreler Tür Açıklama
channelNumber String

Zorunlu.

İstenen kanalın sayısal tanımlayıcısı.

Örnekler

KTVU'ya geçiş

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

Üçüncü kanala geç.

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

Cihazda yeni bir kanal seçilirken hata oluştu.

Desteklenen değerler:

noAvailableChannel
noChannelSubscription
channelSwitchFailed

action.devices.commands.relativeChannel

Mevcut kanalı göreli bir miktarla ayarlayın.

Parametreler

Parametreler Tür Açıklama
relativeChannelChange Integer

Zorunlu.

Artırılacak veya azaltılacak kanal sayısı.

Örnekler

Sonraki kanala geçme

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

Önceki kanala geçme

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

Cihazın kanalı ayarlanırken bir hata oluştu.

Desteklenen değerler:

channelSwitchFailed

action.devices.commands.returnChannel

Kullanıcının bulunduğu son/önceki kanala dönme.

Parametreler

Parametreler Tür Açıklama

Özellik yok

Örnekler

Son kanala dönme

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

Cihazın son kanalına dönülürken bir hata oluştu.

Desteklenen değerler:

channelSwitchFailed

Cihaz HATALARI

Hatalar ve istisnalar listesinin tamamını inceleyin.