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