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

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

डिवाइस की गड़बड़ियां

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