स्मार्ट होम आर्म डिसआर्म ट्रैट स्कीमा

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 बूलियन

ज़रूरी है.

सही, जब निर्देश देना हो. गलत को हटाने के लिए.
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

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

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