Akıllı Ev Enerji Depolama Alanı Şeması

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

Cihaz ATTRIBUTES

Bu özelliğe sahip cihazlar, SYNC işleminin bir parçası olarak aşağıdaki özellikleri bildirebilir. SYNC amaçlarını işleme hakkında daha fazla bilgi edinmek için Amaç karşılama bölümüne bakın.

Özellikler Tür Açıklama
queryOnlyEnergyStorage Boole

Zorunludur.

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 doğru değerini döndürür, ancak şarjı başlatmayı ve durdurmayı desteklemez.

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 edilebiliyorsa true değerine ayarlayın. Bu simge, 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 seviyesinin raporlanmasını destekleyen, şarj edilemez cihaz

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

Cihaz STATES

Bu özelliğe sahip varlıklar, QUERY işleminin bir parçası olarak aşağıdaki durumları bildirebilir. QUERY amaçlarını işleme hakkında daha fazla bilgi edinmek için Amaç karşılama bölümüne bakın.

Eyaletler Tür Açıklama
descriptiveCapacityRemaining String

Zorunludur.

Enerji kapasitesi seviyesinin nitel bir açıklaması. Bunun sayısal kapasite verisinin olmadığı durumlar için olduğunu unutmayın. Sayısal kapasite verileri de varsa mümkün olduğunda tanımlayıcı yerine tercih edilir.

Desteklenen değerler:

CRITICALLY_LOW
LOW
MEDIUM
HIGH
FULL
capacityRemaining Dizi

Cihazın mevcut enerji kapasitesi hakkında bilgi içeren birim/değer çiftleri dizisi. Örneğin: <device> cihazım şu anda kaç kilometre şarj ediyor veya <device> cihazımun şarj yüzdesi

[item, ...] Nesne

Birim ve değer çiftinde kalan kapasite.

rawValue Integer

Zorunludur.

Kapasite değeri.

unit String

Zorunludur.

Kapasite birimi.

Desteklenen değerler:

SECONDS
MILES
KILOMETERS
PERCENTAGE
KILOWATT_HOURS
capacityUntilFull Dizi

Cihaz tam olarak şarj edilene kadar kapasiteyle ilgili bilgileri tutan birim/değer çiftleri dizisi. Örneğin: <device> cihazının tam olarak şarj olmasına ne kadar kaldı?

[item, ...] Nesne

Şarj edilene kadar kapasite.

rawValue Integer

Zorunludur.

Kapasite değeri.

unit String

Zorunludur.

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 fişe takılı olup olmadığı. Cihaz fişe takılı olabilir ancak aktif olarak şarj olmuyor.

Ö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 geçerli şarj seviyesinin raporlanmasını destekleyen, şarj edilemez cihaz

{
  "descriptiveCapacityRemaining": "LOW"
}

Cihaz COMMANDS

Bu özelliğe sahip cihazlar, EXECUTE işleminin bir parçası olarak aşağıdaki komutlara yanıt verebilir. EXECUTE amaçlarını işleme hakkında daha fazla bilgi edinmek için Amaç karşılama bölümüne bakın.

action.devices.commands.Charge

Şarj işlemini başlatın veya durdurun.

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

Parametreler

Parametreler Tür Açıklama
charge Boole

Zorunludur.

Şarjı başlatmak için Doğru, şarjı durdurmak için yanlış değerini alır.

Örnekler

Şarjı başlat komutu

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

Şarjı durdur komutu

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

Cihaz ERRORS

Hataların ve istisnaların tam listesine bakın.

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