-

ক্যামেরা ইভেন্ট ইমেজ স্কিমা

Nest Cam Indoor Nest Hub Max Nest Doorbell (উত্তরাধিকার)

sdm.devices.traits.CameraEventImage

এই বৈশিষ্ট্যটি যে কোনও ডিভাইসের অন্তর্গত যা ইভেন্ট থেকে ছবি তৈরি করতে সহায়তা করে।

ক্ষেত্র

এই বৈশিষ্ট্যের জন্য কোন ক্ষেত্র উপলব্ধ নেই।

কমান্ড

ইমেজ তৈরি করুন

একটি ক্যামেরা ছবি ডাউনলোড করার জন্য একটি URL প্রদান করে।

এই কমান্ড নিম্নলিখিত ইভেন্ট সমর্থন করে:

টাইপ উপাদান বর্ণনা
ঘটনা ক্যামেরামোশন বৈশিষ্ট্যের মোশন ইভেন্ট গতি ক্যামেরা দ্বারা সনাক্ত করা হয়েছে.
ঘটনা ক্যামেরাপারসন বৈশিষ্ট্যের ব্যক্তি ঘটনা ক্যামেরায় একজনকে শনাক্ত করা হয়েছে।
ঘটনা ক্যামেরাসাউন্ড বৈশিষ্ট্যের শব্দ ইভেন্ট ক্যামেরায় শব্দ শনাক্ত করা হয়েছে।
ঘটনা ডোরবেলচাইম বৈশিষ্ট্যের কাইম ইভেন্ট ডোরবেল টিপানো হয়েছে।
সেই ইভেন্টের সাথে সম্পর্কিত ক্যামেরা ইমেজের জন্য একটি ডাউনলোড URL পেতে কমান্ড অনুরোধে একটি সমর্থিত ইভেন্ট থেকে eventId ব্যবহার করুন।

ইমেজ অনুরোধ এবং প্রতিক্রিয়া তৈরি করুন

অনুরোধ

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.CameraEventImage.GenerateImage",
  "params" : {
    "eventId" : "IWoow5OcWRR3UXL2u3b5_v1Nag..."
  }
}

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

{
  "results" : {
    "url" : "https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...",
    "token" : "g.0.eventToken"
  }
}

ইমেজ অনুরোধ ক্ষেত্র তৈরি করুন

মাঠ বর্ণনা ডেটা টাইপ
eventId একটি সম্পর্কিত ক্যামেরা ছবির জন্য অনুরোধ করতে ইভেন্টের আইডি। string
উদাহরণ: "IWoow5OcWRR3UXL2u3b5_v1Nag..."

ইমেজ প্রতিক্রিয়া ক্ষেত্র তৈরি করুন

মাঠ বর্ণনা ডেটা টাইপ
url যে URL থেকে ক্যামেরা ছবি ডাউনলোড করতে হবে। string
উদাহরণ: "https:// domain /sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1..."
token ছবি ডাউনলোড করার সময় HTTP অনুমোদন হেডারে ব্যবহার করার জন্য টোকেন। string
উদাহরণ: "g.0.eventToken"

একটি ক্যামেরা ছবি ডাউনলোড করুন

একটি GenerateImage কমান্ড প্রতিক্রিয়া থেকে url এ একটি GET কল করুন, বেসিক অনুমোদন সহ HTTP অনুমোদন শিরোনামে token ব্যবহার করে, ক্যামেরা ছবি ডাউনলোড করতে:

curl -H "Authorization: Basic g.0.eventToken" \
      https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...

ডাউনলোড করা ছবির রেজোলিউশন কাস্টমাইজ করতে width বা height ক্যোয়ারী প্যারামিটার ব্যবহার করুন। এই পরামিতিগুলির মধ্যে শুধুমাত্র একটি নির্দিষ্ট করতে হবে। অন্য প্যারামিটারটি ক্যামেরার আকৃতির অনুপাত অনুযায়ী স্বয়ংক্রিয়ভাবে স্কেল করা হয়।

উদাহরণস্বরূপ, ক্যামেরার আকৃতির অনুপাত 4:3 হলে, 480 x 360 রেজোলিউশনের ক্যামেরা ছবি ডাউনলোড করতে প্রস্থ বা উচ্চতা নির্দিষ্ট করুন:

প্রস্থ

curl -H "Authorization: Basic g.0.eventToken" \
      https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...?width=480

উচ্চতা

curl -H "Authorization: Basic g.0.eventToken" \
      https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...?height=360

ডাউনলোড URL-এ অন্যান্য বিধিনিষেধ প্রযোজ্য:

  • যদি উভয় প্যারামিটার URL-এ প্রদান করা হয়, width ব্যবহার করা হয় এবং height উপেক্ষা করা হয়।
  • যদি URL-এ কোনো প্যারামিটার দেওয়া না থাকে, তাহলে width জন্য 480-এর একটি ডিফল্ট মান বেছে নেওয়া হয়।

ছবির বৈশিষ্ট্য সম্পর্কে তথ্যের জন্য CameraImage বৈশিষ্ট্য দেখুন।

ত্রুটি

নিম্নলিখিত ত্রুটি কোড(গুলি) এই বৈশিষ্ট্য সম্পর্কিত ফেরত দেওয়া হতে পারে:

ভুল বার্তা আরপিসি সমস্যা সমাধান
ক্যামেরা ছবি ডাউনলোডের জন্য আর উপলব্ধ নেই৷ DEADLINE_EXCEEDED ইভেন্ট প্রকাশিত হওয়ার 30 সেকেন্ড পরে ইভেন্ট চিত্রের মেয়াদ শেষ হয়ে যায়। মেয়াদ শেষ হওয়ার আগে ছবিটি ডাউনলোড করতে ভুলবেন না।
ইভেন্ট আইডি ক্যামেরার অন্তর্গত নয়। FAILED_PRECONDITION ক্যামেরা ইভেন্ট দ্বারা ফেরত সঠিক eventID ব্যবহার করুন।

API ত্রুটি কোডের সম্পূর্ণ তালিকার জন্য API ত্রুটি কোড রেফারেন্স দেখুন।