স্মার্ট হোম সিকিউরিটি সিস্টেম গাইড

action.devices.types.SECURITYSYSTEM - নিরাপত্তা ব্যবস্থা সশস্ত্র এবং নিরস্ত্র করা যেতে পারে। তারা একাধিক নিরাপত্তা স্তরে সশস্ত্র হতে পারে (উদাহরণস্বরূপ, বাড়িতে এবং দূরে) এবং তারা নির্দিষ্ট সেন্সর সম্পর্কে তথ্য রিপোর্ট করতে পারে, যেমন একটি সেন্সর যা গতি বা খোলা উইন্ডো সনাক্ত করে।

এই ধরনের নির্দেশ করে যে ডিভাইসটি সিকিউরিটি সিস্টেম আইকন এবং কিছু সম্পর্কিত প্রতিশব্দ এবং উপনাম পায়।

ডিভাইসের ক্ষমতা

বাস্তবায়নের বিশদ বিবরণের জন্য সংশ্লিষ্ট বৈশিষ্ট্যের ডকুমেন্টেশন পড়ুন, যেমন বৈশিষ্ট্য এবং স্টেট যা আপনার পরিষেবাকে সমর্থন করা উচিত এবং কীভাবে EXECUTE এবং QUERY প্রতিক্রিয়া তৈরি করা যায়।

প্রয়োজনীয় বৈশিষ্ট্য

আপনার ডিভাইসে প্রযোজ্য হলে এই বৈশিষ্ট্য এবং আদেশগুলি প্রয়োজন৷ যদি আপনার ডিভাইস এই বৈশিষ্ট্যগুলিকে সমর্থন না করে, তাহলে একটি QUERY বা EXECUTE প্রতিক্রিয়াতে functionNotSupported ত্রুটি কোডটি লিখুন৷ আরো তথ্যের জন্য ত্রুটি এবং ব্যতিক্রম দেখুন.

এই বৈশিষ্ট্যগুলি সুপারিশ করা হয়, যদি আপনার ডিভাইসে প্রযোজ্য হয়। যাইহোক, আপনি আপনার বিদ্যমান পণ্য কার্যকারিতার সাথে সর্বোত্তম মেলানোর জন্য সমস্ত উপলব্ধ বৈশিষ্ট্যগুলিকে মিশ্রিত করতে এবং মেলাতে মুক্ত।

গুণমানের প্রয়োজনীয়তা

  • লেটেন্সি: 2000ms এর কম বা সমান হতে হবে।
  • নির্ভরযোগ্যতা: 97% এর বেশি বা সমান হতে হবে।

উদাহরণ ডিভাইস: সাধারণ নিরাপত্তা ব্যবস্থা

এই বিভাগে উপরের ডিভাইসের ধরন এবং বৈশিষ্ট্যের উপর ভিত্তি করে একটি সাধারণ "নিরাপত্তা সিস্টেম" প্রতিনিধিত্বকারী ইন্টেন্ট পেলোডের উদাহরণ রয়েছে। আপনি যদি আপনার বাস্তবায়নে বৈশিষ্ট্যগুলি যোগ করেন বা মুছে ফেলেন তবে সেই পরিবর্তনগুলি প্রতিফলিত করতে আপনার প্রতিক্রিয়াগুলিকে সেই অনুযায়ী সংশোধন করুন৷

নমুনা SYNC প্রতিক্রিয়া

অনুরোধ 
{
  "requestId": "6894439706274654512",
  "inputs": [
    {
      "intent": "action.devices.SYNC"
    }
  ]
}
প্রতিক্রিয়া 
{
  "requestId": "6894439706274654512",
  "payload": {
    "agentUserId": "user123",
    "devices": [
      {
        "id": "123",
        "type": "action.devices.types.SECURITYSYSTEM",
        "traits": [
          "action.devices.traits.StatusReport",
          "action.devices.traits.ArmDisarm"
        ],
        "name": {
          "name": "Simple security system"
        },
        "willReportState": true,
        "attributes": {
          "availableArmLevels": {
            "levels": [
              {
                "level_name": "home_key",
                "level_values": [
                  {
                    "level_synonym": [
                      "Home and Guarding",
                      "level 1",
                      "home",
                      "SL1"
                    ],
                    "lang": "en"
                  }
                ]
              },
              {
                "level_name": "away_key",
                "level_values": [
                  {
                    "level_synonym": [
                      "Away and Guarding",
                      "level 2",
                      "away",
                      "SL2"
                    ],
                    "lang": "en"
                  }
                ]
              }
            ],
            "ordered": true
          }
        },
        "deviceInfo": {
          "manufacturer": "smart-home-inc",
          "model": "hs1234",
          "hwVersion": "3.2",
          "swVersion": "11.4"
        }
      }
    ]
  }
}

নমুনা QUERY উত্তর

অনুরোধ 
{
  "requestId": "6894439706274654514",
  "inputs": [
    {
      "intent": "action.devices.QUERY",
      "payload": {
        "devices": [
          {
            "id": "123"
          }
        ]
      }
    }
  ]
}
প্রতিক্রিয়া 
{
  "requestId": "6894439706274654514",
  "payload": {
    "devices": {
      "123": {
        "status": "SUCCESS",
        "online": true,
        "isArmed": true,
        "currentArmLevel": "home_key",
        "currentStatusReport": [
          {
            "blocking": false,
            "deviceTarget": "123",
            "priority": 0,
            "statusCode": "lowBattery"
          }
        ]
      }
    }
  }
}

স্যাম্পল এক্সিকিউটি কমান্ড

অস্ত্রশস্ত্র

কমান্ড প্যারামিটারের অতিরিক্ত বিবরণের জন্য, action.devices.traits.ArmDisarm রেফারেন্স দেখুন।

অনুরোধ 
{
  "requestId": "6894439706274654516",
  "inputs": [
    {
      "intent": "action.devices.EXECUTE",
      "payload": {
        "commands": [
          {
            "devices": [
              {
                "id": "123"
              }
            ],
            "execution": [
              {
                "command": "action.devices.commands.ArmDisarm",
                "params": {
                  "arm": true,
                  "armLevel": "away_key"
                }
              }
            ]
          }
        ]
      }
    }
  ]
}
প্রতিক্রিয়া 
{
  "requestId": "6894439706274654516",
  "payload": {
    "commands": [
      {
        "ids": [
          "123"
        ],
        "status": "SUCCESS",
        "states": {
          "online": true,
          "isArmed": true,
          "currentArmLevel": "away_key"
        }
      }
    ]
  }
}

ডিভাইসের ত্রুটি৷

ত্রুটি এবং ব্যতিক্রমগুলির সম্পূর্ণ তালিকা দেখুন।

সশস্ত্র ব্যতিক্রমগুলি রিপোর্ট করুন

সিস্টেমকে সশস্ত্র বা নিরস্ত্র করার চেষ্টা করার সময়, আপনি ব্যতিক্রম কোডগুলির মাধ্যমে অতিরিক্ত প্রসঙ্গ প্রদান করতে পারেন যা আপনি StatusReport বৈশিষ্ট্যের মাধ্যমে রিপোর্ট করেন। ব্যতিক্রমগুলি ব্লকিং বা অ-ব্লকিং হিসাবে রিপোর্ট করা যেতে পারে।

  • "সাফল্য" স্ট্যাটাসের সাথে রিপোর্ট করা নন-ব্লকিং ব্যতিক্রমগুলি ইঙ্গিত দেয় যে ব্যতিক্রম অস্ত্র বা নিরস্ত্রীকরণ প্রতিরোধ করেনি।
  • একটি "EXCEPTIONS" স্ট্যাটাস সহ রিপোর্ট করা ব্লকিং ব্যতিক্রমগুলি নির্দেশ করে যে এই ব্যতিক্রমগুলির কারণে অস্ত্র বা নিরস্ত্রীকরণ বন্ধ করা হয়েছে৷

ব্যতিক্রম কোড যা সাধারণত নিরাপত্তা ব্যবস্থার সাথে যুক্ত থাকে সেগুলির মধ্যে রয়েছে:

  • doorOpen : একটি দরজা খোলা আছে।
  • windowOpen : একটি উইন্ডো খোলা আছে।
  • isOpen : একটি সেন্সর সনাক্ত করে যে কিছু খোলা আছে (কিন্তু এটি একটি দরজা বা জানালা কিনা তা জানে না)।

উদাহরণ: নন-ব্লকিং ব্যতিক্রম

এই উদাহরণটি একটি নন-ব্লকিং ব্যতিক্রম দেখায় যেখানে একটি উইন্ডো খোলা হিসাবে রিপোর্ট করা হলেও নিরাপত্তা ব্যবস্থা সশস্ত্র।

ব্যবহারকারী নিরাপত্তা ব্যবস্থাকে উচ্চ নিরাপত্তায় সেট করুন।
গুগল সহকারী ঠিক আছে, সামনের জানালা খোলা। নিরাপত্তা ব্যবস্থাকে উচ্চ নিরাপত্তায় সজ্জিত করা।
অনুরোধ 
{
    "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
    "inputs": [{
      "intent": "action.devices.EXECUTE",
      "payload": {
        "commands": [{
          "devices": [{
            "id": "123"
          }],
          "execution": [{
            "command": "action.devices.commands.ArmDisarm",
            "params": {
              "arm": true,
              "armLevel": "L2"
            }
          }]
        }]
      }
    }]
  }
প্রতিক্রিয়া 
{
    "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
    "payload": {
      "commands": [
        {
          "ids": [
            "123"
          ],
          "status": "SUCCESS",
          "states": {
            "online": true,
            "isArmed": true,
            "currentArmLevel": "L2",
            "currentStatusReport": [
              {
                "blocking": false,
                "priority": 0,
                "statusCode": "windowOpen",
                "deviceTarget": "sensor_id1"
              }
            ]
          }
        }
      ]
    }
  }

উদাহরণ: ব্লকিং ব্যতিক্রম

ব্যবহারকারী নিরাপত্তা ব্যবস্থাকে উচ্চ নিরাপত্তায় সেট করুন।
গুগল সহকারী নিরাপত্তা ব্যবস্থা নিয়ন্ত্রণে একটি ত্রুটি ছিল৷ সামনের জানালা খোলা।
অনুরোধ 
{
    "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
    "inputs": [{
      "intent": "action.devices.EXECUTE",
      "payload": {
        "commands": [{
          "devices": [{
            "id": "123"
          }],
          "execution": [{
            "command": "action.devices.commands.ArmDisarm",
            "params": {
              "arm": true,
              "armLevel": "L2"
            }
          }]
        }]
      }
    }]
  }
প্রতিক্রিয়া 2 
{
    "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
    "payload": {
      "commands": [
        {
          "ids": [
            "123"
          ],
          "status": "EXCEPTIONS",
          "states": {
            "online": true,
            "isArmed": false,
            "currentArmLevel": "L2",
            "currentStatusReport": [
              {
                "blocking": true,
                "priority": 0,
                "statusCode": "windowOpen",
                "deviceTarget": "sensor_id1"
              }
            ]
          }
        }
      ]
    }
  }

দ্বি-ফ্যাক্টর প্রমাণীকরণের সাথে সশস্ত্র

যদি আপনার আর্মিং প্রবাহের জন্য ব্যবহারকারীদের একটি দ্বি-ফ্যাক্টর প্রমাণীকরণ ডায়ালগের মাধ্যমে একটি পিন ইনপুট করার প্রয়োজন হয়, তাহলে আপনাকে অবশ্যই স্বীকার করতে হবে যে সক্রিয় ব্যতিক্রমগুলি থাকলে (উদাহরণস্বরূপ, যখন একটি জানালা বা দরজা খোলা থাকে) তারা সিস্টেমটিকে সশস্ত্র করা চালিয়ে যেতে চায় কিনা।

এই দৃশ্যের জন্য একটি PIN বা পাসফ্রেজ এন্ট্রি উভয়েরই প্রয়োজন হতে পারে, তারপরে একটি স্বীকৃতি।

উদাহরণ: স্বীকৃতি চ্যালেঞ্জ

এই উদাহরণটি দেখায় যে একজন ব্যবহারকারী নিরাপত্তা ব্যবস্থাকে সজ্জিত করার চেষ্টা করছেন, কিন্তু সামনের দরজা খোলা হিসাবে সনাক্ত করা হয়েছে। ব্যবহারকারী স্বীকার করেন যে সামনের দরজা খোলা থাকলেও নিরাপত্তা ব্যবস্থা সশস্ত্র হওয়া উচিত।

ব্যবহারকারী নিরাপত্তা ব্যবস্থা সজ্জিত করুন।
গুগল সহকারী সদর দরজা খোলা। আপনি কি নিশ্চিত আপনি নিরাপত্তা ব্যবস্থা সজ্জিত করতে চান?
ব্যবহারকারী হ্যাঁ।
গুগল সহকারী ঠিক আছে, নিরাপত্তা ব্যবস্থা সশস্ত্র করা।

প্রথম পালা, আপনি একটি ackNeeded চ্যালেঞ্জ সঙ্গে প্রতিক্রিয়া করা উচিত.

অনুরোধ 1 
{
    "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
    "inputs": [{
      "intent": "action.devices.EXECUTE",
      "payload": {
        "commands": [{
          "devices": [{
            "id": "123"
          }],
          "execution": [{
            "command": "action.devices.commands.ArmDisarm",
            "params": {
              "arm": true
            }
          }]
        }]
      }
    }]
  }
প্রতিক্রিয়া 2
{
    "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
    "payload": {
      "commands": [
        {
          "ids": [
            "123"
          ],
          "status": "ERROR",
          "errorCode": "challengeNeeded",
          "challengeNeeded": {
            "type": "ackNeeded"
          },
          "states": {
            "isArmed": true,
            "currentArmLevel": "L2",
            "currentStatusReport": [
              {
                "blocking": false,
                "priority": 0,
                "statusCode": "doorOpen",
                "deviceTarget": "456"
              }
            ]
          }
        }
      ]
    }
  }

আপনার কাছে Google থেকে পরবর্তী অনুরোধে ack ফলাফল থাকবে।

অনুরোধ 2 
{
    "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
    "inputs": [{
      "intent": "action.devices.EXECUTE",
      "payload": {
        "commands": [{
          "devices": [{
            "id": "123"
          }],
          "execution": [{
            "command": "action.devices.commands.ArmDisarm",
            "params": {
              "arm": true
            },
            "challenge": {
              "ack": true
            }
          }]
        }]
      }
    }]
  }
প্রতিক্রিয়া 
{
    "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
    "payload": {
      "commands": [
        {
          "ids": [
            "123"
          ],
          "status": "SUCCESS",
          "states": {
            "isArmed": true
          }
        }
      ]
    }
  }

উদাহরণ: পিন এবং স্বীকৃতি চ্যালেঞ্জ

এই উদাহরণটি দেখায় যে একজন ব্যবহারকারী পিন ইনপুটের প্রয়োজনে নিরাপত্তা ব্যবস্থাকে সজ্জিত করার চেষ্টা করছেন। সিস্টেম শনাক্ত করে যে সামনের এবং পিছনের জানালাগুলি খোলা আছে এবং ব্যবহারকারীকে স্বীকার করতে বলে যে অস্ত্র দেওয়া উচিত।

ব্যবহারকারী দূরে হাত.
গুগল সহকারী আপনার পিন কি?
ব্যবহারকারী 1234।
গুগল সহকারী মনে হচ্ছে সামনের জানালা এবং পিছনের জানালা খোলা। আপনি কি নিশ্চিত যে আপনি নিরাপত্তা ব্যবস্থাকে দূরে রাখা চালিয়ে যেতে চান?
ব্যবহারকারী হ্যাঁ।
গুগল সহকারী ঠিক আছে, নিরাপত্তা ব্যবস্থাকে দূরে সরিয়ে দিন

প্রথম দিকে, আপনাকে একটি স্ট্যান্ডার্ড pinNeeded চ্যালেঞ্জের সাথে সাড়া দিতে হবে।

অনুরোধ 1 
{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "inputs": [{
    "intent": "action.devices.EXECUTE",
    "payload": {
      "commands": [{
        "devices": [{
          "id": "123"
        }],
        "execution": [{
          "command": "action.devices.commands.ArmDisarm",
          "params": {
            "arm": true
          }
        }]
      }]
    }
  }]
}
প্রতিক্রিয়া
{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "commands": [{
      "ids": ["456"],
      "status": "ERROR",
      "errorCode": "challengeNeeded",
      "challengeNeeded": {
        "type": "pinNeeded"
      }
    }]
  }
}

Google তারপর প্রদত্ত পিন সম্বলিত একটি অনুরোধের সাথে অনুসরণ করে। দ্বিতীয় মোড়কে সমর্থন করার জন্য, আপনাকে অতিরিক্ত তথ্য সহ একটি ackNeeded চ্যালেঞ্জের সাথে সাড়া দিতে হবে, যার মধ্যে টার্গেট আর্ম লেভেল এবং ব্লকিং ব্যতিক্রম সহ বর্তমান অবস্থা রিপোর্ট।

অনুরোধ 2 
{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "inputs": [{
    "intent": "action.devices.EXECUTE",
    "payload": {
      "commands": [{
        "devices": [...],
        "execution": [{
          "command": "action.devices.commands.ArmDisarm",
          "params": {
            "arm": true,
            "armLevel": "away"
          },
          "challenge": {
            "pin": "1234"
          }
        }]
      }]
    }
  }]
}
প্রতিক্রিয়া
{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "commands": [{
      "ids": ["456"],
      "status": "ERROR",
      "states": {
        "targetArmLevel": "away",
        "currentStatusReport": [{
            "blocking": true,
            "priority": 1,
            "deviceTarget": "front_window_id",
            "statusCode": "deviceOpen"
          },
          {
            "blocking": true,
            "priority": 1,
            "deviceTarget": "back_window_id",
            "statusCode": "deviceOpen"
          }
        ]
      },
      "errorCode": "challengeNeeded",
      "challengeNeeded": {
        "type": "ackNeeded"
      }
    }]
  }
}

আপনার কাছে Google থেকে পরবর্তী অনুরোধে শুধুমাত্র ack ফলাফল থাকবে, প্রথম বারে দেওয়া পিন নয়।

অনুরোধ 3 
{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "inputs": [{
    "intent": "action.devices.EXECUTE",
    "payload": {
      "commands": [{
        "devices": [...],
        "execution": [{
          "command": "action.devices.commands.ArmDisarm",
          "params": {
            "arm": true,
            "armLevel": "away"
          },
          "challenge": {
            "ack": true
          }
        }]
      }]
    }
  }]
}
প্রতিক্রিয়া
{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "commands": [
      {
        "ids": [
          "123"
        ],
        "status": "SUCCESS",
        "states": {
          "isArmed": true
        }
      }
    ]
  }
}