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
  }
}

İlgili hatalar

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
  }
}

İlgili hatalar

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": {}
}

İlgili hatalar

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": {}
}

İlgili hatalar

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": {}
}

İlgili hatalar

Zamanlayıcı durdurulurken bir hata oluştu.

Desteklenen değerler:

noTimerExists

Cihaz HATALARI

Hataların ve istisnaların tam listesini inceleyin.