CameraClipPreview स्कीमा

Nest Doorbell (battery) Nest Doorbell (wired) 

sdm.devices.traits.CameraClipPreview

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

फ़ील्ड

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

निर्देश

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

इवेंट

ClipPreview

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

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

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

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

ClipPreview इवेंट

पेलोड

{
  "eventId" : "f563f89d-e47e-4846-a0a9-1f2d89e18a5a",
  "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
उदाहरण: "f563f89d-e47e-4846-a0a9-1f2d89e18a5a"
timestamp इवेंट होने का समय. string
उदाहरण: "2019-01-01T00:00:01Z"
resourceUpdate ऐसा ऑब्जेक्ट जिसमें संसाधन के अपडेट के बारे में जानकारी होती है. object
userId उपयोगकर्ता को दिखाने वाला एक यूनीक और छिपा हुआ आइडेंटिफ़ायर. string
उदाहरण: "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi"
resourceGroup ऐसा ऑब्जेक्ट जो उन संसाधनों के बारे में बताता है जिनमें इस इवेंट से मिलते-जुलते अपडेट हो सकते हैं. इवेंट का संसाधन (resourceUpdate ऑब्जेक्ट से) हमेशा इस ऑब्जेक्ट में मौजूद रहेगा. object

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

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

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

झलक देखें

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

गड़बड़ियां

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