Skema Atribut EnergyStorage Smart Home

action.devices.traits.EnergyStorage - Sifat ini termasuk perangkat yang dapat menyimpan energi di baterai dan mungkin dapat diisi ulang, atau yang dapat mengisi daya perangkat lain.

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

Contoh

Perangkat yang dapat diisi ulang

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

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

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

Perangkat yang tidak dapat diisi ulang dan hanya mendukung pelaporan tingkat pengisian daya saat ini

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

STATUS Perangkat

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

Negara bagian	Jenis	Deskripsi
descriptiveCapacityRemaining	String	Wajib. Deskripsi kualitatif tingkat kapasitas energi. Perhatikan bahwa hal ini dilakukan saat tidak ada data kapasitas numerik. Jika data kapasitas numerik juga tersedia, data tersebut akan lebih diutamakan 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 saat ini dimiliki perangkat. Misalnya: Berapa mil yang dimiliki <device> saya saat ini atau Berapa persentase biaya yang dimiliki <device> saya
[item, ...]	Objek	Kapasitas yang tersisa dalam pasangan unit dan nilai.
rawValue	Integer	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 penuh. Misalnya: Berapa lama waktu yang diperlukan hingga <device> terisi penuh dayanya.
[item, ...]	Objek	Kapasitas hingga terisi daya.
rawValue	Integer	Wajib. Nilai kapasitas.
unit	String	Wajib. Unit kapasitas. Nilai yang didukung: SECONDS MILES KILOMETERS PERCENTAGE KILOWATT_HOURS
isCharging	Boolean	Apakah perangkat 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 dan menampilkan level 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 dan hanya mendukung pelaporan tingkat pengisian daya saat ini

{
  "descriptiveCapacityRemaining": "LOW"
}

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

Mulai atau hentikan pengisian daya.

Perintah ini memerlukan atribut berikut:

{
  "isRechargeable": true
}

Parameter

Parameter	Jenis	Deskripsi
charge	Boolean	Wajib. Benar untuk mulai mengisi daya, salah untuk menghentikan pengisian daya.

Contoh

Mulai menjalankan 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.