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

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

डिवाइस में गड़बड़ी

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