स्मार्ट होम ArmDisarm ट्रैट स्कीमा

action.devices.traits.ArmDisarm - इस ट्रैट की मदद से, सुरक्षा सिस्टम जैसे डिवाइसों को चालू और बंद किया जा सकता है.

जिन डिवाइसों में सुरक्षा के कई लेवल होते हैं उनके लिए, इन लेवल की जानकारी availableArmLevels एट्रिब्यूट की मदद से दी जानी चाहिए.

डिवाइस के एट्रिब्यूट

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

विशेषताएं	टाइप	ब्यौरा
availableArmLevels	ऑब्जेक्ट	डिवाइस पर काम करने वाले सुरक्षा लेवल के बारे में बताता है. अगर इस एट्रिब्यूट की वैल्यू सबमिट नहीं की जाती है, तो इसका मतलब है कि डिवाइस पर सिर्फ़ एक लेवल की सुविधा काम करती है.
levels	कलेक्शन	ज़रूरी है. डिवाइस पर उपलब्ध सुरक्षा लेवल की सूची.
[item, ...]	ऑब्जेक्ट	सुरक्षा का लेवल.
level_name	String	ज़रूरी है. सुरक्षा लेवल का इंटरनल नाम, जिसका इस्तेमाल निर्देशों और स्थितियों में किया जाता है. यह नाम, लोगों के लिए आसान नहीं हो सकता. साथ ही, यह सभी भाषाओं में शेयर किया जाता है.
level_values	कलेक्शन	ज़रूरी है. इसमें level_synonym और lang शामिल हैं.
[item, ...]	ऑब्जेक्ट	किसी भाषा के लिए लेवल का समानार्थी शब्द.
level_synonym	कलेक्शन	ज़रूरी है. इस्तेमाल की जा सकने वाली हर भाषा में, लेवल के लिए उपयोगकर्ता के हिसाब से नाम. पहले आइटम को कैननिकल नाम माना जाता है.
[item, ...]	String	समानार्थी शब्द का नाम.
lang	String	ज़रूरी है. लेवल के समानार्थी शब्दों के लिए भाषा कोड. इस्तेमाल की जा सकने वाली भाषाएं देखें.
ordered	बूलियन	ज़रूरी है. अगर इस विकल्प को 'सही है' पर सेट किया जाता है, तो लेवल कलेक्शन के क्रम में, बढ़ने/घटने के लॉजिक के लिए अतिरिक्त व्याकरण लागू होता है. उदाहरण के लिए, "Ok Google, मेरी सुरक्षा का लेवल एक बढ़ाओ" कहने पर, Assistant मौजूदा सुरक्षा लेवल का पता लगाती है और फिर उस लेवल को एक बढ़ा देती है. अगर यह वैल्यू 'गलत है' पर सेट है, तो बढ़ोतरी/कमी के लॉजिक के लिए अतिरिक्त व्याकरण काम नहीं करता.

उदाहरण

सुरक्षा सिस्टम, जिसमें दो अलग-अलग लेवल पर सुरक्षा चालू की जा सकती है

{
  "availableArmLevels": {
    "levels": [
      {
        "level_name": "L1",
        "level_values": [
          {
            "level_synonym": [
              "Home and Guarding",
              "SL1"
            ],
            "lang": "en"
          },
          {
            "level_synonym": [
              "Zuhause und Bewachen",
              "SL1"
            ],
            "lang": "de"
          }
        ]
      },
      {
        "level_name": "L2",
        "level_values": [
          {
            "level_synonym": [
              "Away and Guarding",
              "SL2"
            ],
            "lang": "en"
          },
          {
            "level_synonym": [
              "Weg und Bewachen",
              "SL2"
            ],
            "lang": "de"
          }
        ]
      }
    ],
    "ordered": true
  }
}

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

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

राज्य	टाइप	ब्यौरा
isArmed	बूलियन	ज़रूरी है. यह बताता है कि डिवाइस फ़िलहाल चालू है या नहीं.
currentArmLevel	String	ज़रूरी है. अगर availableArmLevels एट्रिब्यूट की वैल्यू दी गई है, तो इस एट्रिब्यूट की वैल्यू देना ज़रूरी है. अगर सुरक्षा के कई लेवल मौजूद हैं, तो मौजूदा सुरक्षा लेवल का नाम दिखाता है.
exitAllowance	Integer	इससे पता चलता है कि currentArmLevel लागू होने से पहले, उपयोगकर्ता को कितने सेकंड के लिए साइट छोड़नी होगी.

उदाहरण

अलग-अलग सुरक्षा लेवल की जानकारी देने वाला सुरक्षा सिस्टम

{
  "isArmed": true,
  "currentArmLevel": "L1"
}

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

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

action.devices.commands.ArmDisarm

इस डिवाइस के लिए अलार्म का लेवल सेट करें.

पैरामीटर

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

अलार्म चालू या बंद करने की कार्रवाई रद्द करना

पैरामीटर	टाइप	ब्यौरा
followUpToken	String	फ़ॉलो-अप जवाब के लिए, Google का दिया गया टोकन.
arm	बूलियन	ज़रूरी है. जब निर्देश 'चालू करें' हो, तो True. गलत को हटाने के लिए.
cancel	बूलियन	ज़रूरी है. arm वैल्यू को रद्द करने का निर्देश होने पर, यह वैल्यू 'सही' होती है.

सुरक्षा के लेवल के साथ, डिवाइस को चालू या बंद करें.

पैरामीटर	टाइप	ब्यौरा
followUpToken	String	फ़ॉलो-अप जवाब के लिए, Google का दिया गया टोकन.
arm	बूलियन	ज़रूरी है. जब निर्देश 'चालू करें' हो, तो True. गलत को हटाने के लिए.
armLevel	String	level_name को इस लेवल पर सेट करना है.

उदाहरण

सिस्टम को चालू करना

{
  "command": "action.devices.commands.ArmDisarm",
  "params": {
    "arm": true,
    "followUpToken": "123"
  }
}

सिस्टम को L1 पर सेट करना

{
  "command": "action.devices.commands.ArmDisarm",
  "params": {
    "arm": true,
    "armLevel": "L1",
    "followUpToken": "456"
  }
}

सेट करने की प्रोसेस रद्द करना

{
  "command": "action.devices.commands.ArmDisarm",
  "params": {
    "arm": true,
    "cancel": true
  }
}

मिलती-जुलती गड़बड़ियां

डिवाइस को चालू या बंद करने में कोई गड़बड़ी हुई.

इस्तेमाल की जा सकने वाली वैल्यू:

alreadyInState

deviceTampered

passphraseIncorrect

pinIncorrect

securityRestriction

tooManyFailedAttempts

userCancelled

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

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