स्मार्ट होम के लिए, ArmDisarm Trait का स्कीमा

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

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

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

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

एट्रिब्यूट टाइप ब्यौरा
availableArmLevels ऑब्जेक्ट

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

ज़रूरी है.

डिवाइस के लिए काम करने वाले सुरक्षा लेवल की सूची.
[item, ...] ऑब्जेक्ट

सुरक्षा का स्तर.
level_name String

ज़रूरी है.

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

ज़रूरी है.

इसमें level_synonym और lang शामिल हैं.
[item, ...] ऑब्जेक्ट

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

ज़रूरी है.

हर भाषा में, लेवल के लिए उपयोगकर्ता के हिसाब से आसान नाम. पहले आइटम को कैननिकल नाम माना जाता है.
[item, ...] String

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

ज़रूरी है.

लेवल के समानार्थी शब्दों के लिए भाषा कोड. इस्तेमाल की जा सकने वाली भाषाएं देखें.
ordered बूलियन

ज़रूरी है.

अगर इसे 'सही है' पर सेट किया जाता है, तो लेवल के ऐरे के क्रम में, बढ़ाने/घटाने की लॉजिक के लिए अतिरिक्त व्याकरण लागू होता है. उदाहरण के लिए, "Hey Google, मेरे सुरक्षा लेवल को 1 से बढ़ाओ" निर्देश देने पर, 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
  }
}

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

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

स्थितियां टाइप ब्यौरा
isArmed बूलियन

ज़रूरी है.

इससे पता चलता है कि डिवाइस फ़िलहाल चालू है या नहीं.
currentArmLevel String

ज़रूरी है.

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

इससे पता चलता है कि currentArmLevel लागू होने से पहले, उपयोगकर्ता के पास कितने सेकंड का समय है.

उदाहरण

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

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

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

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

action.devices.commands.ArmDisarm

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

पैरामीटर

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

डिवाइस को चालू या बंद करने की कार्रवाई रद्द करना

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

फ़ॉलो-अप जवाब के लिए, Google की ओर से दिया गया टोकन.
arm बूलियन

ज़रूरी है.

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

ज़रूरी है.

arm वैल्यू को रद्द करने का निर्देश देने पर, इसकी वैल्यू 'सही है' होती है.

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

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

फ़ॉलो-अप जवाब के लिए, Google की ओर से दिया गया टोकन.
arm बूलियन

ज़रूरी है.

डिवाइस को चालू करने का निर्देश देने पर, इसकी वैल्यू 'सही है' होती है. डिवाइस को बंद करने का निर्देश देने पर, इसकी वैल्यू 'गलत है' होती है.
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

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

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