स्मार्ट होम ऐक्शन बनाने का तरीका जानने की नई जगह, Google Home डेवलपर सेंटर में आपका स्वागत है. ध्यान दें: Actions कंसोल में कार्रवाइयां बनाना जारी रहेगा.

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

action.devices.traits.Modes - इस एट्रिब्यूट में किसी डिवाइस के लिए उपलब्ध सभी मोड और मोड से जुड़ी सेटिंग शामिल हैं.

यह विशेषता ऐसे किसी भी डिवाइस पर मौजूद है जिसमें "n-way" मोड की आर्बिट्रेरी संख्या है. हर मोड के लिए मोड और सेटिंग आर्बिट्रेरी हैं और हर डिवाइस या डिवाइस के टाइप के हिसाब से यूनीक हैं. हर मोड में कई सेटिंग हो सकती हैं, लेकिन एक बार में सिर्फ़ एक ही चुना जा सकता है. ड्रायर "दिल के निशान वाला", "सामान्य", और "ज़्यादा भारी काम" मोड में एक साथ नहीं हो सकता. ऐसी सेटिंग है जिसे आसानी से चालू या बंद किया जा सकता है, वह टॉगल विशेषता में है.

उदाहरण के लिए, किसी वॉशिंग मशीन में लोड साइज़ और तापमान की सेटिंग हो सकती हैं. ये दोनों मोड होंगे, क्योंकि वे एक-दूसरे से अलग होते हैं, लेकिन एक बार में सिर्फ़ एक स्थिति में हो सकते हैं. उपयोगकर्ता साफ़ तौर पर तापमान को सेट कर सकता है, जैसे कि वॉशर का तापमान को ठंडा करने के लिए सेट करो.

कुछ मोड "ऑर्डर" किए जाते हैं. साथ ही, इनमें ऊपर/नीचे के बदलाव करने की सुविधा भी होती है, और इससे व्यू की संख्या में बढ़ोतरी/कम हो सकती है. उदाहरण के लिए, लोड का साइज़ (छोटा, मीडियम, बड़ा) और तापमान साफ़ तौर पर ऑर्डर किया गया हो (ध्यान दें कि तापमान, अन्य डिवाइसों की तरह किसी टारगेट के मुकाबले वास्तविक तापमान नहीं है), लेकिन हो सकता है कि लोड का टाइप (डेलिकेट, सामान्य, ऊन वगैरह) न हो.

इस एट्रिब्यूट में एक या ज़्यादा ऐसे अलग-अलग मोड शामिल हैं जिन्हें उपयोगकर्ता सेट कर सकते हैं. आम तौर पर, इन मोड का इस्तेमाल उन कामों के लिए किया जाना चाहिए जो दूसरे डिवाइस के व्यवहार से अलग किए गए हैं. लिंक किए गए व्यवहार में, खास तरह के एट्रिब्यूट का इस्तेमाल किया जाना चाहिए. जैसे, डिवाइस को खुद चालू या बंद करना (उदाहरण के लिए, Trait Temperaturesetting में thermostatMode).

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

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

विशेषताएं Type जानकारी
availableModes रेंज

ज़रूरी है.

उपलब्ध मोड की सूची.

[item, ...] ऑब्जेक्ट

उपलब्ध मोड.

name String

ज़रूरी है.

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

name_values रेंज

ज़रूरी है.

हर उपलब्ध भाषा में मोड के समानार्थी शब्द.

[item, ...] ऑब्जेक्ट

दी गई भाषा में मोड के समानार्थी.

name_synonym रेंज

ज़रूरी है.

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

[item, ...] String

समानार्थी नाम.

lang String

ज़रूरी है.

भाषा कोड (ISO 639-1). इस्तेमाल की जा सकने वाली भाषाएं देखें.

settings रेंज

ज़रूरी है.

इस मोड के लिए इस्तेमाल की जा सकने वाली सेटिंग.

[item, ...] ऑब्जेक्ट

काम करने वाली सेटिंग.

कम से कम दो आइटम होने चाहिए.

setting_name String

ज़रूरी है.

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

setting_values रेंज

ज़रूरी है.

हर इस्तेमाल की जाने वाली भाषा में सेटिंग के समानार्थी शब्द.

[item, ...] ऑब्जेक्ट

दी गई भाषा में सेटिंग के समानार्थी शब्द.

setting_synonym रेंज

ज़रूरी है.

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

[item, ...] String

समानार्थी नाम.

lang String

ज़रूरी है.

भाषा कोड (ISO 639-1). इस्तेमाल की जा सकने वाली भाषाएं देखें.

ordered बूलियन

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

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

commandOnlyModes बूलियन

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

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

queryOnlyModes बूलियन

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

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

उदाहरण

कई मोड और सेटिंग वाला डिवाइस.

{
  "availableModes": [
    {
      "name": "load_mode",
      "name_values": [
        {
          "name_synonym": [
            "Load",
            "Size",
            "Load size"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "small_load",
          "setting_values": [
            {
              "setting_synonym": [
                "Small",
                "Half"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "medium_load",
          "setting_values": [
            {
              "setting_synonym": [
                "Medium",
                "Normal"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "large_load",
          "setting_values": [
            {
              "setting_synonym": [
                "Large",
                "Full"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": true
    },
    {
      "name": "temp_mode",
      "name_values": [
        {
          "name_synonym": [
            "Temperature",
            "Temp"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "hot_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "Hot",
                "White"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "warm_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "Warm",
                "Color"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "cold_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "Cold",
                "Delicate"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": false
    }
  ]
}

सिर्फ़ कमांड वाले डिवाइस.

{
  "availableModes": [
    {
      "name": "light_mode",
      "name_values": [
        {
          "name_synonym": [
            "Light",
            "Lighting"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "day_light",
          "setting_values": [
            {
              "setting_synonym": [
                "Day",
                "Bright"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "night_light",
          "setting_values": [
            {
              "setting_synonym": [
                "Night",
                "Dark"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "reading_light",
          "setting_values": [
            {
              "setting_synonym": [
                "Reading",
                "Ambiant"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": false
    }
  ],
  "commandOnlyModes": true,
  "queryOnlyModes": false
}

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

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

राज्य Type जानकारी
currentModeSettings ऑब्जेक्ट

ज़रूरी है.

कुंजी/वैल्यू का जोड़ा, डिवाइस के name मोड के साथ है और मौजूदा setting_name वैल्यू के तौर पर जोड़ा गया है.

<string> String

मौजूदा setting_name

उदाहरण

डिवाइस किस मोड में है?

{
  "currentModeSettings": {
    "load_mode": "small_load",
    "temp_mode": "cold_temp"
  }
}

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

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

action.devices.commands.SetModes

मोड सेटिंग अपडेट करें.

पैरामीटर

पैरामीटर Type जानकारी
updateModeSettings ऑब्जेक्ट

ज़रूरी है.

की/वैल्यू पेयर को डिवाइस के मोड name के साथ और नए setting_name को वैल्यू के तौर पर जोड़ा जाएगा.

<string> String

नया setting_name.

उदाहरण

ज़्यादा लोड पर सेट करें.

{
  "command": "action.devices.commands.SetModes",
  "params": {
    "updateModeSettings": {
      "load_mode": "large_load"
    }
  }
}

नमूने का उच्चारण

de-DE

  • Stelle den Staubsauger auf Ruhemodus

en-US

  • set the vacuum to energy saver mode

es-ES

  • pon la lavadora en modo frío

fr-FR

  • mets l'aspirateur en silencieux

hi-IN

  • वैक्यूम पर कार्पेट मोड लगाएं

it-IT

  • imposta l'aspirapolvere su silenzioso

ja-JP

  • 掃除機 静音 モードに設定して

ko-KR

  • 세탁기 세탁량 많음 으로 설정해

pt-BR

  • acionar a função autolimpeza do aspirador
  • ligar o modo de aquecimento

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

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