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

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

डिवाइस से जुड़ी गड़बड़ियां

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