Smart Home EnergyStorage Trait Şeması

action.devices.traits.EnergyStorage: Bu özellik, enerjiyi pilde depolayabilen ve potansiyel olarak yeniden şarj edebilen veya başka bir cihazı şarj edebilen cihazlara aittir.

Cihaz ÖZELLİKLERİ

Bu özelliğe sahip cihazlar, SYNC işlemi kapsamında aşağıdaki özellikleri bildirebilir. SYNC amaçlarını ele alma hakkında daha fazla bilgi edinmek için Amacı karşılama başlıklı makaleyi inceleyin.

Özellikler Tür Açıklama
queryOnlyEnergyStorage Boole

Zorunlu.

Bu cihaz yalnızca depolanan enerji seviyeleri ve isteğe bağlı olarak etkin şarj durumu (isRechargeable özelliğine bağlıdır) ile ilgili sorguları destekliyorsa ancak şarjı başlatma ve durdurmayı desteklemiyorsa doğru.
energyStorageDistanceUnitForUX String

(Varsayılan: "KILOMETERS")

Kullanıcıya verilen yanıtlarda kullanılır.

Desteklenen değerler:

KILOMETERS
MILES
isRechargeable Boole

(Varsayılan: false)

Bu cihaz şarj edilebilirse true olarak ayarlayın. Bu, cihazın capacityUntilFull, isCharging ve isteğe bağlı olarak isPluggedIn durumunu bildirebileceğini ve Charge komutunu kabul edebileceğini gösterir.

Örnekler

Şarj edilebilir cihaz

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

Mevcut şarj seviyesini mil cinsinden gösteren şarj edilebilir cihaz

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

Yalnızca mevcut şarj düzeyini bildirmeyi destekleyen, şarj edilemeyen cihaz

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

Cihaz DURUMLARI

Bu özelliğe sahip öğeler, QUERY işlemi kapsamında aşağıdaki durumları bildirebilir. QUERY amaçlarını ele alma hakkında daha fazla bilgi edinmek için Amacı karşılama başlıklı makaleyi inceleyin.

Eyaletler Tür Açıklama
descriptiveCapacityRemaining String

Zorunlu.

Enerji kapasitesi seviyesinin niteliksel açıklaması. Bu seçeneğin, sayısal kapasite verisi olmadığında kullanıldığını unutmayın. Sayısal kapasite verileri de varsa mümkün olduğunda açıklayıcı veriler yerine bunlar tercih edilir.

Desteklenen değerler:

CRITICALLY_LOW
LOW
MEDIUM
HIGH
FULL
capacityRemaining Array

Cihazın şu anda sahip olduğu enerji kapasitesi hakkında bilgi içeren birim/değer çiftleri dizisi. Örneğin: <Cihaz> şu anda kaç kilometre yol gidebilir? veya <Cihaz>ın şarjı yüzde kaç?
[item, ...] Nesne

Birim ve değer çifti olarak kalan kapasite.
rawValue Integer

Zorunlu.

Kapasite değeri.
unit String

Zorunlu.

Kapasite birimi.

Desteklenen değerler:

SECONDS
MILES
KILOMETERS
PERCENTAGE
KILOWATT_HOURS
capacityUntilFull Array

Cihaz tamamen şarj olana kadar kapasiteyle ilgili bilgileri içeren birim/değer çiftleri dizisi. Örneğin: <device> cihazının tamamen şarj olması için ne kadar süre gerekiyor?
[item, ...] Nesne

Şarj olana kadar kapasite.
rawValue Integer

Zorunlu.

Kapasite değeri.
unit String

Zorunlu.

Kapasite birimi.

Desteklenen değerler:

SECONDS
MILES
KILOMETERS
PERCENTAGE
KILOWATT_HOURS
isCharging Boole

Cihazın şu anda şarj olup olmadığı.
isPluggedIn Boole

Cihazın şu anda prize takılı olup olmadığı. Cihazın fişi takılı olabilir ancak aktif olarak şarj olmuyor olabilir.

Örnekler

Şarj edilebilir cihaz

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

Mevcut şarj seviyesini mil cinsinden gösteren şarj edilebilir cihaz

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

Yalnızca mevcut şarj düzeyini bildirmeyi destekleyen, şarj edilemeyen cihaz

{
  "descriptiveCapacityRemaining": "LOW"
}

Cihaz KOMUTLARI

Bu özelliğe sahip cihazlar, EXECUTE işlemi kapsamında aşağıdaki komutlara yanıt verebilir. EXECUTE amaçlarını ele alma hakkında daha fazla bilgi edinmek için Amacı karşılama başlıklı makaleyi inceleyin.

action.devices.commands.Charge

Şarjı başlatma veya durdurma

Bu komut için aşağıdaki özellikler gerekir: 
{
  "isRechargeable": true
}

Parametreler

Parametreler Tür Açıklama
charge Boole

Zorunlu.

Şarjı başlatmak için true, durdurmak için false.

Örnekler

Şarj etme komutunu başlatma

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

Şarjı durdurma komutu

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

Cihaz HATALARI

Hatalar ve istisnalar listesinin tamamını inceleyin.

deviceUnplugged: Kullanıcı, fişe takılı olmayan bir cihazı şarj etmeye çalıştı.