Skema Trait EnergyStorage Smart Home

action.devices.traits.EnergyStorage - Sifat ini milik perangkat yang dapat menyimpan energi dalam baterai dan berpotensi mengisi ulang, atau perangkat yang dapat mengisi daya perangkat lain.

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
queryOnlyEnergyStorage	Boolean	Wajib. Benar jika perangkat ini hanya mendukung kueri tentang level energi yang tersimpan dan, secara opsional, status pengisian daya aktif (bergantung pada atribut isRechargeable), tetapi tidak mendukung awal dan penghentian pengisian daya.
energyStorageDistanceUnitForUX	String	(Default: "KILOMETERS") Akan digunakan sebagai respons terhadap pengguna. Nilai yang didukung: KILOMETERS MILES
isRechargeable	Boolean	(Default: false) Setel ke true jika perangkat ini dapat diisi ulang. Hal ini menunjukkan bahwa perangkat dapat melaporkan status capacityUntilFull, isCharging, dan secara opsional isPluggedIn, serta dapat menerima perintah Charge.

Contoh

Perangkat yang dapat diisi ulang

{
  "isRechargeable": true,
  "queryOnlyEnergyStorage": false
}

Perangkat yang dapat diisi ulang yang menampilkan tingkat pengisian daya saat ini dalam mil

{
  "isRechargeable": true,
  "energyStorageDistanceUnitForUX": "MILES",
  "queryOnlyEnergyStorage": false
}

Perangkat yang tidak dapat diisi ulang yang hanya mendukung pelaporan tingkat tagihan saat ini

{
  "isRechargeable": false,
  "queryOnlyEnergyStorage": 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
descriptiveCapacityRemaining	String	Wajib. Deskripsi kualitatif tingkat kapasitas energi. Perhatikan bahwa ini digunakan saat tidak ada data kapasitas numerik. Jika data kapasitas numerik juga tersedia, data akan lebih disukai daripada deskriptif jika memungkinkan. Nilai yang didukung: CRITICALLY_LOW LOW MEDIUM HIGH FULL
capacityRemaining	Array	Array pasangan unit/nilai yang menyimpan informasi tentang kapasitas energi yang dimiliki perangkat saat ini. Misalnya: Berapa mil jarak yang ditempuh <device> saya saat ini atau Berapa persentase pengisian daya yang dimiliki <device> saya memiliki
[item, ...]	Objek	Kapasitas yang tersisa dalam pasangan nilai dan unit.
rawValue	Bilangan Bulat	Wajib. Nilai kapasitas.
unit	String	Wajib. Unit kapasitas. Nilai yang didukung: SECONDS MILES KILOMETERS PERCENTAGE KILOWATT_HOURS
capacityUntilFull	Array	Array pasangan unit/nilai yang menyimpan informasi tentang kapasitas hingga perangkat terisi daya penuh. Misalnya: Berapa lama waktu hingga <device> terisi penuh.
[item, ...]	Objek	Kapasitas sampai diisi daya.
rawValue	Bilangan Bulat	Wajib. Nilai kapasitas.
unit	String	Wajib. Unit kapasitas. Nilai yang didukung: SECONDS MILES KILOMETERS PERCENTAGE KILOWATT_HOURS
isCharging	Boolean	Apakah perangkat saat ini sedang mengisi daya.
isPluggedIn	Boolean	Apakah perangkat saat ini dicolokkan. Perangkat dapat dicolokkan, tetapi tidak mengisi daya secara aktif.

Contoh

Perangkat yang dapat diisi ulang

{
  "descriptiveCapacityRemaining": "HIGH",
  "capacityRemaining": [
    {
      "rawValue": 36000,
      "unit": "SECONDS"
    },
    {
      "rawValue": 90,
      "unit": "PERCENTAGE"
    }
  ],
  "capacityUntilFull": [
    {
      "rawValue": 120,
      "unit": "SECONDS"
    }
  ],
  "isCharging": true,
  "isPluggedIn": true
}

Perangkat yang dapat diisi ulang yang menampilkan tingkat pengisian daya saat ini dalam mil

{
  "descriptiveCapacityRemaining": "CRITICALLY_LOW",
  "capacityRemaining": [
    {
      "rawValue": 12,
      "unit": "MILES"
    }
  ],
  "capacityUntilFull": [
    {
      "rawValue": 6000,
      "unit": "SECONDS"
    }
  ],
  "isCharging": true,
  "isPluggedIn": true
}

Perangkat yang tidak dapat diisi ulang yang hanya mendukung pelaporan tingkat tagihan saat ini

{
  "descriptiveCapacityRemaining": "LOW"
}

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.Charge

Mulai atau hentikan pengisian daya.

Perintah ini memerlukan atribut berikut:

{
  "isRechargeable": true
}

Parameter

Parameter	Jenis	Deskripsi
charge	Boolean	Wajib. True untuk mulai mengisi daya, false untuk menghentikan pengisian daya.

Contoh

Memulai perintah pengisian daya

{
  "command": "action.devices.commands.Charge",
  "params": {
    "charge": true
  }
}

Menghentikan perintah pengisian daya

{
  "command": "action.devices.commands.Charge",
  "params": {
    "charge": false
  }
}

Perangkat ERRORS

Lihat daftar lengkap error dan pengecualian.

deviceUnplugged: Pengguna mencoba mengisi daya perangkat yang tidak dicolokkan.