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 Ses Seviyesi Şeması

action.devices.traits.Volume: Bu özellik, ses düzeyini değiştirebilen cihazlara aittir (ör. ses düzeyini belirli bir seviyeye ayarlama, sesi kapatma veya sesi açma).

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
volumeMaxLevel Integer

Zorunludur.

Referansın 0 (sesi kapalı) olduğu varsayılarak maksimum ses düzeyi. Asistan, uygun komutları (ör. "televizyonu biraz daha gürültülü yap") ayarlar.

volumeCanMuteAndUnmute Boole

Zorunludur.

Cihazın sesi kapatıp kapatamayacağını belirtir. "Sesi kapatma" davranışı, önceki sese hatırlanırken ses düzeyini 0'a çıkardığından, sesi açma özelliği geri yüklenmesi için ayrı bir seçenektir. Bu, ses durumuna yansıtılır. Ses düzeyi 5 ise ve kullanıcının sesi kapalıysa ses düzeyi 5 ve isMuted doğrudur.

volumeDefaultPercentage Integer

(Varsayılan: 40)

Kullanıcı veya üretici tarafından tanımlanan varsayılan birimin hacmi (yüzde olarak). Ölçek 0-100 olmalıdır.

levelStepSize Integer

(Varsayılan: 1)

"<cihaz_adı> cihazının sesini yükseltme" gibi göreli hacim sorguları için varsayılan adım boyutu.

commandOnlyVolume Boole

(Varsayılan: false)

Cihazın tek yönlü (doğru) mu yoksa iki yönlü (yanlış) iletişim mi kullandığını gösterir. Örneğin, kumanda isteği gönderdikten sonra yeni cihaz durumunu onaylayabilirse bu alan yanlış olur. İsteğin başarıyla yürütüldüğünü doğrulamak veya cihazın durumunu almak mümkün değilse (örneğin, cihaz geleneksel bir kızılötesi uzaktan kumandaysa) bu alanı doğru değerine ayarlayın.

Örnekler

Sesi kapatılabilen ve mevcut durumu raporlayabilen hoparlör cihazı

{
  "volumeMaxLevel": 11,
  "volumeCanMuteAndUnmute": true,
  "levelStepSize": 2,
  "commandOnlyVolume": false,
  "volumeDefaultPercentage": 6
}

Cihaz durumu

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

Eyaletler Tür Açıklama
currentVolume Integer

Zorunludur.

Mevcut ses seviyesi yüzdesi. >0 ile volumeMaxLevel arasında olmalıdır.

isMuted Boole

volumeCanMuteAndUnmute özelliği doğru değerine ayarlanırsa zorunludur. Cihazın sesi kapalıysa doğru, aksi takdirde yanlış değerini alır. isMuted doğruysa cihaz, hatırlanan nokta için currentVolume değerini yine döndürür.

Örnekler

Sesi kapatılabilen ve mevcut durumu raporlayabilen hoparlör cihazı

{
  "currentVolume": 5,
  "isMuted": false
}

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.mute

Cihazın sesini açar veya kapatır.

Parametreler

Parametreler Tür Açıklama
mute Boole

Zorunludur.

Bir cihazın sesini kapatma veya açma.

Örnekler

Hoparlörün sesini kapatma

{
  "command": "action.devices.commands.mute",
  "params": {
    "mute": true
  }
}

action.devices.commands.setVolume

volumeMaxLevel temel alınarak ses düzeyini istenen düzeye ayarlayın.

Parametreler

Parametreler Tür Açıklama
volumeLevel Integer

Zorunludur.

0 ile volumeMaxLevel arasındaki yeni cilt.

Örnekler

Hoparlör cihazının mutlak ses düzeyini ayarlama

{
  "command": "action.devices.commands.setVolume",
  "params": {
    "volumeLevel": 6
  }
}

action.devices.commands.volumeRelative

volumeMaxLevel göre, sesi artırma veya azaltma n adımlarını ayarlayın. Göreli ölçek kullanan komutlar için Asistan, kullanılabilir adımlara göre ölçeklendirmek üzere uygun şekilde n'yi seçer. Örneğin, TV'yi çok daha yüksek hale getirin ayarı, TV'yi biraz daha gürültülü hale getirme işleminden daha yüksek adımlara ayarlanır.

Parametreler

Parametreler Tür Açıklama
relativeSteps Integer

Zorunludur.

"azaltma" negatifi.

Örnekler

Hoparlör cihazının göreli ses düzeyini yalnızca komut modunda ayarlama

{
  "command": "action.devices.commands.volumeRelative",
  "params": {
    "relativeSteps": -1
  }
}

Cihaz HATALARI

Hataların ve istisnaların tam listesini inceleyin.
  • volumeAlreadyMax: Cihaz zaten en yüksek ses seviyesindeyken VolumeUp komutu alır.
  • volumeAlreadyMin: Cihaz zaten en düşük ses seviyesindeyken VolumeDown komutu alır.