Skema Fitur Pengisian Smart Home

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

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
availableFillLevels Objek

Menjelaskan berbagai tingkat pengisian daya perangkat.
levels Array

Wajib.

Daftar nama level dan sinonim khusus bahasa.
[item, ...] Objek

Nama level dan sinonim spesifik per bahasanya.
level_name String

Wajib.

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

Wajib.

Sinonim tingkat dalam setiap bahasa yang didukung.
[item, ...] Objek

Sinonim tingkat dalam bahasa tertentu. Setidaknya satu item dengan nilai lang en diperlukan untuk menyediakan penggantian bahasa.
level_synonym Array

Wajib.

Sinonim tingkat. String pertama dalam daftar ini digunakan sebagai nama kanonis level dalam bahasa tersebut.
[item, ...] String

Nama 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 benar, perangkat menangani tata bahasa tambahan untuk logika peningkatan atau penurunan, seperti yang diwakili oleh array levels (misalnya, setengah tingkat).
supportsFillPercent Boolean

(Default: false)

Jika benar, terima perintah untuk menyesuaikan level ke persentase.

Contoh

Perangkat dengan kemampuan pengisian atau pengurasan dasar yang tidak mendukung tingkat pengisian diskrit.

{}

Perangkat yang mendukung level pengisian daya diskrit.

{
  "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 sifat 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
isFilled Boolean

Wajib.

Benar jika perangkat terisi daya hingga tingkat apa pun. Salah jika daya perangkat benar-benar habis.
currentFillLevel String

Wajib jika atribut availableFillLevels ditetapkan. Menunjukkan level_name saat ini dari atribut availableFillLevels saat perangkat diisi.
currentFillPercent Number

Wajib jika atribut supportsFillPercent ditetapkan. Menunjukkan persentase level pengisian saat ini.

Nilai harus antara 0 dan 100.

Contoh

Apakah bak mandi sudah terisi?

{
  "isFilled": true
}

Apakah bak mandi terisi? (dengan level).

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

PERINTAH perangkat

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

action.devices.commands.Fill

Isi atau alirkan perangkat.

Parameter

Parameter Jenis Deskripsi
fill Boolean

Wajib.

Benar untuk mengisi, salah 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.

Nilai harus antara 0 dan 100.

Contoh

Isi bak mandi.

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

Kuras bak mandi.

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

Isi bak mandi hingga separuh.

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

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

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

ERROR Perangkat

Lihat daftar lengkap error dan pengecualian.