Akıllı Ev Ses Özelliği Şeması
action.devices.traits.Volume
: Bu özellik, ses düzeyini değiştirebilen (örneğin, sesi belirli bir düzeye ayarlama, sesi kapatma veya açma) cihazlara aittir.
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 edinmek için Amaç karşılama bölümüne bakın.
Özellikler | Tür | Açıklama |
---|---|---|
volumeMaxLevel |
Integer |
Zorunludur. Referans değerin 0 (sessiz) olduğu varsayılan maksimum ses seviyesi. Asistan, sesle ilgili komutları (ör. "televizyonun sesini biraz aç") uygun şekilde ayarlar. |
volumeCanMuteAndUnmute |
Boole |
Zorunludur. Cihazın, sesi kapatıp açamayacağını belirtir. "Sesi kapatma" davranışı, önceki ses düzeyini hatırlayıp sesi sıfıra indirerek sesi tekrar sağladığı için sesi kapatma ayrı bir seçenektir. Bu durum, ses durumuna yansıtılır. Ses düzeyi 5 ise ve kullanıcı sesi kapatırsa ses seviyesi 5 olarak kalır ve |
volumeDefaultPercentage |
Integer |
(Varsayılan: Kullanıcı veya üretici tarafından tanımlanan varsayılan hacmin ses düzeyi (yüzde cinsinden). Ölçek 0-100 arasında olmalıdır. |
levelStepSize |
Integer |
(Varsayılan: "<device_name> cihazında sesi aç" gibi göreli ses seviyesi sorguları için varsayılan adım boyutu. |
commandOnlyVolume |
Boole |
(Varsayılan: 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ış olur. İsteğin başarıyla yürütülüp yürütülmediğini onaylamak veya cihazın durumunu almak (örneğin, cihaz geleneksel bir kızılötesi uzaktan kumandaysa) mümkün değilse 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 varlıklar, QUERY
işleminin bir parçası olarak aşağıdaki durumları bildirebilir. QUERY
amaçlarını 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. Geçerli ses düzeyi yüzdesi. |
isMuted |
Boole |
|
Örnekler
Sesi kapatılabilen ve mevcut durumu bildiren hoparlör
{ "currentVolume": 5, "isMuted": false }
Cihaz COMMANDS
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 edinmek için Amaç karşılama bölümüne bakın.
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ün sesini kapat
{ "command": "action.devices.commands.mute", "params": { "mute": true } }
action.devices.commands.setVolume
Ses seviyesini volumeMaxLevel
temel alınarak istenen seviyeye ayarlayın.
Parametreler
Parametreler | Tür | Açıklama |
---|---|---|
volumeLevel |
Integer |
Zorunludur.
|
Örnekler
Hoparlörün mutlak ses seviyesini ayarlama
{ "command": "action.devices.commands.setVolume", "params": { "volumeLevel": 6 } }
action.devices.commands.volumeRelative
volumeMaxLevel
temel alınarak sesi artırma veya azaltma n adım belirleyin. Asistan, göreli ölçek kullanan komutlarda mevcut adımlara göre ölçeklendirme yapmak için n'yi seçer. Örneğin, Televizyonun sesini çok aç seçeneği, TV'nin sesini biraz aç ayarından daha yüksek adım sayısı belirler.
Parametreler
Parametreler | Tür | Açıklama |
---|---|---|
relativeSteps |
Integer |
Zorunludur. "azalt" için negatif. |
Örnekler
Yalnızca komut modunda hoparlör cihazının göreli ses seviyesini ayarlama
{ "command": "action.devices.commands.volumeRelative", "params": { "relativeSteps": -1 } }
Cihaz ERRORS
Hataların ve istisnaların tam listesine bakın.volumeAlreadyMax
: Cihaz zaten en yüksek ses seviyesindeykenVolumeUp
komutunu alır.volumeAlreadyMin
: Cihaz, sesi en düşük seviyeye geldiğindeVolumeDown
komutunu alır.