Akıllı ev işlemlerinin nasıl geliştirileceğini öğrenebileceğiniz yeni adres olan Google Home Geliştirici Merkezi'ne hoş geldiniz. Not: Actions Console'da işlem derlemeye devam edersiniz.

Akıllı Ev EnergyStorage Özellik Şeması

action.devices.traits.EnergyStorage: Bu özellik, pilde enerji depolayabilecek ve potansiyel olarak yeniden şarj olabilecek cihazlara veya başka bir cihazı şarj edebilecek 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 için Amaç karşılama bölümüne bakın.

Özellikler Type 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ıdır) ile ilgili sorguları destekliyorsa ancak şarjın başlatılmasını ve durdurulmasını desteklemiyorsa doğrudur.

energyStorageDistanceUnitForUX Dize

(Varsayılan: "KILOMETERS")

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

Desteklenen değerler:

KILOMETERS
MILES
isRechargeable Boole

(Varsayılan: false)

Bu cihaz yeniden şarj edilebilirse doğru değerine 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 olarak gösteren şarj edilebilir cihaz

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

Yalnızca geçerli şarj düzeyinin raporlanmasını destekleyen, şarj edilemeyen cihaz

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

Cihaz STATUS

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

Eyaletler Type Açıklama
descriptiveCapacityRemaining Dize

Zorunludur.

Enerji kapasitesi seviyesinin nitel bir açıklaması. Bunun sayısal kapasite verisi olmadığında kullanıldığını unutmayın. Sayısal kapasite verileri de kullanılabiliyorsa açıklayıcı olmak yerine tercih edilir.

Desteklenen değerler:

CRITICALLY_LOW
LOW
MEDIUM
HIGH
FULL
capacityRemaining Dizi

Cihazın şu anda sahip olduğu enerji kapasitesi hakkında bilgi tutan birim/değer çiftleri dizisi. Örneğin: <device> cihazımda şu an 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 içeren birim/değer çiftleri dizisi. Örneğin: <device> cihazın tam olarak şarj olmasına ne kadar kaldı?

[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 edilip edilmediği bilgisi.

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

{
  "descriptiveCapacityRemaining": "LOW"
}

Cihaz Komisyonları

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 için Amaç karşılama bölümüne bakın.

action.devices.commands.Charge

Şarjı başlatın veya durdurun.

Bu komut, aşağıdaki özellikleri gerektirir:
{
  "isRechargeable": true
}

Parametreler

Parametreler Type Açıklama
charge Boole

Zorunludur.

Doğru şarja başlamak için doğru, şarjı durdurmak için yanlış.

Örnekler

Şarj etmeye başlama komutu

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

Şarj etmeyi durdurma 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ı.