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

action.devices.traits.EnergyStorage: Bu özellik, pili enerji ile depolayıp potansiyel olarak yeniden şarj edilebilen cihazlara veya başka bir cihazı şarj edebilecek cihazlara aittir.

Cihaz ÖZELLİKLERİ

Bu özelliğe sahip cihazlar, SYNC işleminin bir parçası olarak aşağıdaki özellikleri bildirebilir. SYNC niyetlerini 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 düzeyleri ve isteğe bağlı olarak etkin şarj durumu (isRechargeable özelliğine bağlı olarak) ile ilgili sorguları destekliyorsa ancak şarjın başlatılmasını ve durdurulmasını desteklemiyorsa doğru değerini döndürür.
energyStorageDistanceUnitForUX	Dize	(Varsayılan: "KILOMETERS") Kullanıcıya verilen yanıtlarda kullanılacaktır. Desteklenen değerler: KILOMETERS MILES
isRechargeable	Boole	(Varsayılan: false) Bu cihaz şarj oluyorsa doğru değerine ayarlayın. Bu, cihazın capacityUntilFull, isCharging ve isteğe bağlı olarak isPluggedIn durumunu raporlayabileceği ve Charge komutunu kabul edebileceği anlamına gelir.

Ö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üzeyinin raporlanmasını destekleyen, şarj edilemeyen cihaz

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

Cihaz durumu

Bu özelliğe sahip cihazlar, QUERY işleminin bir parçası olarak aşağıdaki durumları bildirebilir. QUERY niyetlerini 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	Dize	Zorunludur. Enerji kapasitesi düzeyinin nitel bir açıklaması. Bunun sayısal kapasite verisi olmadığında kullanıldığını unutmayın. Sayısal kapasite verileri de varsa mümkün olduğunda tanımlayıcıdan ziyade tercih edilir. Desteklenen değerler: CRITICALLY_LOW LOW MEDIUM HIGH FULL
capacityRemaining	Dizi	Cihazın sahip olduğu enerji kapasitesiyle ilgili bilgileri tutan birim/değer çiftleri dizisi. Örneğin: <device> cihazımda kaç kilometre var veya <device> cihazımda kaç yüzdelik şarj var?
[item, ...]	Nesne	Birim ve değer çiftinde kalan kapasite.
rawValue	Integer	Zorunludur. Kapasite değeri.
unit	Dize	Zorunludur. Kapasite birimi. Desteklenen değerler: SECONDS MILES KILOMETERS PERCENTAGE KILOWATT_HOURS
capacityUntilFull	Dizi	Cihaz tam olarak şarj olana kadar kapasite hakkında bilgi tutan birim/değer çifti dizisi. Örneğin: <device> cihazın tam olarak şarj olması için ne kadar süre vardır?
[item, ...]	Nesne	Şarj edilene kadar kapasite.
rawValue	Integer	Zorunludur. Kapasite değeri.
unit	Dize	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 edilmez.

Ö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üzeyinin raporlanmasını destekleyen, şarj edilemeyen cihaz

{
  "descriptiveCapacityRemaining": "LOW"
}

Cihaz FTC'leri

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

action.devices.commands.Charge

Şarj etmeyi başlatın veya durdurun.

Bu komut aşağıdaki özellikleri gerektirir:

{
  "isRechargeable": true
}

Parametreler

Parametreler	Tür	Açıklama
charge	Boole	Zorunludur. Şarj etmeye başlamak için "doğru", şarjı durdurmak için "yanlış"

Örnekler

Şarj etme komutunu başlat

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

Şarj etmeyi durdur komutu

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

Cihaz HATALARI

Hataların ve istisnaların tam listesini inceleyin.

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