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

action.devices.traits.Rotation - यह विशेषता उन डिवाइस से जुड़ी है जिनमें घुमाव इस्तेमाल किया जा सकता है.

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

डिवाइस की विशेषताएं

इस सुविधा का इस्तेमाल करने वाले डिवाइस, 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 खोलने के लिए.

उदाहरण

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

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

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

{
  "rotationDegrees": 45
}

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

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

डिवाइस के निर्देश

इस सुविधा का इस्तेमाल करने वाले डिवाइस, 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

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

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