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

action.devices.traits.ArmDisarm - यह विशेषता सुरक्षा और हथियारों के लिए इस्तेमाल की जाती है, जैसे कि सुरक्षा सिस्टम.

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

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

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

विशेषताएं	Type	जानकारी
availableArmLevels	ऑब्जेक्ट	इससे, डिवाइस के सुरक्षा लेवल के बारे में जानकारी मिलती है. अगर इस एट्रिब्यूट की शिकायत नहीं की जाती है, तो डिवाइस पर सिर्फ़ एक लेवल काम कर सकता है.
levels	रेंज	ज़रूरी है. डिवाइस पर काम करने वाले उपलब्ध सुरक्षा लेवल की सूची.
[item, ...]	ऑब्जेक्ट	सुरक्षा का लेवल.
level_name	String	ज़रूरी है. उस सुरक्षा स्तर का आंतरिक नाम जिसका इस्तेमाल निर्देशों और स्थितियों में किया जाता है. यह नाम उपयोगकर्ताओं के लिए सही नहीं हो सकता और इसे सभी भाषाओं में शेयर किया जाता है.
level_values	रेंज	ज़रूरी है. इसमें level_synonym और lang शामिल हैं.
[item, ...]	ऑब्जेक्ट	दी गई भाषा के लिए समानार्थी शब्द.
level_synonym	रेंज	ज़रूरी है. हर भाषा के लिए, लेवल के हिसाब से आसान नाम. पहले आइटम को कैननिकल नाम माना जाता है.
[item, ...]	String	समानार्थी नाम.
lang	String	ज़रूरी है. समानार्थी लेवल के लिए भाषा कोड. इस्तेमाल की जा सकने वाली भाषाएं देखें.
ordered	बूलियन	ज़रूरी है. अगर इसे 'सही है' पर सेट किया जाता है, तो लेवल को बढ़ाने और कम करने के लिए, तर्क के क्रम में अतिरिक्त व्याकरण लागू होता है. उदाहरण के लिए, "Ok 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
  }
}

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

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

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

उदाहरण

ऐसा सुरक्षा सिस्टम जो अलग-अलग आर्म लेवल की रिपोर्ट करता हो

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

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

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

action.devices.commands.ArmDisarm

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

पैरामीटर

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

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

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

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

पैरामीटर	Type	जानकारी
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

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

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