Akıllı ev işlemlerinin nasıl geliştirileceğini öğrenebileceğiniz yeni adres olan Google Home Geliştirici Merkezi'ne hoş geldiniz. Not: Actions Console'da işlem derlemeye devam edersiniz.

Akıllı Ev Kanalı Özellik Şeması

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

Kullanılabilir kanallar, SYNC özelliği sırasında availableChannels özelliği aracılığıyla 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 veya popüler kanallardan oluşmalıdır. Düşük sorgu gecikmesi için kanal listesini küçük (30 veya daha az kanal) tutmanızı öneririz.

Cihaz ATTRIBUTES

Bu özelliğe sahip cihazlar, SYNC işleminin bir parçası olarak aşağıdaki özellikleri bildirebilir. SYNC amaçlarını işleme hakkında daha fazla bilgi için Amaç karşılama bölümüne bakın.

Özellikler Type Açıklama
availableChannels Dizi

Zorunludur.

Bu cihaz için kullanılabilir medya kanallarını açıklayan nesnelerin listesi. Her öğe, kullanıcının bu cihazda seçebileceği bir kanalı tanımlar.

[item, ...] Nesne

Kullanılabilir medya kanalı.

key Dize

Zorunludur.

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

names Dizi

Zorunludur.

Bu kanaldaki kullanıcıların görebileceği adların listesi.

[item, ...] Dize

Kanal adı.

number Dize

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, bu özellik için bir QUERY amacına veya Rapor Durumuna yanıt veremezse bu özelliği doğru olarak ayarlayın.

Örnekler

Cihaz iki kanalı destekliyor.

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

Cihaz STATUS

Yok.

Cihaz Komisyonları

Bu özelliğe sahip cihazlar, EXECUTE işleminin bir parçası olarak aşağıdaki komutlara yanıt verebilir. EXECUTE amaçlarını işleme hakkında daha fazla bilgi için Amaç karşılama bölümüne bakın.

action.devices.commands.selectChannel

Mevcut kanalı belirli bir değere ayarlayın.

Parametreler

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

Kimliğe göre kanal seçin

Parametreler Type Açıklama
channelCode Dize

Zorunludur.

İstenen kanalın availableChannels tanımlayıcısından biriyle eşleşen benzersiz tanımlayıcısı.

channelName Dize

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

channelNumber Dize

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

Kanala göre kanal seçin

Parametreler Type Açıklama
channelNumber Dize

Zorunludur.

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

Örnekler

KTVU'ya geç

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

Üçüncü kanala geçin.

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

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

Desteklenen değerler:

noAvailableChannel
noChannelSubscription
channelSwitchFailed

action.devices.commands.relativeChannel

Geçerli kanalı göreli bir tutara göre düzenleyin.

Parametreler

Parametreler Type Açıklama
relativeChannelChange Integer

Zorunludur.

Artan veya azalan kanal sayısı.

Örnekler

Sonraki kanala geç

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

Önceki kanala geç

{
  "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önün.

Parametreler

Parametreler Type Açıklama

Özellik yok

Örnekler

Son kanala dön

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

Cihazın son kanalına dönerken hata oluştu.

Desteklenen değerler:

channelSwitchFailed

Cihaz HATALARI

Hataların ve istisnaların tam listesini inceleyin.