स्मार्ट होम टाइमर की खासियत का स्कीमा

action.devices.traits.Timer - टाइमर की विशेषता, डिवाइस पर टाइमर को दिखाती है.

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

डिवाइस की ATTRIBUTES

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

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

ज़रूरी है.

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

कम से कम वैल्यू: 1.
commandOnlyTimer बूलियन

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

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

उदाहरण

डिवाइस पर दो घंटे के लिए टाइमर सेट किया गया हो.

{
  "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] के बीच होनी चाहिए.

कम से कम वैल्यू: 1.

उदाहरण

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

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

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

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