Skema Isian Smart Home

action.devices.traits.Fill - Fitur ini berlaku untuk perangkat yang mendukung pengisian, seperti bak mandi.

ATTRIBUTES Perangkat

Perangkat dengan karakteristik ini mungkin melaporkan hal berikut sebagai bagian dari operasi SYNC. Untuk mempelajari selengkapnya tentang menangani intent SYNC, lihat Pemenuhan intent.

Atribut	Jenis	Deskripsi
availableFillLevels	Objek	Menjelaskan berbagai tingkat pengisian perangkat.
levels	Array	Wajib. Daftar nama level dan sinonim bahasa tertentu.
[item, ...]	Objek	Nama level dan sinonim bahasa tertentu.
level_name	String	Wajib. Nama internal level. URL ini mungkin tidak mudah digunakan dan akan dibagikan dalam semua bahasa.
level_values	Array	Wajib. Sinonim level dalam setiap bahasa yang didukung.
[item, ...]	Objek	Sinonim tingkat dalam bahasa tertentu.
level_synonym	Array	Wajib. Sinonim tingkat. String pertama dalam daftar ini digunakan sebagai nama kanonis level dalam bahasa tersebut.
[item, ...]	String	Nama sinonim.
lang	String	Wajib. Kode bahasa (ISO 639-1). Lihat bahasa yang didukung.
ordered	Boolean	Wajib. Jika benar, perangkat akan menangani tata bahasa tambahan untuk logika peningkatan atau penurunan, seperti yang ditunjukkan oleh array levels (misalnya, setengah level).
supportsFillPercent	Boolean	(Default: false) Jika true (benar), terima perintah untuk menyesuaikan tingkat ke persentase.

Contoh

Perangkat dengan kemampuan pengisian atau pengosongan dasar yang tidak mendukung tingkat pengisian terpisah.

{}

Perangkat yang mendukung tingkat pengisian terpisah.

{
  "availableFillLevels": {
    "levels": [
      {
        "level_name": "half_level",
        "level_values": [
          {
            "level_synonym": [
              "Half",
              "Half way",
              "One half"
            ],
            "lang": "en"
          }
        ]
      },
      {
        "level_name": "full_level",
        "level_values": [
          {
            "level_synonym": [
              "Full",
              "All the way",
              "Complete"
            ],
            "lang": "en"
          }
        ]
      }
    ],
    "ordered": true
  }
}

STATUS Perangkat

Entitas dengan karakteristik ini dapat melaporkan hal berikut status sebagai bagian dari operasi QUERY. Untuk mempelajari selengkapnya tentang menangani intent QUERY, lihat Pemenuhan intent.

Negara bagian	Jenis	Deskripsi
isFilled	Boolean	Wajib. True jika perangkat diisi ke level apa pun. Salah jika perangkat telah habis sepenuhnya.
currentFillLevel	String	Wajib jika atribut availableFillLevels ditetapkan. Menunjukkan level_name saat ini dari atribut availableFillLevels tempat perangkat diisi.
currentFillPercent	Number	Wajib jika atribut supportsFillPercent ditetapkan. Menunjukkan persentase tingkat pengisian saat ini.

Contoh

Apakah bak mandi sudah terisi?

{
  "isFilled": true
}

Apakah bak mandi sudah terisi? (dengan level).

{
  "isFilled": true,
  "currentFillLevel": "half_level"
}

Perangkat COMMANDS

Perangkat dengan karakteristik ini dapat merespons hal berikut sebagai bagian dari operasi EXECUTE. Untuk mempelajari selengkapnya tentang menangani intent EXECUTE, lihat Pemenuhan intent.

action.devices.commands.Fill

Isi atau habiskan perangkat.

Parameter

Parameter	Jenis	Deskripsi
fill	Boolean	Wajib. True untuk diisi, false untuk menguras.
fillLevel	String	Menunjukkan level_name dari atribut availableFillLevels yang akan ditetapkan. Jika tidak ditentukan, isi ke tingkat default.
fillPercent	Number	Menunjukkan persentase level yang diminta.

Contoh

Isi bak mandi.

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

Keringkan bak mandi.

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": false
  }
}

Isi bak mandi hingga setengah.

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true,
    "fillLevel": "half_level"
  }
}

Tingkatkan level pengisian bak mandi sebanyak satu (memerlukan atribut ordered menjadi true).

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true,
    "fillLevel": "full_level"
  }
}

Perangkat ERRORS

Lihat daftar lengkap error dan pengecualian.