Skema Trait Isi Smart Home

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

ATTRIBUTE Perangkat

Perangkat dengan ciri 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 khusus bahasa.

[item, ...] Objek

Nama level dan sinonim khusus bahasanya.

level_name String

Wajib.

Nama internal level. Bagian 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 level 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 penambahan atau penurunan, seperti yang diwakili oleh array levels (misalnya, setengah tingkat).

supportsFillPercent Boolean

(Default: false)

Jika true (benar), terima perintah untuk menyesuaikan level ke persentase.

Contoh

Perangkat dengan kemampuan pengisian atau pembuangan 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 status berikut sebagai bagian dari operasi QUERY. Untuk mempelajari penanganan intent QUERY lebih lanjut, lihat Fulfillment intent.

Status Type Deskripsi
isFilled Boolean

Wajib.

True jika perangkat diisi ke tingkat mana pun. Salah jika perangkat benar-benar habis.

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 COMMAND

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 kosongkan 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
  }
}

Keringkan bak mandi.

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

Isi bak mandi setengah.

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

Tingkatkan level pengisian bak mandi 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.