ডোরবেল (উত্তরাধিকার)

স্মার্ট ডিভাইস ম্যানেজমেন্ট (এসডিএম) এপিআই-তে সমস্ত পুরোনো নেস্ট ডোরবেল সমর্থিত। এই ডিভাইসটি ডোরবেল (DOORBELL) ডিভাইস টাইপ রিটার্ন করে:

sdm.devices.types.DOORBELL

গুগল নেস্ট ডোরবেল (লেগ্যাসি)-তে একটি ক্যামেরা রয়েছে, যা ক্যামেরা টাইপের ডিভাইস হিসেবেই কাজ করে।

বৈশিষ্ট্য

{
  "type" : "sdm.devices.types.DOORBELL",
  "traits" : {
    "sdm.devices.traits.CameraEventImage" : {},
    "sdm.devices.traits.CameraImage" : {
      "maxImageResolution" : {
        "width" : 1280,
        "height" : 960
      }
    },
    "sdm.devices.traits.CameraLiveStream" : {
      "maxVideoResolution" : {
        "width" : 640,
        "height" : 480
      },
      "videoCodecs" : ["H264"],
      "audioCodecs" : ["AAC"],
      "supportedProtocols" : ["WEB_RTC"]
    },
    "sdm.devices.traits.CameraMotion" : {},
    "sdm.devices.traits.CameraPerson" : {},
    "sdm.devices.traits.CameraSound" : {},
    "sdm.devices.traits.DoorbellChime" : {},
    "sdm.devices.traits.Info" : {
      "customName" : "My device"
    }
  }
}

ডোরবেল এবং ক্যামেরার ইভেন্টগুলি পরিচালনা করুন

{
  "eventId" : "3e7b7488-09ad-41f5-8381-165d5a589759",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.DoorbellChime.Chime" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "rjn57L02poi7gTFbOCYg0ocaKz..."
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

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

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

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

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

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 নির্বাচন করা হয়।

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

একটি লাইভ স্ট্রিম অ্যাক্সেস করুন

ক্যামেরা থেকে লাইভ স্ট্রিম অ্যাক্সেস করা যাবে। এই ডিভাইসের জন্য নিম্নলিখিত স্ট্রিম ফরম্যাটগুলো সমর্থিত:

• আরটিএসপি

ক্যামেরা এবং সমর্থিত স্ট্রিম ফরম্যাটের সম্পূর্ণ তালিকার জন্য, সমর্থিত ডিভাইসসমূহ দেখুন।

লাইভ স্ট্রিম অ্যাক্সেস করতে, উপযুক্ত Generate Format Stream কমান্ডটি ব্যবহার করুন।ক্যামেরালাইভস্ট্রিমবৈশিষ্ট্য।

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.CameraLiveStream.GenerateRtspStream",
  "params" : {}
}

{
  "results" : {
    "streamUrls" : {
      "rtspUrl" : "rtsps://someurl.com/CjY5Y3VKaTZwR3o4Y19YbTVfMF...?auth=g.0.streamingToken"
    },
    "streamExtensionToken" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
    "streamToken" : "g.0.streamingToken",
    "expiresAt" : "2018-01-04T18:30:00.000Z"
  }
}

rtsps://someurl.com/CjY5Y3VKaTZwR3o4Y19YbTVfMF...?auth=g.0.streamingToken

একটি লাইভ স্ট্রিম প্রসারিত করুন

ক্যামেরা লাইভ স্ট্রিম সেশনগুলো শুধুমাত্র ৫ মিনিটের জন্য বৈধ থাকে। যদি আপনি কোনো লাইভ স্ট্রিমের মেয়াদ বাড়াতে চান, তাহলে উপযুক্ত Extend Format Stream কমান্ডটি ব্যবহার করুন। ক্যামেরালাইভস্ট্রিম আপনার তৈরি করা স্ট্রিম ফরম্যাটের জন্য বৈশিষ্ট্য।

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.CameraLiveStream.ExtendRtspStream",
  "params" : {
    "streamExtensionToken" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
  }
}

{
  "results" : {
    "streamExtensionToken" : "dGNUlTU2CjY5Y3VKaTZwR3o4Y1...",
    "streamToken" : "g.0.newStreamingToken",
    "expiresAt" : "2018-01-04T18:30:00.000Z"
  }
}

rtsps://someurl.com/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...?auth=g.0.newStreamingToken

একটি লাইভ স্ট্রিম বন্ধ করুন

যখনই আপনি ক্যামেরা লাইভ স্ট্রিম ব্যবহার করা বন্ধ করবেন, তখন সেটি বন্ধ করে স্ট্রিমটি বাতিল করে দিন। এটি করার জন্য, উপযুক্ত Stop Format Stream কমান্ডটি ব্যবহার করুন।ক্যামেরালাইভস্ট্রিমআপনার তৈরি করা স্ট্রিম ফরম্যাটের জন্য বৈশিষ্ট্য।

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.CameraLiveStream.StopRtspStream",
  "params" : {
    "streamExtensionToken" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
  }
}

{}

ত্রুটি

এই ডিভাইসটির ক্ষেত্রে নিম্নলিখিত ত্রুটি কোড(গুলি) প্রদর্শিত হতে পারে:

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