Skema Trait Smart Home EnergyStorage

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

Atribut PERANGKAT

Perangkat dengan trait ini dapat melaporkan atribut berikut sebagai bagian dari operasi SYNC. Untuk mempelajari lebih lanjut cara menangani SYNC intent, lihat Pemenuhan intent.

Atribut Jenis Deskripsi
queryOnlyEnergyStorage Boolean

Wajib.

Benar jika perangkat ini hanya mendukung kueri tentang tingkat energi yang tersimpan 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 dalam respons kepada pengguna.

Nilai yang didukung:

KILOMETERS
MILES
isRechargeable Boolean

(Default: false)

Tetapkan ke benar 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 pengisian daya saat ini

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

STATUS Perangkat

Entitas dengan trait ini dapat melaporkan status berikut sebagai bagian dari operasi QUERY. Untuk mempelajari lebih lanjut cara menangani QUERY intent, lihat Pemenuhan intent.

Status Jenis Deskripsi
descriptiveCapacityRemaining String

Wajib.

Deskripsi kualitatif tentang tingkat kapasitas energi. Perhatikan bahwa hal ini berlaku jika tidak ada data kapasitas numerik. Jika data kapasitas numerik juga tersedia, data tersebut akan lebih diutamakan daripada data 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 saat ini dimiliki <device> saya atau Berapa persentase pengisian daya yang dimiliki <device> saya
[item, ...] Objek

Kapasitas yang tersisa dalam pasangan unit dan nilai.
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 penuh. Misalnya: Berapa lama waktu yang diperlukan hingga <device> terisi penuh.
[item, ...] Objek

Kapasitas hingga terisi 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 pengisian daya saat ini

{
  "descriptiveCapacityRemaining": "LOW"
}

PERINTAH Perangkat

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

action.devices.commands.Charge

Mulai atau berhenti mengisi daya.

Perintah ini memerlukan atribut berikut: 
{
  "isRechargeable": true
}

Parameter

Parameter Jenis Deskripsi
charge Boolean

Wajib.

Benar untuk memulai pengisian daya, salah untuk menghentikan pengisian daya.

Contoh

Perintah mulai mengisi daya

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

Perintah berhenti mengisi daya

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

ERROR Perangkat

Lihat daftar lengkap error dan pengecualian.

deviceUnplugged: Pengguna mencoba mengisi daya perangkat yang tidak dicolokkan.