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 isMuted doğru olur.

volumeDefaultPercentage Integer

(Varsayılan: 40)

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: 1)

"<device_name> cihazında sesi aç" 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ış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. >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, cihazın sesi kapalıysa yanlış değerini alır. isMuted doğruysa cihaz, hatırlanan nokta için currentVolume değerini yine döndürür.

Ö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.

0-volumeMaxLevel arası yeni cilt.

Ö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 seviyesindeyken VolumeUp komutunu alır.
  • volumeAlreadyMin: Cihaz, sesi en düşük seviyeye geldiğinde VolumeDown komutunu alır.