स्मार्ट होम लॉक गाइड

action.devices.types.LOCK - लॉक, लॉक, अनलॉक, और लॉक स्थिति की रिपोर्ट कर सकता है.

इससे पता चलता है कि डिवाइस को लॉक आइकॉन और इससे जुड़े कुछ समानार्थी शब्द और उपनाम मिल जाते हैं.

डिवाइस की क्षमताएं

लागू करने के बारे में जानकारी के लिए, उससे जुड़े Trait दस्तावेज़ देखें. जैसे, एट्रिब्यूट और कहा जाता है कि आपकी सेवा में किन सुविधाओं का इस्तेमाल किया जाना चाहिए. साथ ही, EXECUTE और QUERY रिस्पॉन्स बनाने का तरीका भी देखें.

ज़रूरी traits

अगर आपके डिवाइस पर लागू हो, तो ये विशेषताएं और निर्देश ज़रूरी हैं. अगर आपके डिवाइस पर ये सुविधाएं काम नहीं करती हैं, तो QUERY या EXECUTE रिस्पॉन्स में functionNotSupported का गड़बड़ी कोड डालें. ज़्यादा जानकारी के लिए गड़बड़ियां और अपवाद देखें.

क्वालिटी के लिए ज़रूरी शर्तें

  • इंतज़ार का समय: 2000 मि.से. या इससे कम होना चाहिए.
  • विश्वसनीयता: 97% या इससे ज़्यादा होना चाहिए.

डिवाइस का उदाहरण: सामान्य लॉक

इस सेक्शन में, उदाहरण के तौर पर दिए गए इंटेंट पेलोड शामिल हैं. इनमें डिवाइस के टाइप और ऊपर बताई गई विशेषताओं के आधार पर, सामान्य "लॉक करें" को दिखाया गया है. अगर लागू करने की प्रक्रिया में एट्रिब्यूट जोड़े या हटाए जाते हैं, तो उन बदलावों को दिखाने के लिए अपने जवाबों में बदलाव करें.

सिंक के जवाब का नमूना

अनुरोध करें
{
  "requestId": "6894439706274654512",
  "inputs": [
    {
      "intent": "action.devices.SYNC"
    }
  ]
}
जवाब
{
  "requestId": "6894439706274654512",
  "payload": {
    "agentUserId": "user123",
    "devices": [
      {
        "id": "123",
        "type": "action.devices.types.LOCK",
        "traits": [
          "action.devices.traits.LockUnlock"
        ],
        "name": {
          "name": "Simple lock"
        },
        "willReportState": true,
        "deviceInfo": {
          "manufacturer": "smart-home-inc",
          "model": "hs1234",
          "hwVersion": "3.2",
          "swVersion": "11.4"
        }
      }
    ]
  }
}

क्वेरी के जवाब का उदाहरण

अनुरोध करें
{
  "requestId": "6894439706274654514",
  "inputs": [
    {
      "intent": "action.devices.QUERY",
      "payload": {
        "devices": [
          {
            "id": "123"
          }
        ]
      }
    }
  ]
}
जवाब
{
  "requestId": "6894439706274654514",
  "payload": {
    "devices": {
      "123": {
        "status": "SUCCESS",
        "online": true,
        "isLocked": true,
        "isJammed": false
      }
    }
  }
}

EXECUTE के निर्देशों का उदाहरण

LockUnlock

कमांड पैरामीटर के बारे में ज़्यादा जानकारी के लिए, action.devices.traits.LockUnlock रेफ़रंस देखें.

अनुरोध करें
{
  "requestId": "6894439706274654516",
  "inputs": [
    {
      "intent": "action.devices.EXECUTE",
      "payload": {
        "commands": [
          {
            "devices": [
              {
                "id": "123"
              }
            ],
            "execution": [
              {
                "command": "action.devices.commands.LockUnlock",
                "params": {
                  "lock": true
                }
              }
            ]
          }
        ]
      }
    }
  ]
}
जवाब
{
  "requestId": "6894439706274654516",
  "payload": {
    "commands": [
      {
        "ids": [
          "123"
        ],
        "status": "SUCCESS",
        "states": {
          "online": true,
          "isLocked": true,
          "isJammed": false
        }
      }
    ]
  }
}

डिवाइस ERRORS

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