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

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

Cihaz ATTRIBUTES

Bu özelliğe sahip cihazlar aşağıdakileri bildirebilir özellikleri SYNC işleminin bir parçası olarak kullanılabilir. Öğrenmek için SYNC amacını işleme hakkında daha fazla bilgi edinin. Niyet karşılama.

Özellikler	Tür	Açıklama
volumeMaxLevel	Tamsayı	Zorunludur. Referans değerinin 0 (sessiz) olduğu varsayılarak maksimum ses düzeyi. Asistan, ikili komutları buna göre ayarlar (ör. "tv'nin sesini biraz yükselt").
volumeCanMuteAndUnmute	Boole	Zorunludur. Cihazın sesi kapatıp açamayacağını belirtir. Sesi kapatma "sesi" ayarından ayrı bir seçenektir davranışı, önceki ses düzeyini hatırlarken ses seviyesini 0'a getirir. Böylece, sesi açma özelliği geri yüklenir. Bu değer, ses düzeyi olarak gösterilir. Ses düzeyi 5 ise ve kullanıcı sesi kapatırsa ses 5 olarak kalır ve isMuted doğru değerini alır.
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) "<device_name> cihazında sesi artırma" gibi göreli hacim 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ıştığını belirtir. Örneğin, kumanda, isteği gönderdikten sonra yeni cihaz durumunu onaylayabiliyorsa bu alan yanlış değerini alır. İsteğin başarıyla yürütülüp yürütülmediğini onaylamak veya cihazın durumunu öğrenmek mümkün değilse (örneğin, cihaz geleneksel bir kızılötesi uzaktan kumandaysa) bu alanı true olarak ayarlayın.

Örnekler

Sesi kapatılabilen ve mevcut durumu bildiren hoparlör

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

Cihaz STATES

Bu özelliğe sahip tüzel kişiler aşağıdaki durumları bildirebilir QUERY işleminin bir parçası olarak gösterilir. Öğrenmek için QUERY amacını işleme hakkında daha fazla bilgi edinin. Niyet karşılama.

Eyaletler	Tür	Açıklama
currentVolume	Tamsayı	Zorunludur. Mevcut ses düzeyi yüzdesi. >0 ile volumeMaxLevel arasında olmalıdır.
isMuted	Boole	volumeCanMuteAndUnmute özelliği doğru değerine ayarlanırsa gereklidir. Cihazın sesi kapalıysa doğru değerini döndürür; false (yanlış) değerini alır. isMuted Doğru ise cihaz, hatırlanan nokta için currentVolume değerini döndürmeye devam eder.

Örnekler

Sesi kapatılabilen ve mevcut durumu bildiren hoparlör

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

Cihaz COMMANDS

Bu özelliğe sahip cihazlar aşağıdakilere yanıt verebilir komutlarını EXECUTE işleminin bir parçası olarak kullanabilirsiniz. Öğrenmek için EXECUTE amacını işleme hakkında daha fazla bilgi edinin. Niyet karşılama.

action.devices.commands.mute

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

Parametreler

Parametreler	Tür	Açıklama
mute	Boole	Zorunludur. Cihazın sesini kapatma veya açma.

Örnekler

Hoparlör cihazının sesini kapatma

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

action.devices.commands.setVolume

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

Parametreler

Parametreler	Tür	Açıklama
volumeLevel	Tamsayı	Zorunludur. Yeni cilt, 0 yerine volumeMaxLevel.

Örnekler

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

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

action.devices.commands.volumeRelative

volumeMaxLevel öğesine göre sesi artırma veya azaltma n adımlarını ayarlayın. Asistan, göreli ölçek kullanan komutlar için n değerini uygun adımlara göre ölçeklendirmek üzere seçer. Örneğin, TV'yi biraz aç, TV'yi biraz aç seçeneğinden daha yüksek bir adım sayısı ayarlar.

Parametreler

Parametreler	Tür	Açıklama
relativeSteps	Tamsayı	Zorunludur. "azalt" için negatif anahtar kelimeler kullanın.

Örnekler

Yalnızca komut modunda hoparlör cihazının göreli ses düzeyini ayarlama

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

Cihaz ERRORS

Tam listeye göz atın: hataları ve istisnaları ortadan kaldırın.

• volumeAlreadyMax: Cihaz, şu durumda VolumeUp komutu alır: ses zaten en yüksek seviyede.
• volumeAlreadyMin: Cihaz, şu durumda VolumeDown komutu alır: zaten en düşük ses seviyesinde