स्मार्ट होम डिवाइसों के लिए FanSpeed Trait का स्कीमा

action.devices.traits.FanSpeed - यह ट्रेट उन डिवाइसों के लिए है जिनमें पंखे की स्पीड सेट करने की सुविधा होती है.

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

डिवाइस की ATTRIBUTES

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

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

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

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

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

इससे पता चलता है कि डिवाइस पर एकतरफ़ा (सही) या दोनों तरफ़ा (गलत) बातचीत की सुविधा काम करती है या नहीं. अगर डिवाइस इस विशेषता के लिए, QUERY इंटेंट या Report State का जवाब नहीं दे सकता, तो इस एट्रिब्यूट को सही पर सेट करें.
इनमें से कोई भी आइटम शामिल हो:
0 ऑब्जेक्ट

वीडियो की स्पीड बदलने की सेटिंग के लिए सहायता.
availableFanSpeeds ऑब्जेक्ट

ज़रूरी है.

डिवाइस के साथ काम करने वाली स्पीड सेटिंग.
speeds ऐरे

ज़रूरी है.

स्पीड की सेटिंग की सूची.
[item, ...] ऑब्जेक्ट

स्पीड सेटिंग.
speed_name String

ज़रूरी है.

स्पीड सेटिंग का इंटरनल नाम. यह उपयोगकर्ता के लिए मददगार नहीं हो सकता. साथ ही, इसे सभी भाषाओं में शेयर किया जाएगा.
speed_values ऐरे

ज़रूरी है.

हर भाषा में, स्पीड सेटिंग के लिए समानार्थी शब्द.
[item, ...] ऑब्जेक्ट

किसी भाषा में स्पीड सेटिंग के लिए समानार्थी शब्द. भाषा फ़ॉलबैक की सुविधा देने के लिए, कम से कम एक ऐसा आइटम होना चाहिए जिसकी lang वैल्यू en हो.
speed_synonym ऐरे

ज़रूरी है.

स्पीड सेटिंग के लिए समानार्थी शब्दों में, एकवचन और बहुवचन, दोनों शामिल होने चाहिए. सूची में मौजूद पहले समानार्थी शब्द को, स्पीड सेटिंग का कैननिकल नाम माना जाएगा.
[item, ...] String

समानार्थी शब्द. भाषा फ़ॉलबैक की सुविधा देने के लिए, कम से कम एक ऐसा आइटम होना चाहिए जिसकी lang वैल्यू en हो.
lang String

ज़रूरी है.

भाषा कोड (ISO 639-1). यह सुविधा देने वाली भाषाएं देखें.
ordered बूलियन

ज़रूरी है.

अगर इस विकल्प को 'सही है' पर सेट किया जाता है, तो स्पीड को बढ़ाने या घटाने के लॉजिक के लिए अतिरिक्त व्याकरण लागू होगा. यह व्याकरण, स्पीड ऐरे के क्रम (बढ़ते क्रम) में लागू होगा.
1 ऑब्जेक्ट

स्पीड के प्रतिशत की जानकारी देने की सुविधा.
supportsFanSpeedPercent बूलियन

ज़रूरी है.

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

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

उदाहरण

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

{
  "availableFanSpeeds": {
    "speeds": [
      {
        "speed_name": "speed_low",
        "speed_values": [
          {
            "speed_synonym": [
              "Low",
              "Slow"
            ],
            "lang": "en"
          }
        ]
      },
      {
        "speed_name": "speed_high",
        "speed_values": [
          {
            "speed_synonym": [
              "High",
              "Fast"
            ],
            "lang": "en"
          }
        ]
      }
    ],
    "ordered": true
  },
  "reversible": true,
  "supportsFanSpeedPercent": true
}

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

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

राज्य टाइप ब्यौरा
currentFanSpeedSetting String

इससे availableFanSpeeds एट्रिब्यूट की मौजूदा स्पीड सेटिंग का इंटरनल नाम पता चलता है.
currentFanSpeedPercent Number

इससे पंखे की मौजूदा रफ़्तार का पता चलता है. अगर supportsFanSpeedPercent एट्रिब्यूट को true पर सेट किया जाता है, तो इस एट्रिब्यूट को शामिल करना ज़रूरी है

उदाहरण

लिविंग रूम में पंखे की स्पीड कितनी है?

{
  "currentFanSpeedSetting": "speed_low",
  "currentFanSpeedPercent": 10
}

डिवाइस के लिए उपलब्ध COMMANDS

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

action.devices.commands.SetFanSpeed

स्पीड सेट करें.

पैरामीटर

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

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

पैरामीटर टाइप ब्यौरा
fanSpeed String

ज़रूरी है.

पंखे की स्पीड की सेटिंग के लिए किया गया अनुरोध.

प्रतिशत के हिसाब से स्पीड सेट करें.

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

ज़रूरी है.

स्पीड सेटिंग का अनुरोध किया गया प्रतिशत.

उदाहरण

पंखे की स्पीड बढ़ा दो.

{
  "command": "action.devices.commands.SetFanSpeed",
  "params": {
    "fanSpeed": "speed_high"
  }
}

पंखे की स्पीड को 50% पर सेट करो.

{
  "command": "action.devices.commands.SetFanSpeed",
  "params": {
    "fanSpeedPercent": 50
  }
}

action.devices.commands.SetFanSpeedRelative

रिलेटिव स्पीड सेट करें.

इस निर्देश के लिए, इन एट्रिब्यूट की ज़रूरत होती है: 
{
  "commandOnlyFanSpeed": true
}

पैरामीटर

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

वज़न के हिसाब से स्पीड सेट करें.

पैरामीटर टाइप ब्यौरा
fanSpeedRelativeWeight Integer

ज़रूरी है.

इस वैल्यू से पता चलता है कि स्पीड में कितना बदलाव हुआ है. ऐब्सलूट वैल्यू से, स्केल की गई रकम का पता चलता है. वहीं, संख्या के साइन से, बदलाव की दिशा का पता चलता है.

प्रतिशत के हिसाब से, सापेक्षिक स्पीड सेट करें.

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

ज़रूरी है.

इस वैल्यू से, बदलाव की स्पीड के प्रतिशत के बारे में पता चलता है.

उदाहरण

पंखे की रफ़्तार थोड़ी कम करो.

{
  "command": "action.devices.commands.SetFanSpeedRelative",
  "params": {
    "fanSpeedRelativeWeight": -1
  }
}

पंखे की स्पीड को 10 प्रतिशत बढ़ाओ.

{
  "command": "action.devices.commands.SetFanSpeedRelative",
  "params": {
    "fanSpeedRelativePercent": 10
  }
}

action.devices.commands.Reverse

पंखे की दिशा बदल दो.

इस निर्देश के लिए, इन एट्रिब्यूट की ज़रूरत होती है: 
{
  "reversible": true
}

पैरामीटर

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

कोई प्रॉपर्टी नहीं

उदाहरण

पंखे की दिशा बदल दो.

{
  "command": "action.devices.commands.Reverse",
  "params": {}
}

सैंपल अटरेंस

de-DE

  • stell die Geschwindigkeit vom Ventilator auf hoch

en-US

  • drop the AC fan speed to medium

es-ES

  • cambia la velocidad del ventilador a medio

fr-FR

  • mets la ventilation au maximum

hi-IN

  • बेडरूम में पंखे की गति मीडियम करें

it-IT

  • metti il condizionatore in salotto a velocità media

ja-JP

  • エアコン の風量を 高速 にセット

ko-KR

  • 선풍기 강풍 으로 틀어 줘

nl-NL

  • zet de snelheid van de ventilator op medium

pt-BR

  • definir a velocidade do ventilador para baixa
  • põe a ventoinha no máximo

sv-SE

  • Ställ in fläkten på medel

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

गड़बड़ियों और अपवादों की पूरी सूची देखें.
  • maxSpeedReached: डिवाइस को पहले से ही सबसे ज़्यादा स्पीड पर सेट किया गया है.
  • minSpeedReached: डिवाइस की स्पीड पहले से ही सबसे कम पर सेट है.