Skema Atribut Pengisian Smart Home

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

ATRIBUT Perangkat

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

Atribut	Type	Deskripsi
availableFillLevels	Objek	Menjelaskan berbagai tingkat pengisian perangkat.
levels	Array	Wajib. Daftar nama level dan sinonim bahasa tertentu.
[item, ...]	Objek	Nama level dan sinonim spesifik bahasanya.
level_name	String	Wajib. Nama internal level. Profil ini tidak mudah digunakan dan akan dibagikan di 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 true (benar), perangkat akan menangani tata bahasa tambahan untuk meningkatkan atau menurunkan logika, seperti yang diwakili oleh array levels (misalnya, setengah level).
supportsFillPercent	Boolean	(Default: false) Jika true (benar), terima perintah untuk menyesuaikan level ke persentase.

Contoh

Perangkat dengan kemampuan pengisian atau pengurangan dasar yang tidak mendukung tingkat pengisian diskret.

{}

Perangkat yang mendukung tingkat pengisian diskret.

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

STATE Perangkat

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

Negara bagian	Type	Deskripsi
isFilled	Boolean	Wajib. True jika perangkat diisi ke tingkat apa pun. False jika perangkat benar-benar terkuras habis.
currentFillLevel	String	Wajib jika atribut availableFillLevels ditetapkan. Menunjukkan level_name saat ini dari atribut availableFillLevels yang diisi perangkat.
currentFillPercent	Number	Wajib jika atribut supportsFillPercent ditetapkan. Menunjukkan persentase tingkat pengisian saat ini.

Contoh

Apakah bak mandi terisi?

{
  "isFilled": true
}

Apakah bak mandi terisi? (dengan level).

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

PERMINTAAN Perangkat

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

action.devices.commands.Fill

Isi atau buang perangkat.

Parameter

Parameter	Type	Deskripsi
fill	Boolean	Wajib. Benar untuk diisi, salah untuk dikosongkan.
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
  }
}

Kosongkan bak mandi.

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

Isi bak mandi sampai separuh.

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

Tingkatkan level pengisian bak mandi sebesar satu (perlu atribut ordered menjadi true).

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

ERRORS perangkat

Lihat daftar lengkap error dan pengecualian.