Akıllı Ev Zamanlayıcı Özelliği Şeması

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

Örneğin, akıllı yağmurlama kumandası veya akıllı ışık anahtarında yerleşik bir zamanlayıcı bulunabilir. Bu özellik, cihazlarda yerleşik bir 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 kalan sürenin ne kadar olduğunu sorabilirsiniz.

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

Özellikler Tür Açıklama
maxTimerLimitSec Integer

Zorunludur.

Cihazdaki en uzun zamanlayıcı ayarını saniye cinsinden ölçer.

commandOnlyTimer Boole

(Varsayılan: false)

Cihazın tek yönlü (doğru) veya iki yönlü (yanlış) iletişimin kullanılmasını destekleyip desteklemediğini gösterir. Cihaz bu özellik için bir QUERY amacına veya Rapor Durumuna yanıt veremiyorsa bu özelliği true olarak ayarlayın.

Örnekler

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

{
  "maxTimerLimitSec": 7200
}

Cihaz STATES

Bu özelliğe sahip varlıklar, QUERY işleminin bir parçası olarak aşağıdaki durumları bildirebilir. QUERY amaçlarını 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.

Saniye, -1 veya [0, maxTimerLimitSec] olarak kalan süre. Çalışmadığını göstermek 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ında ne kadar süre kaldı? (koşuda).

{
  "timerRemainingSec": 60
}

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

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

Cihaz COMMANDS

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

action.devices.commands.TimerStart

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

Parametreler

Parametreler Tür Açıklama
timerTimeSec Integer

Zorunludur.

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

Örnekler

Beş dakikalık cihaz zamanlayıcısını ç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

Zorunludur.

Zamanlayıcının saniye cinsinden pozitif veya negatif ayarlaması; [-maxTimerLimitSec, maxTimerLimitSec] dahilinde olmalıdır.

Örnekler

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

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

Cihaz zamanlayıcısının 30 saniyesini kısaltı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ı duraklatabilirsiniz.

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

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

Parametreler

Parametreler Tür Açıklama

Özellik yok

Örnekler

Cihaz zamanlayıcısını durdurun.

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

Zamanlayıcı durdurulurken bir hata oluştu.

Desteklenen değerler:

noTimerExists

Cihaz ERRORS

Hataların ve istisnaların tam listesine bakın.