স্মার্ট হোম নিরাপত্তা ব্যবস্থা নির্দেশিকা
action.devices.types.SECURITYSYSTEM - নিরাপত্তা ব্যবস্থা সক্রিয় এবং নিষ্ক্রিয় করা যায়। এগুলোকে একাধিক নিরাপত্তা স্তরে (যেমন, বাড়িতে এবং বাইরে) সক্রিয় করা যায় এবং এগুলো নির্দিষ্ট সেন্সর, যেমন গতি শনাক্তকারী সেন্সর বা খোলা জানালা সম্পর্কে তথ্য জানাতে পারে।
এই প্রকারটি নির্দেশ করে যে ডিভাইসটি নিরাপত্তা সিস্টেম আইকন এবং এর সাথে সম্পর্কিত কিছু সমার্থক ও বিকল্প নাম পায়।
ডিভাইসের ক্ষমতা
বাস্তবায়নের বিশদ বিবরণের জন্য, যেমন আপনার পরিষেবাতে কোন অ্যাট্রিবিউট ও স্টেটগুলো সমর্থন করা উচিত এবং কীভাবে EXECUTE ও QUERY প্রতিক্রিয়া তৈরি করতে হয়, তার জন্য সংশ্লিষ্ট ট্রেইট ডকুমেন্টেশন দেখুন।
প্রয়োজনীয় বৈশিষ্ট্য
আপনার ডিভাইসের জন্য প্রযোজ্য হলে, এই বৈশিষ্ট্য এবং কমান্ডগুলো আবশ্যক। যদি আপনার ডিভাইস এই বৈশিষ্ট্যগুলো সমর্থন না করে, তাহলে একটি QUERY বা EXECUTE রেসপন্সে functionNotSupported এরর কোডটি লিখুন। আরও তথ্যের জন্য এরর এবং এক্সেপশন দেখুন।
সুপারিশকৃত বৈশিষ্ট্য
আপনার ডিভাইসের জন্য প্রযোজ্য হলে এই বৈশিষ্ট্যগুলি সুপারিশ করা হয়। তবে, আপনার বিদ্যমান পণ্যের কার্যকারিতার সাথে সর্বোত্তমভাবে মেলানোর জন্য আপনি উপলব্ধ সমস্ত বৈশিষ্ট্য থেকে পছন্দমতো সমন্বয় করতে পারেন।
উদাহরণস্বরূপ ডিভাইস: সাধারণ নিরাপত্তা ব্যবস্থা
এই বিভাগে উপরে উল্লিখিত ডিভাইসের ধরন এবং বৈশিষ্ট্যগুলির উপর ভিত্তি করে একটি সাধারণ "নিরাপত্তা ব্যবস্থা"-র প্রতিনিধিত্বকারী উদাহরণ ইন্টেন্ট পেলোড রয়েছে। আপনি যদি আপনার বাস্তবায়নে বৈশিষ্ট্য যোগ বা অপসারণ করেন, তবে সেই পরিবর্তনগুলি প্রতিফলিত করার জন্য আপনার প্রতিক্রিয়াগুলিও সেই অনুযায়ী পরিবর্তন করুন।
নমুনা 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" } } ] } }
নমুনা কোয়েরি প্রতিক্রিয়া
{ "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" } ] } } } }
নমুনা EXECUTE কমান্ড
অস্ত্র নিষ্ক্রিয়করণ
কমান্ড প্যারামিটার সম্পর্কে অতিরিক্ত বিবরণের জন্য, 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 ট্রেইটের মাধ্যমে রিপোর্ট করা এক্সেপশন কোডের মাধ্যমে অতিরিক্ত প্রাসঙ্গিক তথ্য প্রদান করতে পারেন। এক্সেপশনগুলোকে ব্লকিং বা নন-ব্লকিং হিসেবে রিপোর্ট করা যেতে পারে।
- "SUCCESS" স্ট্যাটাস সহ রিপোর্ট করা নন-ব্লকিং এক্সেপশনগুলো নির্দেশ করে যে, এক্সেপশনটি আর্মিং বা ডিসআর্মিং-এ বাধা দেয়নি।
- "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"
}
}]
}]
}
}]
}{
"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"
}
]
}
}
]
}
}দ্বি-স্তরীয় প্রমাণীকরণের মাধ্যমে সজ্জিত হওয়া
যদি আপনার সিস্টেম চালু করার প্রক্রিয়ায় ব্যবহারকারীদের টু-ফ্যাক্টর অথেনটিকেশন ডায়ালগের মাধ্যমে পিন ইনপুট করতে হয়, তাহলে সক্রিয় ব্যতিক্রম (যেমন, যখন জানালা বা দরজা খোলা থাকে) থাকা অবস্থায় তারা সিস্টেমটি চালু করা চালিয়ে যেতে চান কিনা, তা আপনাকে অবশ্যই স্বীকার করতে হবে ।
এই পরিস্থিতিতে একটি পিন বা পাসফ্রেজ প্রবেশ করানোর পর একটি স্বীকৃতি জানানোর প্রয়োজন হতে পারে।
উদাহরণ: স্বীকৃতি চ্যালেঞ্জ
এই উদাহরণে দেখানো হয়েছে যে একজন ব্যবহারকারী নিরাপত্তা ব্যবস্থাটি সক্রিয় করার চেষ্টা করছেন, কিন্তু সামনের দরজাটি খোলা হিসেবে শনাক্ত হচ্ছে। ব্যবহারকারী স্বীকার করছেন যে সামনের দরজা খোলা থাকা সত্ত্বেও নিরাপত্তা ব্যবস্থাটি সক্রিয় হওয়া উচিত।
| ব্যবহারকারী | নিরাপত্তা ব্যবস্থা সক্রিয় করুন। |
| গুগল অ্যাসিস্ট্যান্ট | সামনের দরজা খোলা আছে। আপনি কি নিরাপত্তা ব্যবস্থাটি সক্রিয় করতে নিশ্চিত? |
| ব্যবহারকারী | হ্যাঁ। |
| গুগল অ্যাসিস্ট্যান্ট | ঠিক আছে, নিরাপত্তা ব্যবস্থাটি সক্রিয় করা হচ্ছে। |
প্রথম চালে, আপনার একটি ackNeeded চ্যালেঞ্জ দিয়ে জবাব দেওয়া উচিত।
{
"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": [
"123"
],
"status": "ERROR",
"errorCode": "challengeNeeded",
"challengeNeeded": {
"type": "ackNeeded"
},
"states": {
"isArmed": true,
"currentArmLevel": "L2",
"currentStatusReport": [
{
"blocking": false,
"priority": 0,
"statusCode": "doorOpen",
"deviceTarget": "456"
}
]
}
}
]
}
} গুগল থেকে আপনার কাছে পাঠানো পরবর্তী অনুরোধটিতে প্রাপ্তি ack ফলাফলটি থাকবে।
{
"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
}
}
]
}
}উদাহরণ: পিন এবং স্বীকৃতি চ্যালেঞ্জ
এই উদাহরণে দেখানো হয়েছে একজন ব্যবহারকারী পিন ইনপুট প্রয়োজন এমন নিরাপত্তা ব্যবস্থাটি সক্রিয় করার চেষ্টা করছেন। সিস্টেমটি শনাক্ত করে যে সামনের ও পেছনের জানালা খোলা আছে এবং সক্রিয়করণ প্রক্রিয়াটি এগিয়ে নিয়ে যাওয়ার জন্য ব্যবহারকারীকে সম্মতি জানাতে বলে।
| ব্যবহারকারী | হাত দূরে। |
| গুগল অ্যাসিস্ট্যান্ট | আপনার পিন কী? |
| ব্যবহারকারী | ১২৩৪। |
| গুগল অ্যাসিস্ট্যান্ট | মনে হচ্ছে সামনের ও পেছনের জানালা খোলা আছে। আপনি কি নিরাপত্তা ব্যবস্থাটি ‘অ্যাওয়ে’ মোডে সক্রিয় করা চালিয়ে যেতে নিশ্চিত? |
| ব্যবহারকারী | হ্যাঁ। |
| গুগল অ্যাসিস্ট্যান্ট | ঠিক আছে, নিরাপত্তা ব্যবস্থাটি দূরে সরিয়ে দেওয়া হচ্ছে। |
প্রথম চালে, আপনার একটি সাধারণ pinNeeded চ্যালেঞ্জ দিয়ে জবাব দেওয়া উচিত।
{ "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" } }] } }
এরপর গুগল প্রদত্ত পিনটি সহ একটি অনুরোধ পাঠায়। দ্বিতীয় ধাপটি সমর্থন করার জন্য, আপনাকে টার্গেট আর্ম লেভেল এবং ব্লকিং এক্সেপশন সহ বর্তমান স্ট্যাটাস রিপোর্টের মতো অতিরিক্ত তথ্যসহ একটি ackNeeded চ্যালেঞ্জের মাধ্যমে উত্তর দিতে হবে।
{ "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" } }] } }
গুগল থেকে আপনার কাছে পাঠানো পরবর্তী অনুরোধটিতে শুধুমাত্র প্রাপ্তি ack ফলাফলটি থাকবে, প্রথমবার দেওয়া পিনটি থাকবে না।
{ "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 } } ] } }