Akıllı ev işlemlerinin nasıl geliştirileceğini öğrenmek için yeni adres olan Google Home Geliştirici Merkezi'ne hoş geldiniz. Not: Actions Console'da işlem oluşturmaya devam edersiniz.
Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

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