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

action.devices.traits.Volume - Bu özellik, ses seviyesini değiştirebilen (ör. sesi belirli bir düzeye ayarlama, sessize alma veya sessizden çıkarma) cihazlara aittir.

Cihaz ÖZELLİKLERİ

Bu özelliğe sahip cihazlar, SYNC işlemi kapsamında aşağıdaki özellikleri bildirebilir. SYNC amaçlarını ele alma hakkında daha fazla bilgi edinmek için Amacı karşılama başlıklı makaleyi inceleyin.

Özellikler Tür Açıklama
volumeMaxLevel Integer

Zorunlu.

Temel ses seviyesinin 0 (sessiz) olduğu varsayıldığında maksimum ses seviyesi. Asistan, zarf komutlarını (ör. "TV'nin sesini biraz yükselt") buna göre ayarlar.
volumeCanMuteAndUnmute Boole

Zorunlu.

Cihazın sesi kapatıp açabildiğini gösterir. Sesi kapatma, ayrı bir seçenektir. Sesi kapatma işlemi, önceki ses düzeyini hatırlayarak ses düzeyini 0'a indirir. Bu nedenle, sesi açma işlemiyle önceki ses düzeyi geri yüklenir. Bu durum, ses durumuyla yansıtılır. Ses düzeyi 5 ise ve kullanıcı sesi kapatırsa ses düzeyi 5 olarak kalır ve isMuted doğru olur.
volumeDefaultPercentage Integer

(Varsayılan: 40)

Kullanıcı veya üretici tarafından tanımlanan varsayılan sesin yüzdesi. Ölçek 0-100 arasında olmalıdır.

Değer 0 ile 100 arasında olmalıdır.
levelStepSize Integer

(Varsayılan: 1)

"Sesini aç <device_name>" gibi göreli ses sorgularının 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ı gösterir. Ö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 amaçlarını ele alma hakkında daha fazla bilgi edinmek için Amacı karşılama başlıklı makaleyi inceleyin.

Eyaletler Tür Açıklama
currentVolume Integer

Zorunlu.

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

Minimum değer: 0.
isMuted Boole

volumeCanMuteAndUnmute özniteliği doğru olarak ayarlanmışsa gereklidir. Cihazın sesi kapatılmışsa doğru, aksi takdirde yanlış. isMuted doğruysa cihaz, hatırlanan nokta için currentVolume değerini döndürmeye devam eder.

Ö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 amaçlarını ele alma hakkında daha fazla bilgi edinmek için Amacı karşılama başlıklı makaleyi inceleyin.

action.devices.commands.mute

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

Parametreler

Parametreler Tür Açıklama
mute Boole

Zorunlu.

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 seviyesini volumeMaxLevel temel alınarak istenen düzeye ayarlayın.

Parametreler

Parametreler Tür Açıklama
volumeLevel Integer

Zorunlu.

Yeni birim, 0 ile volumeMaxLevel arasında.

Minimum değer: 0.

Örnekler

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

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

action.devices.commands.volumeRelative

volumeMaxLevel'a 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çeklendirmek üzere n değerini uygun şekilde seçer. Örneğin, TV'nin sesini çok yükselt, TV'nin sesini biraz yükselt komutundan daha fazla adım ayarlar.

Parametreler

Parametreler Tür Açıklama
relativeSteps Integer

Zorunlu.

"Azalt" için negatif.

Örnekler

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

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

Cihaz HATALARI

Hatalar ve istisnalar listesinin tamamını inceleyin.
  • volumeAlreadyMax: Cihaz zaten en yüksek ses seviyesindeyken VolumeUp komutunu alıyor.
  • volumeAlreadyMin: Cihaz zaten en düşük ses düzeyindeyken VolumeDown komutunu alıyor.