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 ATTRIBUTES

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

Özellikler	Type	Açıklama
volumeMaxLevel	Integer	Zorunludur. Başlangıç değeri 0 (sessiz) olduğu belirlenen maksimum ses düzeyi. Asistan, zıt komutları (ör. "tv'yi biraz daha yüksek sesle") buna göre ayarlar.
volumeCanMuteAndUnmute	Boole	Zorunludur. Cihazın sesi kapatıp kapatmayacağını belirtir. Sesi kapatma, önceki sesi hatırlarken ses düzeyini 0'a aldığından, sesi kapatma özelliği geri yüklendiğinden ayrı bir seçenektir. Bu, ses düzeyiyle gösterilir. Ses düzeyi 5 ise ve kullanıcı sesi kapatırsa ses düzeyi 5 olarak kalır ve isMuted doğrudur.
volumeDefaultPercentage	Integer	(Varsayılan: 40) Kullanıcı veya üretici tarafından tanımlanan varsayılan hacim için hacim (yüzde). Ölçek 0-100 arasında olmalıdır.
levelStepSize	Integer	(Varsayılan: 1) Göreceli hacim sorguları için varsayılan adım boyutu. "Sesi <cihaz_adı> düzeyinde artır" gibi.
commandOnlyVolume	Boole	(Varsayılan: false) Cihazın tek yönlü (true) veya iki yönlü (false) iletişim kullanarak mı çalıştığını belirtir. Ö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 olarak ayarlayın.

Örnekler

Sesi kapatılabilen ve geçerli durumu raporlayabilen hoparlör cihazı

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

Cihaz STATUS

Bu özelliğe sahip varlıklar, QUERY işlemi kapsamında aşağıdaki durumları bildirebilir. QUERY amaçlarını işleme hakkında daha fazla bilgi için Amaç karşılama bölümüne bakın.

Eyaletler	Type	Açıklama
currentVolume	Integer	Zorunludur. Mevcut ses 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, aksi takdirde yanlış değerini alır. isMuted doğruysa cihaz, hatırlanılan nokta için currentVolume değerini döndürür.

Örnekler

Sesi kapatılabilen ve geçerli durumu raporlayabilen hoparlör cihazı

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

Cihaz Komisyonları

Bu özelliğe sahip cihazlar, EXECUTE işleminin bir parçası olarak aşağıdaki komutlara yanıt verebilir. EXECUTE amaçlarını işleme hakkında daha fazla bilgi 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	Type	Açıklama
mute	Boole	Zorunludur. Cihazın sesini kapatma veya açma.

Örnekler

Hoparlörü kapatma

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

action.devices.commands.setVolume

volumeMaxLevel değerini temel alarak ses düzeyini istenen seviyeye ayarlayın.

Parametreler

Parametreler	Type	Açıklama
volumeLevel	Integer	Zorunludur. 0-volumeMaxLevel arasında 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 ses düzeyini ayarlayarak n ses düzeyini artırın veya azaltın. Göreli ölçek kullanan komutlar için Asistan, kullanılabilir adımlara göre ölçeklendirmek üzere uygun şekilde n seçer. Örneğin, TV'yi çok daha yüksek seste ayarlama, TV'yi biraz daha yüksek sesle ayarından daha yüksek sayıda adıma ayarlar.

Parametreler

Parametreler	Type	Açıklama
relativeSteps	Integer	Zorunludur. "azaltma" için negatif.

Örnekler

Yalnızca sesli komut modunda hoparlör cihazının göreli ses düzeyini 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 düzeyinde VolumeUp komutu alır.
• volumeAlreadyMin: Cihaz, zaten en düşük ses düzeyinde VolumeDown komutu alır.