CameraClipPreview स्कीमा

Nest Doorbell (battery) Nest Doorbell (wired) 

sdm.devices.traits.CameraClipPreview

यह ट्रेट, क्लिप की झलक डाउनलोड करने की सुविधा वाले किसी भी डिवाइस के साथ काम करती है.

फ़ील्ड

इस ट्रेट के लिए कोई फ़ील्ड उपलब्ध नहीं है.

निर्देश

इस ट्रेट के लिए कोई निर्देश उपलब्ध नहीं है.

इवेंट

ClipPreview

झलक देखने के लिए, वीडियो क्लिप उपलब्ध है.

क्लिप की झलक, mp4 फ़ॉर्मैट में 10 फ़्रेम वाली वीडियो फ़ाइल होती है. आपके पास mp4 वीडियो फ़ाइल दिखाने का विकल्प होता है. इसके अलावा, इसे किसी दूसरे फ़ॉर्मैट (उदाहरण के लिए, ऐनिमेट किया गया GIF) में ट्रांसकोड करके, 10 फ़्रेम का पूरा क्रम दिखाया जा सकता है. क्लिप की झलक दिखाने का तरीका चुनते समय, डिवाइस के क्लाइंट की क्षमताओं को ध्यान में रखना चाहिए.

यह इवेंट, इन इवेंट के लिए काम करता है:

टाइप एलिमेंट ब्यौरा
इवेंट CameraMotion trait का Motion इवेंट कैमरे को हलचल का पता चला है.
इवेंट CameraPerson ट्रेट का Person इवेंट कैमरे में किसी व्यक्ति का पता चला है.
इवेंट DoorbellChime trait का Chime इवेंट दरवाज़े की घंटी बजाई गई है.
इस इवेंट और इससे जुड़े previewUrl को एक या उससे ज़्यादा इवेंट के साथ जोड़ने के लिए, eventSessionId का इस्तेमाल करें.

ClipPreview इवेंट

पेलोड

{
  "eventId" : "831987e3-e26e-496c-9b72-258b127dac8a",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraClipPreview.ClipPreview" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "previewUrl" : "https://previewUrl/..."
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

ClipPreview इवेंट के फ़ील्ड

फ़ील्ड ब्यौरा डेटा टाइप
eventSessionId यह आईडी, मिलते-जुलते कई इवेंट के एक ही सेशन में होने वाले सभी इवेंट को दिया जाता है. इसका इस्तेमाल, अलग-अलग इवेंट को एक साथ जोड़ने के लिए किया जा सकता है. string
उदाहरण: "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
previewUrl वह यूआरएल जिस पर वीडियो क्लिप की झलक देखी जा सकती है. डिफ़ॉल्ट वीडियो कोडेक H264 होता है. string
उदाहरण: "https://previewUrl/..."

इवेंट पेलोड फ़ील्ड

फ़ील्ड ब्यौरा डेटा टाइप
eventId इवेंट के लिए यूनीक आइडेंटिफ़ायर. string
उदाहरण: "831987e3-e26e-496c-9b72-258b127dac8a"
timestamp इवेंट होने का समय. string
उदाहरण: "2019-01-01T00:00:01Z"
resourceUpdate ऐसा ऑब्जेक्ट जिसमें संसाधन के अपडेट के बारे में जानकारी होती है. object
userId यह एक यूनीक और अस्पष्ट आइडेंटिफ़ायर है, जो उपयोगकर्ता को दिखाता है. string
उदाहरण: "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi"
resourceGroup यह एक ऐसा ऑब्जेक्ट है जो उन संसाधनों के बारे में बताता है जिनमें इस इवेंट के जैसे अपडेट हो सकते हैं. इवेंट का संसाधन (resourceUpdate ऑब्जेक्ट से) हमेशा इस ऑब्जेक्ट में मौजूद रहेगा. object

अलग-अलग तरह के इवेंट और उनके काम करने के तरीके के बारे में ज़्यादा जानने के लिए, इवेंट देखें.

क्लिप की झलक देखना

क्लिप की झलक देखने के लिए, HTTP ऑथराइज़ेशन हेडर में OAuth ऐक्सेस टोकन का इस्तेमाल करके, previewUrl को GET कॉल करें:

झलक देखें

curl -H 'Authorization: Bearer access-token' \
  https://previewUrl/...

गड़बड़ियां

एपीआई के गड़बड़ी कोड की पूरी सूची देखने के लिए, एपीआई के गड़बड़ी कोड के बारे में जानकारी देखें.