Smart Home Timer Trait Şeması

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

Örneğin, akıllı sulama kontrol cihazı veya akıllı ışık anahtarında yerleşik bir zamanlayıcı olabilir. Bu özellik, cihazlardaki yerleşik zamanlayıcıyı kontrol etmek için kullanılabilir. Örneğin, yeni bir zamanlayıcı başlatabilir, çalışan bir zamanlayıcıyı duraklatıp iptal edebilir ve ne kadar süre kaldığını sorabilirsiniz.

Cihaz ÖZELLİKLERİ

Bu özelliğe sahip cihazlar, SYNC işlemi kapsamında aşağıdaki özellikleri bildirebilir. SYNC amaçlarını ele alma hakkında daha fazla bilgi edinmek için Amacı karşılama başlıklı makaleyi inceleyin.

Özellikler Tür Açıklama
maxTimerLimitSec Integer

Zorunlu.

Cihazda bulunan en uzun zamanlayıcı ayarını saniye cinsinden gösterir.

Minimum değer: 1.
commandOnlyTimer Boole

(Varsayılan: false)

Cihazın tek yönlü (doğru) veya iki yönlü (yanlış) iletişimi destekleyip desteklemediğini gösterir. Cihaz, bu özellik için QUERY amacına veya Durum Raporu'na yanıt veremiyorsa bu özelliği doğru olarak ayarlayın.

Örnekler

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

{
  "maxTimerLimitSec": 7200
}

Cihaz DURUMLARI

Bu özelliğe sahip öğeler, QUERY işlemi kapsamında aşağıdaki durumları bildirebilir. QUERY amaçlarını ele alma hakkında daha fazla bilgi edinmek için Amacı karşılama başlıklı makaleyi inceleyin.

Eyaletler Tür Açıklama
timerRemainingSec Integer

Zorunlu.

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

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

Örnekler

Cihaz zamanlayıcısında ne kadar süre kaldı? (çalışmıyor).

{
  "timerRemainingSec": -1
}

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

{
  "timerRemainingSec": 60
}

Cihaz zamanlayıcısında ne kadar süre kaldı? (duraklatıldı).

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

Cihaz KOMUTLARI

Bu özelliğe sahip cihazlar, EXECUTE işlemi kapsamında aşağıdaki komutlara yanıt verebilir. EXECUTE amaçlarını ele alma hakkında daha fazla bilgi edinmek için Amacı karşılama başlıklı makaleyi inceleyin.

action.devices.commands.TimerStart

Yeni bir zamanlayıcı başlatın.

Parametreler

Parametreler Tür Açıklama
timerTimeSec Integer

Zorunlu.

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

Minimum değer: 1.

Örnekler

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

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

Zorunlu.

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

Örnekler

Cihaz zamanlayıcısına bir dakika ekle.

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

Cihaz zamanlayıcısından 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 zamanlayıcısını duraklatma

{
  "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ısını 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 edin.

Parametreler

Parametreler Tür Açıklama

Özellik yok

Örnekler

Cihaz zamanlayıcısını durdurma

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

Zamanlayıcı durdurulurken bir hata oluştu.

Desteklenen değerler:

noTimerExists

Cihaz HATALARI

Hatalar ve istisnalar listesinin tamamını inceleyin.