ত্রুটি এবং ব্যতিক্রম

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

ত্রুটি

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

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

সারসংক্ষেপে:

• বৈশ্বিক-স্তরের ত্রুটি: প্রতিক্রিয়ার সমস্ত ডিভাইসে একই ত্রুটি রয়েছে
• স্থানীয় পর্যায়ের ত্রুটি: ত্রুটি এবং সফলতার ক্ষেত্রে মিশ্র প্রতিক্রিয়া

বৈশ্বিক-স্তরের ত্রুটি

নিম্নলিখিত JSON স্নিপেটটি দেখায় কিভাবে QUERY অথবা EXECUTE রেসপন্সে গ্লোবাল-লেভেলের ত্রুটি ফেরত দেওয়া যায়।

হাব অফলাইন থাকার কারণে সৃষ্ট গ্লোবাল-লেভেলের deviceOffline ত্রুটির একটি উদাহরণ:

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "errorCode": "deviceOffline",
    "status" : "ERROR"
  }
}

হাব আপডেট হওয়ার কারণে inSoftwareUpdate একটি বৈশ্বিক-স্তরের ত্রুটির উদাহরণ:

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "errorCode": "inSoftwareUpdate",
    "status" : "ERROR"
  }
}

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

কোয়েরি প্রতিক্রিয়া

নিম্নলিখিত JSON স্নিপেটটি দেখায় যে কীভাবে আপনি QUERY প্রতিক্রিয়ায় ডিভাইস-স্তরের ত্রুটিগুলি ফেরত দেবেন।

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "devices": {
      "device-id-1": {
        "errorCode": "deviceOffline",
        "status" : "ERROR"
      },
      "device-id-2": {
        "errorCode": "deviceOffline",
        "status" : "ERROR"
      }
    }
  }
}

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

নিম্নলিখিত JSON স্নিপেটটি দেখায় যে কীভাবে আপনি EXECUTE রেসপন্সে ডিভাইস-স্তরের ত্রুটিগুলি ফেরত দেবেন।

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "commands": [
      {
        "ids": [
          "device-id-1"
        ],
        "status": "ERROR",
        "errorCode": "deviceOffline"
      },
      {
        "ids": [
          "device-id-2"
        ],
        "status": "SUCCESS",
        "states": {
          "on": true,
          "online": true
        }
      }
    ]
  }
}

ত্রুটি সহ বিজ্ঞপ্তি

সক্রিয় বিজ্ঞপ্তি

নিম্নলিখিত JSON স্নিপেটটি দেখায় যে কীভাবে আপনি একটি প্রোঅ্যাকটিভ নোটিফিকেশনে ডিভাইস-স্তরের ত্রুটিগুলি রিপোর্ট করবেন।

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "agentUserId": "agent-user-id-1",
  "eventId": "unique-event-id-1",
  "payload": {
    "devices": {
      "notifications": {
        "device-id-1": {
          "RunCycle": {
            "priority": 0,
            "status": "FAILURE",
            "errorCode": "deviceDoorOpen"
          }
        }
      }
    }
  }
}

পরবর্তী প্রতিক্রিয়া

নিম্নলিখিত JSON স্নিপেটটি দেখায় যে আপনি একটি ফলো-আপ প্রতিক্রিয়ায় কীভাবে ডিভাইস-স্তরের ত্রুটিগুলি রিপোর্ট করবেন।

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "agentUserId": "agent-user-id-1",
  "eventId": "unique-event-id-1",
  "payload": {
    "devices": {
      "notifications": {
        "device-id-1": {
          "LockUnlock": {
            "priority": 0,
            "followUpResponse": {
              "status": "FAILURE",
              "errorCode": "deviceJammingDetected",
              "followUpToken": "PLACEHOLDER"
            }
          }
        }
      }
    }
  }
}

ত্রুটির তালিকা

নিম্নলিখিত ত্রুটিগুলির ফলে ডিভাইসে সংশ্লিষ্ট টিটিএস (TTS) প্রদর্শিত হবে।

অনলাইন এবং অফলাইন রাজ্য প্রতিবেদন

"requestId": "test-request-id",
  "agentUserId": "agent-user-1",
    "payload":{
      "devices": {
        "states": {
          "device-id-1": {
            "brightness": 65,
            "on": true,
            "online": true
          }
          "notifications": {},
        }
      }
    }

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "commands": [{
      "ids": ["device-id-1"],
      "status": "SUCCESS",
      "states": {
        "on": true,
        "online": true,
        "isLocked": true,
        "isJammed": false,
        "exceptionCode": "lowBattery"
      }
    }]
  }
}

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "commands": [{
      "ids": ["device-id-1"],
      "status": "SUCCESS",
      "states": {
        "on": true,
        "online": true,
        "isArmed": true,
        "currentArmLevel": "L2",
        "currentStatusReport": [{
          "blocking": false,
          "deviceTarget": "sensor_id1",
          "priority": 0,
          "statusCode": "deviceOpen"
        }]
      }
    }]
  }
}

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "devices": {
      "device-id-1": {
        "on": true,
        "online": true,
        "status": "EXCEPTIONS",
        "currentStatusReport": [{
            "blocking": true,
            "deviceTarget": "device-id-1",
            "priority": 0,
            "statusCode": "lowBattery"
          },
          {
            "blocking": true,
            "deviceTarget": "front_window_id",
            "priority": 1,
            "statusCode": "deviceOpen"
          },
          {
            "blocking": true,
            "deviceTarget": "back_window_id",
            "priority": 1,
            "statusCode": "deviceOpen"
          }
        ]
      }
    }
  }
}