स्मार्ट होम रोटेशन Trait स्कीमा

action.devices.traits.Rotation - यह विशेषता ऐसे डिवाइस से जुड़ी है जो रोटेशन का समर्थन करता है.

रोटेशन को प्रतिशत या डिग्री में बताया जा सकता है और अगर डिवाइस, रोटेशन की सुविधा देता है डिग्री से, रोटेशन की डिफ़ॉल्ट दिशा घड़ी की सुई की दिशा में होती है.

डिवाइस ATTRIBUTES

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

विशेषताएं टाइप ब्यौरा
supportsDegrees बूलियन

ज़रूरी है.

अगर डिवाइस डिग्री के अनुसार घुमाने की अनुमति देता है, तो 'सही' पर सेट करें.
supportsPercent बूलियन

ज़रूरी है.

अगर डिवाइस प्रतिशत के अनुसार घुमाव की अनुमति देता है, तो 'सही' पर सेट करें
rotationDegreesRange ऑब्जेक्ट

रेंज को डिग्री में दिखाएं, जिसे डिवाइस घुमा सकता है.
rotationDegreesMin Number

ज़रूरी है.

डिग्री में कम से कम घुमाव.
rotationDegreesMax Number

ज़रूरी है.

डिग्री में अधिकतम घुमाव.
supportsContinuousRotation बूलियन

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

अगर डिवाइस लगातार घुमाने की अनुमति देता है, तो 'सही' पर सेट करें. मिलती-जुलती क्वेरी दिए जाने पर, RotateAbsolute निर्देश, इस्तेमाल की जा सकने वाली रोटेशन रेंज के आस-पास रैप होगा.
commandOnlyRotation बूलियन

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

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

उदाहरण

ऐसा डिवाइस जिस पर प्रतिशत और डिग्री, दोनों तरह से घुमाया जा सकता है.

{
  "supportsDegrees": true,
  "supportsPercent": true,
  "rotationDegreesRange": {
    "rotationDegreesMin": 0,
    "rotationDegreesMax": 180
  }
}

ऐसा डिवाइस जिस पर सिर्फ़ डिग्री में घूमने की सुविधा काम करती है.

{
  "supportsDegrees": true,
  "supportsPercent": false,
  "rotationDegreesRange": {
    "rotationDegreesMin": 0,
    "rotationDegreesMax": 90
  }
}

वह डिवाइस जो सिर्फ़ लगातार बदलने वाले निर्देशों के साथ काम करता है.

{
  "supportsDegrees": true,
  "supportsPercent": true,
  "rotationDegreesRange": {
    "rotationDegreesMin": 0,
    "rotationDegreesMax": 360
  },
  "supportsContinuousRotation": true,
  "commandOnlyRotation": true
}

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

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

राज्य टाइप ब्यौरा
rotationDegrees Number

rotationDegreesRange में मौजूदा लेवल, जो बताता है कि डिवाइस को कितनी डिग्री पर घुमाया गया है. यह वैल्यू हमेशा घड़ी की सुई की दिशा में घूमने की दिशा में होनी चाहिए.
rotationPercent Number

मौजूदा लेवल से यह पता चलता है कि डिवाइस अभी कितने प्रतिशत तक घुमाया गया है. 0.0 का मतलब बंद है और 100.0 का मतलब खुला है.
targetRotationPercent Number

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

उदाहरण

डिवाइस को कितना घुमाया गया? (प्रतिशत और डिग्री).

{
  "rotationDegrees": 45,
  "rotationPercent": 25
}

डिवाइस को कितना घुमाया गया? (सिर्फ़ डिग्री).

{
  "rotationDegrees": 45
}

डिवाइस को कितना घुमाया गया? (लगातार).

{
  "rotationDegrees": 270,
  "rotationPercent": 75
}

फ़िलहाल, डिवाइस नई पोज़िशन (प्रतिशत) पर घूम रहा है.

{
  "rotationPercent": 75,
  "targetRotationPercent": 100
}

डिवाइस COMMANDS

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

action.devices.commands.RotateAbsolute

डिवाइस का पूरा रोटेशन सेट करें.

पैरामीटर

पेलोड में इनमें से कोई एक शामिल होता है:

पूरा रोटेशन डिग्री में सेट करें.

पैरामीटर टाइप ब्यौरा
rotationDegrees Number

ज़रूरी है.

डिग्री में निरपेक्ष वैल्यू होती है, जो डिवाइस की घड़ी की सुई घूमने की दिशा में तय करती है. मान rotationDegreesRange एट्रिब्यूट के अंदर होना चाहिए.

कुल रोटेशन को प्रतिशत में सेट करें.

पैरामीटर टाइप ब्यौरा
rotationPercent Number

ज़रूरी है.

प्रतिशत के हिसाब से ऐब्सलूट वैल्यू, जो डिवाइस के फ़ाइनल रोटेशन को तय करती है.

उदाहरण

डिवाइस को 50 प्रतिशत तक झुकाएं.

{
  "command": "action.devices.commands.RotateAbsolute",
  "params": {
    "rotationPercent": 50
  }
}

डिवाइस को घड़ी की उलटी दिशा में 15 डिग्री घुमाएं (rotationDegrees: 45).

{
  "command": "action.devices.commands.RotateAbsolute",
  "params": {
    "rotationDegrees": 30
  }
}

डिवाइस को घड़ी की दिशा में 100 डिग्री (supportsContinuousRotation: true, rotationDegrees: 270) घुमाएं.

{
  "command": "action.devices.commands.RotateAbsolute",
  "params": {
    "rotationDegrees": 10
  }
}

डिवाइस को घुमाने का विकल्प सेट करते समय कोई गड़बड़ी हुई.

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

deviceJammingDetected

डिवाइस ERRORS

पूरी सूची देखें गड़बड़ियों और अपवाद के तौर पर मार्क किया जा सकता है.