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 Zamanlayıcı Sistemi Şeması

action.devices.traits.Timer: Zamanlayıcı özelliği bir cihazdaki zamanlayıcıyı temsil eder.

Örneğin, bir akıllı fıskiye veya akıllı ışık anahtarının yerleşik bir zamanlayıcısı olabilir. Bu özellik, yeni bir zamanlayıcı başlatmanın yanı sıra çalışan bir zamanlayıcıyı duraklatıp iptal edip ne kadar süre kaldığını sorma gibi cihazlardaki yerleşik bir zamanlayıcıyı kontrol etmek için kullanılabilir.

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
maxTimerLimitSec Integer

Zorunludur.

Saniye cinsinden ölçülen, cihazda kullanılabilen en uzun zamanlayıcı ayarını belirtir.

commandOnlyTimer Boole

(Varsayılan: false)

Cihazın tek yönlü (true) veya iki yönlü (false) iletişimin kullanılmasını destekleyip desteklemediğini belirtir. Cihaz, bu özellik için bir QUERY amacına veya rapor durumuna yanıt vermiyorsa bu özelliği "true" olarak ayarlayın.

Örnekler

İki saatlik zamanlayıcı sınırı olan cihaz.

{
  "maxTimerLimitSec": 7200
}

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
timerRemainingSec Integer

Zorunludur.

Mevcut süre (saniye, -1 veya [0, maxTimerLimitSec]) olarak kaldı. Zamanlayıcının çalışmadığını belirtmek için -1 olarak ayarlayın.

timerPaused Boole

Etkin bir zamanlayıcı mevcutsa ancak şu anda duraklatılmışsa doğru değerini döndürür.

Örnekler

Cihazın zamanlayıcısına ne kadar kaldı? (çalışmıyor).

{
  "timerRemainingSec": -1
}

Cihazın zamanlayıcısına ne kadar kaldı? (çalışıyor).

{
  "timerRemainingSec": 60
}

Cihazın zamanlayıcısına ne kadar kaldı? (duraklatıldı).

{
  "timerRemainingSec": 30,
  "timerPaused": true
}

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

Yeni bir zamanlayıcı başlat.

Parametreler

Parametreler Tür Açıklama
timerTimeSec Integer

Zorunludur.

Zamanlayıcının saniye cinsinden süresi [1, maxTimerLimitSec] olmalıdır.

Örnekler

Cihaz zamanlayıcısını beş dakika süreyle çalıştırın.

{
  "command": "action.devices.commands.TimerStart",
  "params": {
    "timerTimeSec": 300
  }
}

Zamanlayıcı başlatılırken bir hata oluştu.

Desteklenen değerler:

noTimerExists
timerValueOutOfRange
aboveMaximumTimerDuration
belowMinimumTimerDuration

action.devices.commands.TimerAdjust

Zamanlayıcı süresini ayarlayın.

Parametreler

Parametreler Tür Açıklama
timerTimeSec Integer

Zorunludur.

Zamanlayıcının saniye cinsinden pozitif veya negatif düzenlemesi; [-maxTimerLimitSec, maxTimerLimitSec] aralığında olmalıdır.

Örnekler

Cihaz zamanlayıcıya bir dakika ekleyin.

{
  "command": "action.devices.commands.TimerAdjust",
  "params": {
    "timerTimeSec": 60
  }
}

Cihaz zamanlayıcıdan 30 saniye çıkarır.

{
  "command": "action.devices.commands.TimerAdjust",
  "params": {
    "timerTimeSec": -30
  }
}

Zamanlayıcı ayarlanırken bir hata oluştu.

Desteklenen değerler:

noTimerExists
timerValueOutOfRange
aboveMaximumTimerDuration
belowMinimumTimerDuration

action.devices.commands.TimerPause

Zamanlayıcıyı duraklat.

Parametreler

Parametreler Tür Açıklama

Özellik yok

Örnekler

Cihazın zamanlayıcısını duraklatın.

{
  "command": "action.devices.commands.TimerPause",
  "params": {}
}

Zamanlayıcı duraklatılırken bir hata oluştu.

Desteklenen değerler:

noTimerExists

action.devices.commands.TimerResume

Zamanlayıcıyı devam ettir.

Parametreler

Parametreler Tür Açıklama

Özellik yok

Örnekler

Cihaz zamanlayıcıyı devam ettirin.

{
  "command": "action.devices.commands.TimerResume",
  "params": {}
}

Zamanlayıcı devam ettirilirken bir hata oluştu.

Desteklenen değerler:

noTimerExists

action.devices.commands.TimerCancel

Zamanlayıcıyı iptal etme.

Parametreler

Parametreler Tür Açıklama

Özellik yok

Örnekler

Cihazın zamanlayıcısını durdurun.

{
  "command": "action.devices.commands.TimerCancel",
  "params": {}
}

Zamanlayıcı durdurulurken bir hata oluştu.

Desteklenen değerler:

noTimerExists

Cihaz HATALARI

Hataların ve istisnaların tam listesini inceleyin.