Selamat datang di Pusat Developer Google Home, tujuan baru untuk mempelajari cara mengembangkan tindakan smart home. Catatan: Anda akan terus membuat tindakan di konsol Actions.
Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Skema Smart Fanit Trait Smart Home

action.devices.traits.FanSpeed - Sifat ini termasuk dalam perangkat yang mendukung penyetelan kecepatan kipas.

Kecepatan kipas (yaitu, mengembuskan udara dari perangkat ke berbagai tingkat, yang mungkin merupakan bagian dari AC atau unit 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 penanganan intent SYNC lebih lanjut, lihat Penjelasan intent.

Atribut Jenis Deskripsi
reversible Boolean

(Default: false)

Jika disetel ke benar (true), perangkat ini akan mendukung gerakan kipas angin di kedua arah dan dapat menerima perintah untuk membalik arah kipas.

commandOnlyFanSpeed Boolean

(Default: false)

Menunjukkan apakah perangkat mendukung penggunaan komunikasi satu arah (benar) atau dua arah (salah). Tetapkan atribut ini ke true jika perangkat tidak dapat merespons intent QUERY atau Status Laporan 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. Setelan ini dapat dibuat tidak mudah digunakan 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.

speed_synonym Array

Wajib.

Sinonim untuk setelan kecepatan harus mencakup bentuk tunggal dan jamak, jika ada. Sinonim pertama dalam daftar akan dianggap sebagai nama kanonis setelan kecepatan.

[item, ...] String

Sinonim.

lang String

Wajib.

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

ordered Boolean

Wajib.

Jika disetel ke benar, tata bahasa tambahan untuk meningkatkan atau menurunkan logika akan berlaku, dalam urutan (meningkatkan) array kecepatan.

1 Objek

Dukungan untuk persentase kecepatan.

supportsFanSpeedPercent Boolean

Wajib.

(Default: false)

Jika kebijakan disetel 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, mendukung penyesuaian arah dan persentase kebalikan.

{
  "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

Perangkat dengan karakteristik ini dapat melaporkan status berikut sebagai bagian dari operasi QUERY. Untuk mempelajari penanganan intent QUERY lebih lanjut, lihat Penjelasan intent.

Negara bagian Jenis Deskripsi
currentFanSpeedSetting String

Ini mewakili nama internal setelan kecepatan saat ini dari atribut availableFanSpeeds.

currentFanSpeedPercent Number

Menunjukkan kecepatan kipas saat ini menurut persentase. Wajib jika atribut supportsFanSpeedPercent ditetapkan ke true

Contoh

Berapa kecepatan kipas angin di ruang tamu?

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

PERMINTAAN Perangkat

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

action.devices.commands.SetFanSpeed

Setel kecepatan.

Parameter

Payload berisi salah satu dari berikut ini:

Setel kecepatan menurut setelan.

Parameter Jenis Deskripsi
fanSpeed String

Wajib.

Setelan kecepatan kipas yang diminta.

Setel 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 angin ke 50%.

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

action.devices.commands.SetFanSpeedRelative

Setel kecepatan relatif.

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

Parameter

Payload berisi salah satu dari berikut ini:

Tetapkan kecepatan relatif menurut berat.

Parameter Jenis Deskripsi
fanSpeedRelativeWeight Integer

Wajib.

Nilai ini menunjukkan jumlah relatif perubahan kecepatan. Nilai mutlak menunjukkan jumlah yang diskalakan sementara tanda numerik menunjukkan arah perubahan.

Tetapkan kecepatan relatif berdasarkan persentase.

Parameter Jenis Deskripsi
fanSpeedRelativePercent Number

Wajib.

Nilai ini mewakili persentase kecepatan yang berubah.

Contoh

Turunkan kecepatan kipas sedikit.

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

Naikkan kecepatan kipas 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 penggemar.

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

Contoh ucapan

de-DE

  • stell die Geschwindigkeit Ventilator vom auf hoch

en-US

  • penurunan AC kecepatan kipas ke sedang

es-ES

  • cambia la velocidad del ventilador a medio

fr-FR

  • memenuhi la ventilasi au maksimum

KESALAHAN perangkat

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