Akıllı Ev EnerjiDepolama Özelliği Şeması

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

Cihaz ATTRIBUTES

Bu özelliğe sahip cihazlar, SYNC işlemi kapsamında aşağıdaki özellikleri bildirebilir. SYNC amaçlarının ele alınması hakkında daha fazla bilgi edinmek için Niyet 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 ancak şarjı başlatmayı ve durdurmayı desteklemiyorsa doğru değerini döndürür.
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 doğru değerine ayarlayın. Bu, cihazın capacityUntilFull, isCharging ve isteğe bağlı olarak isPluggedIn durumunu raporlayabileceğ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 seviyesini bildirmeyi destekleyen şarj edilebilir olmayan cihaz

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

Cihaz STATES

Bu özelliğe sahip öğeler, QUERY işlemi kapsamında aşağıdaki durumları bildirebilir. QUERY amaçlarının ele alınması hakkında daha fazla bilgi edinmek için Niyet karşılama bölümüne bakın.

Eyaletler Tür Açıklama
descriptiveCapacityRemaining String

Zorunludur.

Enerji kapasitesi seviyesinin niteliksel açıklaması. Bunun, sayısal kapasite verilerinin olmadığı durumlar için geçerli olduğunu unutmayın. Sayısal kapasite verileri de mevcutsa mümkün olduğunda açıklayıcı verilere 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: <cihaz>ımın şu anda kaç mil mesafesi var? veya <cihaz>ımın şarjı yüzde kaç?
[item, ...] Nesne

Birim ve değer çiftinde kalan kapasite.
rawValue Tamsayı

Zorunludur.

Kapasite değeri.
unit String

Zorunludur.

Kapasite birimi.

Desteklenen değerler:

SECONDS
MILES
KILOMETERS
PERCENTAGE
KILOWATT_HOURS
capacityUntilFull Dizi

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

Şarj edilene kadar kapasite.
rawValue Tamsayı

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 edilip edilmediği.
isPluggedIn Boole

Cihazın şu anda prize takılı olup olmadığı. Cihaz fişe takılı olabilir ancak etkin bir şekilde şarj olmuyordur.

Ö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 seviyesinin raporlanmasını destekleyen şarj edilebilir olmayan cihaz

{
  "descriptiveCapacityRemaining": "LOW"
}

Cihaz KOMUTLARI

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

action.devices.commands.Charge

Şarjı başlatma veya durdurma.

Bu komut için aşağıdaki özellikler gereklidir: 
{
  "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 girin.

Örnekler

Şarjı başlat komutu

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

Şarjı durdurma komutu

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

Cihaz HATALARI

Hata ve istisnaların tam listesini inceleyin.

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