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

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

CİHAZ ÖZELLİKLERİ

Bu özelliğe sahip cihazlar, SYNC işlemi kapsamında aşağıdaki özellikleri bildirebilir. SYNC amaçlarının ele alınması hakkında daha fazla bilgi edinmek için Niyet karşılama bölümüne bakın.

Özellikler Tür Açıklama
volumeMaxLevel Tamsayı

Zorunludur.

0 (sessiz) taban çizgisi varsayılarak maksimum ses seviyesi. Asistan, niteleyici komutları (ör. "televizyonu biraz daha aç") buna göre ayarlar.
volumeCanMuteAndUnmute Boole

Zorunludur.

Cihazın sesi kapatıp açabilme durumunu belirtir. "Sessize alma" davranışı, önceki sesi hatırlarken sesi 0'a indirdiği için sessize alma ayrı bir seçenektir. Bu nedenle, sesi açmak önceki sesi geri yükler. Bu durum ses durumuna yansıtılır. Ses seviyesi 5 ise ve kullanıcı sesi kapatırsa ses seviyesi 5 olarak kalır ve isMuted doğru olur.
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)

"<cihaz_adı> cihazında sesi artır" 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ışıp çalışmadığını belirtir. Ö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 öğ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 varlıklar, QUERY işleminin bir parçası olarak aşağıdaki durumları bildirebilir. QUERY amaçlarının ele alınması hakkında daha fazla bilgi edinmek için Niyet karşılama bölümüne bakın.

Eyaletler Tür Açıklama
currentVolume Tamsayı

Zorunludur.

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

volumeCanMuteAndUnmute özelliği "true" olarak ayarlandıysa gereklidir. Cihazın sesi kapalıysa doğru, aksi takdirde yanlış değerini alır. isMuted doğruysa cihaz, hatırlanan nokta için yine currentVolume değerini döndürür.

Örnekler

Sesi kapatılabilen ve mevcut durumu bildiren hoparlör

{
  "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ın ele alınması hakkında daha fazla bilgi edinmek için Niyet 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 cihazının sesini kapatma

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

action.devices.commands.setVolume

Ses seviyesini volumeMaxLevel'e göre istenen seviyeye ayarlayın.

Parametreler

Parametreler Tür Açıklama
volumeLevel Tamsayı

Zorunludur.

Yeni ses seviyesi, 0 ile volumeMaxLevel arasında.

Örnekler

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

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

action.devices.commands.volumeRelative

volumeMaxLevel değerine 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çeklendirme yapmak üzere n değerini uygun şekilde seçer. Örneğin, TV'yi çok daha yüksek sesli yap, TV'yi biraz daha yüksek sesli yap'tan daha fazla adım belirler.

Parametreler

Parametreler Tür Açıklama
relativeSteps Tamsayı

Zorunludur.

"Düşüş" için negatif.

Örnekler

Yalnızca komut modunda hoparlör cihazının göreceli ses seviyesini ayarlama

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

Cihaz ERRORS

Hataların ve istisnaların tam listesini inceleyin.
  • volumeAlreadyMax: Cihaz, ses seviyesi zaten en yüksek seviyedeyken VolumeUp komutunu alır.
  • volumeAlreadyMin: Cihaz, sesi zaten en düşük düzeydeyken VolumeDown komutunu alır.