स्मार्ट होम टॉगल की सुविधा के लिए ट्रेट स्कीमा

action.devices.traits.Toggles - यह ट्रेट उन डिवाइसों के लिए है जिनकी सेटिंग सिर्फ़ दो में से किसी एक स्थिति में हो सकती है.

ये सेटिंग, चालू/बंद या चालू/बंद की स्थिति वाले फ़िज़िकल बटन, एचटीएमएल में चेकबॉक्स या चालू/बंद किए गए किसी अन्य एलिमेंट के तौर पर दिख सकती हैं. अगर सेटिंग में दो से ज़्यादा स्थितियां हैं या ऐसी स्थिति है जिसमें बाइनरी विकल्पों में से कोई भी विकल्प नहीं चुना गया है, तो इसे Modes विशेषता के तौर पर बेहतर तरीके से दिखाया जा सकता है. यह मल्टी-स्टेट डायल, रेडियो बटन (फ़िज़िकल या एचटीएमएल) या ऐसी बाइनरी स्थितियों के बराबर होती है जो साफ़ तौर पर चालू/बंद नहीं होती हैं. उदाहरण के लिए, "AM/FM" या "गर्म/ठंडा".

इस विशेषता में एक या उससे ज़्यादा टॉगल शामिल होते हैं, जिन्हें उपयोगकर्ता सेट कर सकते हैं. आम तौर पर, इन टॉगल का इस्तेमाल ऐसी सुविधाओं के लिए किया जाना चाहिए जो डिवाइस के अन्य व्यवहारों से जुड़ी नहीं हैं. डिवाइस को चालू या बंद करने जैसी लिंक की गई कार्रवाइयों के लिए, ज़्यादा खास ट्रेट का इस्तेमाल किया जाना चाहिए. उदाहरण के लिए, ट्रेट TemperatureSetting में thermostatMode.

डिवाइस की ATTRIBUTES

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

विशेषताएं टाइप ब्यौरा
availableToggles ऐरे

ज़रूरी है.

उपलब्ध टॉगल की सूची.
[item, ...] ऑब्जेक्ट

उपलब्ध टॉगल.
name String

ज़रूरी है.

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

ज़रूरी है.

टॉगल के समानार्थी शब्द, हर उस भाषा में उपलब्ध हैं जिसमें यह सुविधा काम करती है.
[item, ...] ऑब्जेक्ट

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

ज़रूरी है.

टॉगल के समानार्थी शब्द. इस सूची में मौजूद पहली स्ट्रिंग का इस्तेमाल, उस भाषा में लेवल के कैननिकल नाम के तौर पर किया जाता है.
[item, ...] String

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

ज़रूरी है.

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

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

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

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

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

उदाहरण

एक से ज़्यादा टॉगल वाला डिवाइस.

{
  "availableToggles": [
    {
      "name": "sterilization_toggle",
      "name_values": [
        {
          "name_synonym": [
            "Clean",
            "Bio clean"
          ],
          "lang": "en"
        }
      ]
    },
    {
      "name": "energysaving_toggle",
      "name_values": [
        {
          "name_synonym": [
            "Energy saving",
            "Eco"
          ],
          "lang": "en"
        }
      ]
    }
  ]
}

सिर्फ़ निर्देश देने के लिए टॉगल वाले डिवाइस.

{
  "availableToggles": [
    {
      "name": "filter_toggle",
      "name_values": [
        {
          "name_synonym": [
            "Filtered",
            "Filter"
          ],
          "lang": "en"
        }
      ]
    }
  ],
  "commandOnlyToggles": true
}

सिर्फ़ क्वेरी करने की सुविधा वाले टॉगल वाला डिवाइस.

{
  "availableToggles": [
    {
      "name": "filter_toggle",
      "name_values": [
        {
          "name_synonym": [
            "Filtered",
            "Filter"
          ],
          "lang": "en"
        }
      ]
    }
  ],
  "queryOnlyToggles": true
}

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

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

राज्य टाइप ब्यौरा
currentToggleSettings ऑब्जेक्ट

ज़रूरी है.

की/वैल्यू पेयर. इसमें डिवाइस के टॉगल name को कुंजी के तौर पर और मौजूदा स्थिति को वैल्यू के तौर पर इस्तेमाल किया जाता है.
<string> बूलियन

टॉगल की मौजूदा स्थिति.

उदाहरण

क्या नसबंदी की सुविधा चालू है?

{
  "currentToggleSettings": {
    "sterilization_toggle": true,
    "energysaving_toggle": false
  }
}

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

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

action.devices.commands.SetToggles

टॉगल की स्थिति सेट करता है.

पैरामीटर

पैरामीटर टाइप ब्यौरा
updateToggleSettings ऑब्जेक्ट

ज़रूरी है.

की/वैल्यू पेयर में, डिवाइस के टॉगल name को कुंजी के तौर पर और नई स्थिति को वैल्यू के तौर पर इस्तेमाल किया जाता है.
<string> बूलियन

टॉगल का नया स्टेटस

उदाहरण

ऊर्जा की बचत करने वाली सुविधा चालू करें.

{
  "command": "action.devices.commands.SetToggles",
  "params": {
    "updateToggleSettings": {
      "energysaving_toggle": true
    }
  }
}

फ़िल्टर बंद करो.

{
  "command": "action.devices.commands.SetToggles",
  "params": {
    "updateToggleSettings": {
      "filter_toggle": false
    }
  }
}

सैंपल अटरेंस

de-DE

  • Bitte schalte Power Cool am Kühlschrank aus
  • stelle den Kühlschrank auf Power Cool

en-US

  • activate power freeze for the freezer
  • cancel power cool for the kitchen fridge

es-ES

  • pon el enfriamiento rápido en la nevera
  • quita el enfriamiento rápido

fr-FR

  • mets le mode power cool sur le réfrigérateur
  • Éteins le mode power freeze du réfrigérateur .

hi-IN

  • रेफ़्रिजरेटर का पावर कूल मोड बंद कर दो
  • रेफ़्रिजरेटर में पावर कूल मोड चालू करो

it-IT

  • disattiva il power freeze del freezer
  • imposta la funzione power freeze del surgelatore

ja-JP

  • 冷蔵庫 の 急速冷凍 つけて
  • 冷蔵庫 の 急速冷凍 を切ってくれる

ko-KR

  • 냉장고 급속 냉장 해제해
  • 냉장고 모드 급속 냉장 으로 바꿔

nl-NL

  • Zet de power cool uit op de koelkast
  • zet de koelkast op superkoelen

pt-BR

  • Ativa a função power freeze no congelador .
  • Desativa o bloqueio infantil do forno .
  • desligar o power cool da geladeira
  • iniciar o modo power freeze do freezer

sv-SE

  • Stäng av power cool i kylskåpet
  • sätt på power freeze på frysen

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

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