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ı bir sulama sistemi denetleyicisi veya akıllı ışık düğmesinde yerleşik bir zamanlayıcı bulunabilir. 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ı duraklatabilir ve iptal edebilir, kalan süreyi sorabilirsiniz.

CİHAZ ÖZELLİKLERİ

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

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

Zorunludur.

Cihazda kullanılabilen 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 bir QUERY intent'ine yanıt veremiyorsa veya bu özellik için durum raporlayamıyorsa 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 işleme 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ı? (çalışır).

{
  "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 işleme 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 ayarı; [-maxTimerLimitSec, maxTimerLimitSec] aralığında olmalıdır.

Örnekler

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

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

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.