स्मार्ट होम टाइमर ट्रेल स्कीमा

action.devices.traits.Timer - टाइमर की सुविधा से डिवाइस पर मौजूद टाइमर का पता चलता है.

उदाहरण के लिए, स्मार्ट स्प्रिंक्लर कंट्रोलर या स्मार्ट लाइट स्विच में पहले से मौजूद टाइमर हो सकता है. इस एट्रिब्यूट का इस्तेमाल, डिवाइस में पहले से मौजूद टाइमर को कंट्रोल करने के लिए किया जा सकता है. जैसे, नया टाइमर शुरू करने के साथ-साथ, चल रहे टाइमर को रोकने और रद्द करने के साथ-साथ, यह भी पूछा जा सकता है कि कितना समय बचा है.

डिवाइस की विशेषताएं

जिन डिवाइसों में यह एट्रिब्यूट मौजूद है वे SYNC कार्रवाई के तहत, इन एट्रिब्यूट की रिपोर्ट कर सकते हैं. SYNC इंटेंट मैनेज करने के बारे में ज़्यादा जानने के लिए, इंटेंट पूरा करना देखें.

विशेषताएं	टाइप	जानकारी
maxTimerLimitSec	Integer	ज़रूरी है. यह टाइमर, डिवाइस पर उपलब्ध सबसे लंबी टाइमर सेटिंग के बारे में बताता है. इसे सेकंड में मापा जाता है.
commandOnlyTimer	बूलियन	(डिफ़ॉल्ट: false) यह बताता है कि क्या डिवाइस पर एकतरफ़ा (सही) या दोतरफ़ा (गलत) बातचीत का इस्तेमाल किया जा सकता है. अगर डिवाइस इस खासियत के लिए किसी 'QUERY इंटेंट' या 'रिपोर्ट स्थिति' का जवाब नहीं दे पाता है, तो इस विशेषता को 'सही' पर सेट करें.

उदाहरण

दो घंटे के टाइमर की सीमा वाला डिवाइस.

{
  "maxTimerLimitSec": 7200
}

डिवाइस के राज्य

इस खासियत वाली इकाइयां, QUERY ऑपरेशन के हिस्से के तौर पर इन स्थितियों की रिपोर्ट कर सकती हैं. QUERY इंटेंट मैनेज करने के बारे में ज़्यादा जानने के लिए, इंटेंट पूरा करना देखें.

राज्य	टाइप	जानकारी
timerRemainingSec	Integer	ज़रूरी है. वर्तमान समय सेकंड में शेष है, -1 या [0], maxTimerLimitSec. यह दिखाने के लिए कि कोई टाइमर नहीं चल रहा है, -1 पर सेट करें.
timerPaused	बूलियन	अगर चालू टाइमर चालू है, लेकिन मौजूदा समय में रुका हुआ है, तो वैल्यू 'सही' होगी.

उदाहरण

डिवाइस टाइमर पर कितना समय बाकी है? (नहीं चल रहा है).

{
  "timerRemainingSec": -1
}

डिवाइस टाइमर पर कितना समय बाकी है? (चल रहा है).

{
  "timerRemainingSec": 60
}

डिवाइस टाइमर पर कितना समय बाकी है? (रोका गया).

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

डिवाइस के निर्देश

जिन डिवाइसों पर इस एट्रिब्यूट का इस्तेमाल होता है वे EXECUTE कार्रवाई के तहत, इन निर्देशों का पालन कर सकते हैं. EXECUTE इंटेंट मैनेज करने के बारे में ज़्यादा जानने के लिए, इंटेंट पूरा करना देखें.

action.devices.commands.TimerStart

नया टाइमर शुरू करें.

पैरामीटर

पैरामीटर	टाइप	जानकारी
timerTimeSec	Integer	ज़रूरी है. सेकंड में टाइमर की अवधि; [1, maxTimerLimitSec] के अंदर होनी चाहिए.

उदाहरण

डिवाइस टाइमर पांच मिनट के लिए चलाएं.

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

मिलती-जुलती गड़बड़ियां

टाइमर शुरू करने में कोई गड़बड़ी हुई.

इस्तेमाल की जा सकने वाली वैल्यू:

noTimerExists

timerValueOutOfRange

aboveMaximumTimerDuration

belowMinimumTimerDuration

action.devices.commands.TimerAdjust

टाइमर की अवधि बदलें.

पैरामीटर

पैरामीटर	टाइप	जानकारी
timerTimeSec	Integer	ज़रूरी है. टाइमर का सेकंड में पॉज़िटिव या नेगेटिव अडजस्टमेंट; [-maxTimerLimitSec, maxTimerLimitSec] के अंदर होना चाहिए.

उदाहरण

डिवाइस के टाइमर में एक मिनट जोड़ें.

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

डिवाइस टाइमर से 30 सेकंड कम करें.

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

मिलती-जुलती गड़बड़ियां

टाइमर में बदलाव करते समय कोई गड़बड़ी हुई.

इस्तेमाल की जा सकने वाली वैल्यू:

noTimerExists

timerValueOutOfRange

aboveMaximumTimerDuration

belowMinimumTimerDuration

action.devices.commands.TimerPause

टाइमर रोकें.

पैरामीटर

पैरामीटर	टाइप	जानकारी
कोई प्रॉपर्टी नहीं

उदाहरण

डिवाइस का टाइमर रोकें.

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

मिलती-जुलती गड़बड़ियां

टाइमर को रोकते समय कोई गड़बड़ी हुई.

इस्तेमाल की जा सकने वाली वैल्यू:

noTimerExists

action.devices.commands.TimerResume

टाइमर फिर से शुरू करो.

पैरामीटर

पैरामीटर	टाइप	जानकारी
कोई प्रॉपर्टी नहीं

उदाहरण

डिवाइस का टाइमर फिर से शुरू करें.

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

मिलती-जुलती गड़बड़ियां

टाइमर फिर से शुरू करते समय कोई गड़बड़ी हुई.

इस्तेमाल की जा सकने वाली वैल्यू:

noTimerExists

action.devices.commands.TimerCancel

टाइमर रद्द करें.

पैरामीटर

पैरामीटर	टाइप	जानकारी
कोई प्रॉपर्टी नहीं

उदाहरण

डिवाइस का टाइमर बंद करो.

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

मिलती-जुलती गड़बड़ियां

टाइमर बंद करते समय कोई गड़बड़ी हुई.

इस्तेमाल की जा सकने वाली वैल्यू:

noTimerExists

डिवाइस की गड़बड़ियां

गड़बड़ियों और अपवादों की पूरी सूची देखें.