Skema FanSpeed Trait Smart Home

action.devices.traits.FanSpeed - Ciri ini dimiliki oleh perangkat yang mendukung penyetelan kecepatan kipas.

Kecepatan kipas (yaitu, meniupkan udara dari perangkat pada berbagai tingkat, yang mungkin merupakan bagian dari unit AC atau pemanas, atau di dalam mobil), dapat mencakup setelan seperti rendah, sedang, dan tinggi atau persentase.

ATRIBUT Perangkat

Perangkat dengan karakteristik ini dapat melaporkan atribut berikut sebagai bagian dari operasi SYNC. Untuk mempelajari lebih lanjut cara menangani intent SYNC, lihat Fulfillment intent.

Atribut Jenis Deskripsi
reversible Boolean

(Default: false)

Jika disetel ke benar (true), perangkat ini mendukung peniupan kipas ke kedua arah dan dapat menerima perintah untuk membalikkan arah kipas.
commandOnlyFanSpeed Boolean

(Default: false)

Menunjukkan apakah perangkat mendukung penggunaan komunikasi satu arah (benar) atau dua arah (salah). Setel atribut ini ke benar (true) jika perangkat tidak dapat merespons intent QUERY atau Report State untuk karakteristik ini.
Berisi salah satu item berikut:
0 Objek

Dukungan untuk setelan kecepatan.
availableFanSpeeds Objek

Wajib.

Setelan kecepatan yang didukung oleh perangkat.
speeds Array

Wajib.

Daftar setelan kecepatan.
[item, ...] Objek

Setelan kecepatan.
speed_name String

Wajib.

Nama internal setelan kecepatan. Hal ini dapat membuat pengalaman pengguna menjadi tidak ramah, dan akan dibagikan dalam semua bahasa.
speed_values Array

Wajib.

Sinonim untuk setelan kecepatan dalam setiap bahasa yang didukung.
[item, ...] Objek

Sinonim untuk setelan kecepatan dalam bahasa tertentu. Setidaknya satu item dengan nilai lang en diperlukan untuk menyediakan penggantian bahasa.
speed_synonym Array

Wajib.

Sinonim untuk setelan kecepatan, harus mencakup bentuk tunggal dan jamak, jika berlaku. Sinonim pertama dalam daftar akan dianggap sebagai nama kanonis setelan kecepatan.
[item, ...] String

Sinonim. Setidaknya satu item dengan nilai lang en diperlukan untuk menyediakan penggantian bahasa.
lang String

Wajib.

Kode bahasa (ISO 639-1). Lihat bahasa yang didukung.
ordered Boolean

Wajib.

Jika disetel ke benar (true), tata bahasa tambahan untuk logika peningkatan atau penurunan akan diterapkan, dalam urutan (peningkatan) array kecepatan.
1 Objek

Dukungan untuk persentase kecepatan.
supportsFanSpeedPercent Boolean

Wajib.

(Default: false)

Jika ditetapkan ke benar (true), perangkat ini akan menerima perintah untuk menyesuaikan kecepatan menggunakan persentase dari 0,0 hingga 100,0.

Contoh

Perangkat dengan dua setelan kecepatan, dukungan untuk arah terbalik, dan penyesuaian persentase.

{
  "availableFanSpeeds": {
    "speeds": [
      {
        "speed_name": "speed_low",
        "speed_values": [
          {
            "speed_synonym": [
              "Low",
              "Slow"
            ],
            "lang": "en"
          }
        ]
      },
      {
        "speed_name": "speed_high",
        "speed_values": [
          {
            "speed_synonym": [
              "High",
              "Fast"
            ],
            "lang": "en"
          }
        ]
      }
    ],
    "ordered": true
  },
  "reversible": true,
  "supportsFanSpeedPercent": true
}

STATUS Perangkat

Entitas dengan karakteristik ini dapat melaporkan status berikut sebagai bagian dari operasi QUERY. Untuk mempelajari lebih lanjut cara menangani intent QUERY, lihat Fulfillment intent.

Negara bagian Jenis Deskripsi
currentFanSpeedSetting String

Ini menunjukkan nama internal setelan kecepatan saat ini dari atribut availableFanSpeeds.
currentFanSpeedPercent Number

Menunjukkan kecepatan kipas saat ini berdasarkan persentase. Wajib jika atribut supportsFanSpeedPercent disetel ke true

Contoh

Berapa kecepatan kipas di ruang tamu?

{
  "currentFanSpeedSetting": "speed_low",
  "currentFanSpeedPercent": 10
}

PERINTAH perangkat

Perangkat dengan karakteristik ini dapat merespons perintah berikut sebagai bagian dari operasi EXECUTE. Untuk mempelajari lebih lanjut cara menangani intent EXECUTE, lihat Fulfillment intent.

action.devices.commands.SetFanSpeed

Setel kecepatan.

Parameter

Payload berisi salah satu hal berikut:

Menyetel kecepatan berdasarkan setelan.

Parameter Jenis Deskripsi
fanSpeed String

Wajib.

Setelan kecepatan kipas yang diminta.

Menyetel kecepatan berdasarkan persentase.

Parameter Jenis Deskripsi
fanSpeedPercent Number

Wajib.

Persentase setelan kecepatan yang diminta.

Contoh

Setel kipas ke tinggi.

{
  "command": "action.devices.commands.SetFanSpeed",
  "params": {
    "fanSpeed": "speed_high"
  }
}

Setel kipas ke 50%.

{
  "command": "action.devices.commands.SetFanSpeed",
  "params": {
    "fanSpeedPercent": 50
  }
}

action.devices.commands.SetFanSpeedRelative

Menyetel kecepatan relatif.

Perintah ini memerlukan atribut berikut: 
{
  "commandOnlyFanSpeed": true
}

Parameter

Payload berisi salah satu hal berikut:

Menetapkan kecepatan relatif berdasarkan berat.

Parameter Jenis Deskripsi
fanSpeedRelativeWeight Bilangan Bulat

Wajib.

Nilai ini menunjukkan jumlah relatif perubahan kecepatan. Nilai absolut menunjukkan jumlah yang diskalakan, sedangkan tanda numerik menunjukkan arah perubahan.

Menyetel kecepatan relatif berdasarkan persentase.

Parameter Jenis Deskripsi
fanSpeedRelativePercent Number

Wajib.

Nilai ini menunjukkan persentase kecepatan yang akan diubah.

Contoh

Turunkan sedikit kecepatan kipas.

{
  "command": "action.devices.commands.SetFanSpeedRelative",
  "params": {
    "fanSpeedRelativeWeight": -1
  }
}

Naikkan kecepatan kipas angin sebesar 10 persen.

{
  "command": "action.devices.commands.SetFanSpeedRelative",
  "params": {
    "fanSpeedRelativePercent": 10
  }
}

action.devices.commands.Reverse

Balik arah kipas.

Perintah ini memerlukan atribut berikut: 
{
  "reversible": true
}

Parameter

Parameter Jenis Deskripsi

Tidak ada properti

Contoh

Balikkan arah kipas.

{
  "command": "action.devices.commands.Reverse",
  "params": {}
}

Contoh ucapan

de-DE

  • stell die Geschwindigkeit vom Ventilator auf hoch

en-US

  • drop the AC fan speed to medium

es-ES

  • cambia la velocidad del ventilador a medio

fr-FR

  • mets la ventilation au maximum

hi-IN

  • बेडरूम में पंखे की गति मीडियम करें

it-IT

  • metti il condizionatore in salotto a velocità media

ja-JP

  • エアコン の風量を 高速 にセット

ko-KR

  • 선풍기 강풍 으로 틀어 줘

nl-NL

  • zet de snelheid van de ventilator op medium

pt-BR

  • definir a velocidade do ventilador para baixa
  • põe a ventoinha no máximo

sv-SE

  • Ställ in fläkten på medel

ERROR Perangkat

Lihat daftar lengkap error dan pengecualian.
  • maxSpeedReached: Perangkat sudah disetel ke kecepatan maksimum.
  • minSpeedReached: Perangkat sudah disetel ke kecepatan minimum.