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

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

Kullanılabilir kanallar, senkronizasyon sırasında availableChannels özelliği aracılığıyla kullanıcı veya cihaz başına 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 (30 kanal veya daha az) tutmanızı öneririz.

Cihaz ATTRIBUTES

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

Özellikler Tür Açıklama
availableChannels Dizi

Zorunludur.

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

Zorunludur.

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

Zorunludur.

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 belirtir. Cihaz bir QUERY intent'ine yanıt veremiyorsa veya bu özellik için durum raporlayamıyorsa bu özelliği true 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 intent'lerini ele alma hakkında daha fazla bilgi edinmek için Intent 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çerir:

Kimliğe göre kanal seçin

Parametreler Tür Açıklama
channelCode String

Zorunludur.

İstenen kanalın benzersiz tanımlayıcısı. availableChannels ile eşleşir.
channelName String

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

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

Numaraya göre kanal seçin

Parametreler Tür Açıklama
channelNumber String

Zorunludur.

İstenen kanal için sayısal tanımlayıcı.

Örnekler

KTVU'ya geçme

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

Üçüncü kanala geçin.

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

Cihazda yeni kanal seçilirken hata oluştu.

Desteklenen değerler:

noAvailableChannel
noChannelSubscription
channelSwitchFailed

action.devices.commands.relativeChannel

Geçerli kanalı göreceli bir miktarda ayarlayın.

Parametreler

Parametreler Tür Açıklama
relativeChannelChange Tamsayı

Zorunludur.

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 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önerken bir hata oluştu.

Desteklenen değerler:

channelSwitchFailed

Cihaz HATALARI

Hata ve istisnaların tam listesini inceleyin.