Akıllı Ev Zamanlayıcı Özellik Şeması

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

Örneğin, akıllı fıskiye denetleyicisi veya akıllı ışık anahtarının yerleşik bir zamanlayıcısı olabilir. Bu özellik, yeni bir zamanlayıcı başlatmak, çalışan bir zamanlayıcıyı duraklatmak ve iptal etmek ve ne kadar sürenizin kaldığını sormak gibi cihazlarda yerleşik bir zamanlayıcıyı kontrol etmek için kullanılabilir.

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

Özellikler	Type	Açıklama
maxTimerLimitSec	Integer	Zorunludur. Saniye cinsinden ölçülen, cihazda bulunan en uzun zamanlayıcı ayarını 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 doğru olarak ayarlayın.

Örnekler

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

{
  "maxTimerLimitSec": 7200
}

Cihaz STATUS

Bu özelliğe sahip varlıklar, QUERY işlemi kapsamında aşağıdaki durumları bildirebilir. QUERY amaçlarını işleme hakkında daha fazla bilgi için Amaç karşılama bölümüne bakın.

Eyaletler	Type	Açıklama
timerRemainingSec	Integer	Zorunludur. -1 veya [0, maxTimerLimitSec] saniye sonra kalan süre. Zamanlayıcının ç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ı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 Komisyonları

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

action.devices.commands.TimerStart

Yeni bir zamanlayıcı başlat.

Parametreler

Parametreler	Type	Açıklama
timerTimeSec	Integer	Zorunludur. Zamanlayıcının saniye cinsinden süresi. [1, maxTimerLimitSec] aralığında olmalıdır.

Örnekler

Cihaz zamanlayıcısını beş dakika boyunca ç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	Type	Açıklama
timerTimeSec	Integer	Zorunludur. Zamanlayıcının saniye cinsinden pozitif veya negatif değeri. [-maxTimerLimitSec, maxTimerLimitSec] dahilinde olmalıdır.

Örnekler

Cihaz zamanlayıcıya 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
  }
}

İ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	Type	Açıklama
Özellik yok

Örnekler

Cihaz zamanlayıcıyı 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	Type	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	Type	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.