Akıllı ev işlemlerinin nasıl geliştirileceğini öğrenmek için yeni adres olan Google Home Geliştirici Merkezi'ne hoş geldiniz. Not: Actions Console'da işlem oluşturmaya devam edersiniz.
Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Akıllı Ev Kanalı Kanal Şeması

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

Kullanılabilir kanallar, SYNC 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 ya da popüler kanallardan oluşmalıdır. Sorgu gecikmesini düşük tutmak için kanal listesini küçük tutmanızı (30 veya daha az kanal) öneririz.

Cihaz ÖZELLİKLERİ

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

Özellikler Tür Açıklama
availableChannels Dizi

Zorunludur.

Bu cihaz için kullanılabilen 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ü (true) veya iki yönlü (false) iletişimin kullanılmasını destekleyip desteklemediğini belirtir. Cihaz, bu özellik için bir QUERY amacına veya rapor durumuna yanıt vermiyorsa 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 durumu

Yok.

Cihaz FTC'leri

Bu özelliğe sahip cihazlar, EXECUTE işleminin bir parçası olarak aşağıdaki komutlara yanıt verebilir. EXECUTE niyetlerini işleme hakkında daha fazla bilgi edinmek 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 Tür Açıklama
channelCode Dize

Zorunludur.

İstenen kanal için availableChannels ile eşleşen benzersiz tanımlayıcı.

channelName Dize

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

channelNumber Dize

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

Numaraya göre kanal seçin

Parametreler Tür 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ç.

{
  "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

Mevcut kanalı göreli bir sayıya ayarlayın.

Parametreler

Parametreler Tür Açıklama
relativeChannelChange Integer

Zorunludur.

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

Parametreler

Parametreler Tür 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.