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

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, मेरा सुरक्षा लेवल 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 इंटेंट मैनेज करने के बारे में ज़्यादा जानने के लिए, इंटेंट पूरा करना देखें.

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

उदाहरण

आर्म लेवल की अलग-अलग जानकारी देने वाला सिक्योरिटी सिस्टम

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

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

जिन डिवाइसों पर इस एट्रिब्यूट का इस्तेमाल होता है वे 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

डिवाइस की गड़बड़ियां

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