Akıllı Ev Ses Düzeyi Özelliği Şeması

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

CİHAZ ÖZELLİKLERİ

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

Özellikler Tür Açıklama
volumeMaxLevel Tamsayı

Zorunludur.

0 (sessiz) taban çizgisi varsayılarak maksimum ses seviyesi. Asistan, niteleyici komutları (ör. "televizyonu biraz daha aç") buna göre ayarlar.
volumeCanMuteAndUnmute Boole

Zorunludur.

Cihazın sesi kapatıp açamayacağını belirtir. "Sessize alma" davranışı, önceki sesi hatırlarken sesi 0'a aldığı için sessize alma ayrı bir seçenektir. Bu nedenle, sesi açmak önceki sesi geri yükler. Bu durum ses durumuna yansıtılır. Ses seviyesi 5 ise ve kullanıcı sesi kapatırsa ses seviyesi 5 olarak kalır ve isMuted doğru olur.
volumeDefaultPercentage Tamsayı

(Varsayılan: 40)

Kullanıcı veya üretici tarafından tanımlanan varsayılan ses düzeyi (yüzde cinsinden). Ölçek 0-100 arasında olmalıdır.
levelStepSize Tamsayı

(Varsayılan: 1)

"<cihaz_adı> cihazında sesi artır" gibi göreli ses seviyesi sorguları için varsayılan adım boyutu.
commandOnlyVolume Boole

(Varsayılan: false)

Cihazın tek yönlü (doğru) veya iki yönlü (yanlış) iletişim kullanarak çalışıp çalışmadığını belirtir. Örneğin, denetleyici isteği gönderdikten sonra yeni cihaz durumunu onaylayabiliyorsa bu alan yanlış olur. İsteğin başarıyla yürütülüp yürütülmediğini onaylamak veya cihazın durumunu almak mümkün değilse (ör. cihaz geleneksel bir kızılötesi uzaktan kumandaysa) bu alanı doğru olarak ayarlayın.

Örnekler

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

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

Cihaz DURUMLARI

Bu özelliğe sahip öğeler, QUERY işlemi kapsamında aşağıdaki durumları bildirebilir. QUERY intent'lerini işleme hakkında daha fazla bilgi edinmek için Intent karşılama başlıklı makaleyi inceleyin.

Eyaletler Tür Açıklama
currentVolume Tamsayı

Zorunludur.

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

volumeCanMuteAndUnmute özelliği "true" olarak ayarlandıysa gereklidir. Cihazın sesi kapalıysa doğru, kapalı değilse yanlış değerini döndürür. isMuted doğruysa cihaz, hatırlanan nokta için yine currentVolume değerini döndürür.

Örnekler

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

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

Cihaz KOMUTLARI

Bu özelliğe sahip cihazlar, EXECUTE işlemi kapsamında aşağıdaki komutlara yanıt verebilir. EXECUTE intent'lerini işleme hakkında daha fazla bilgi edinmek için Intent karşılama başlıklı makaleyi inceleyin.

action.devices.commands.mute

Cihazı sessize alır veya sessize alma durumunu kaldırır.

Parametreler

Parametreler Tür Açıklama
mute Boole

Zorunludur.

Bir cihazın sesinin kapatılması veya açılması.

Örnekler

Hoparlör cihazının sesini kapatma

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

action.devices.commands.setVolume

Ses seviyesini volumeMaxLevel'e göre istenen seviyeye ayarlayın.

Parametreler

Parametreler Tür Açıklama
volumeLevel Tamsayı

Zorunludur.

Yeni ses seviyesi, 0 ile volumeMaxLevel arasında.

Örnekler

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

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

action.devices.commands.volumeRelative

volumeMaxLevel değerine göre sesi n adım artırın veya azaltın. Göreceli ölçek kullanan komutlar için Asistan, mevcut adımlara göre ölçeklendirme yapmak üzere n değerini uygun şekilde seçer. Örneğin, TV'yi çok daha yüksek sesli yap, TV'yi biraz daha yüksek sesli yap'tan daha fazla adım belirler.

Parametreler

Parametreler Tür Açıklama
relativeSteps Tamsayı

Zorunludur.

"Düşüş" için negatif.

Örnekler

Yalnızca komut modunda hoparlör cihazının göreceli ses seviyesini ayarlama

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

Cihaz HATALARI

Hataların ve istisnaların tam listesini inceleyin.
  • volumeAlreadyMax: Cihaz, ses seviyesi zaten en yüksekteyken VolumeUp komutunu alır.
  • volumeAlreadyMin: Cihaz, sesi zaten en düşük düzeydeyken VolumeDown komutunu alır.