Smart Home ArmDisarm Trait Schema

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

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

डिवाइस की ATTRIBUTES

इस ट्रेट वाले डिवाइस, 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 बूलियन

ज़रूरी है.

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

डिवाइस के लिए उपलब्ध COMMANDS

इस सुविधा वाले डिवाइस, 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

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

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