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

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

Örneğin, akıllı sulama sistemi kumandası veya akıllı ışık anahtarının yerleşik zamanlayıcısı olabilir. Bu özellik; yeni bir zamanlayıcı başlatma, çalışan bir zamanlayıcıyı duraklatıp iptal etme ve ne kadar süre kaldığını sorma gibi yerleşik bir zamanlayıcıyı kontrol etmek için kullanılabilir.

Cihaz ATTRIBUTES

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

Özellikler Tür Açıklama
maxTimerLimitSec Tamsayı

Zorunludur.

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

commandOnlyTimer Boole

(Varsayılan: false)

Cihazın tek yönlü (doğru) veya iki yönlü (yanlış) iletişimi destekleyip desteklemediğini belirtir. Cihaz, bu özellik için bir QUERY amacına veya Rapor Durumuna yanıt veremezse bu özelliği true olarak ayarlayın.

Örnekler

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

{
  "maxTimerLimitSec": 7200
}

Cihaz DURUMLARI

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

Eyaletler Tür Açıklama
timerRemainingSec Tamsayı

Zorunludur.

Kalan süre saniye cinsinden, -1 veya [0, maxTimerLimitSec]. Zamanlayıcının çalışmadığını belirtmek için -1 olarak ayarlanır.

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şu).

{
  "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 intent'lerini ele alma hakkında daha fazla bilgi edinmek için Intent 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 Tamsayı

Zorunludur.

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

Örnekler

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

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

Zamanlayıcı başlatılırken 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 Tamsayı

Zorunludur.

Zamanlayıcının saniye cinsinden pozitif veya negatif ayarlaması; [-maxTimerLimitSec, maxTimerLimitSec] içinde 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ın.

Parametreler

Parametreler Tür Açıklama

Özellik yok

Örnekler

Cihaz 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 ettirin.

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

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 HATALARI

Hataların ve istisnaların tam listesini inceleyin.