स्मार्ट होम टाइमर ट्रैट स्कीमा

action.devices.traits.Timer - टाइमर trait, डिवाइस के टाइमर के बारे में बताता है.

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

डिवाइस ATTRIBUTES

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

विशेषताएं टाइप ब्यौरा
maxTimerLimitSec Integer

ज़रूरी है.

इससे पता चलता है कि डिवाइस पर उपलब्ध सबसे लंबे टाइमर की सेटिंग, सेकंड में मापी जाती है.

commandOnlyTimer बूलियन

(डिफ़ॉल्ट: false)

यह बताता है कि डिवाइस पर एकतरफ़ा (सही) या दोतरफ़ा (गलत) कम्यूनिकेशन की सुविधा काम करती है. अगर डिवाइस इस एट्रिब्यूट के लिए, QUERY इंटेंट या रिपोर्ट की स्थिति का जवाब नहीं दे सकता, तो इस एट्रिब्यूट को 'सही' पर सेट करें.

उदाहरण

डिवाइस, जिसमें दो घंटे की टाइमर सीमा लागू है.

{
  "maxTimerLimitSec": 7200
}

डिवाइस की स्थितियां

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

राज्य टाइप ब्यौरा
timerRemainingSec Integer

ज़रूरी है.

सेकंड, -1 या [0, maxTimerLimitSec] में शेष मौजूदा समय. कोई टाइमर नहीं चल रहा है, यह बताने के लिए -1 पर सेट करें.

timerPaused बूलियन

अगर कोई चालू टाइमर मौजूद है, लेकिन फ़िलहाल रुका हुआ है, तो वैल्यू 'सही' होगी.

उदाहरण

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

{
  "timerRemainingSec": -1
}

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

{
  "timerRemainingSec": 60
}

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

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

डिवाइस COMMANDS

इस खूबी वाले डिवाइस, 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

डिवाइस ERRORS

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