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

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 का मतलब है कि कारोबार खुला है.
targetRotationPercent Number

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

उदाहरण

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

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

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

{
  "rotationDegrees": 45
}

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

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

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

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

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

इस विशेषता वाले डिवाइस, 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

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

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