CameraClipPreview स्कीमा

Nest Doorbell (battery) Nest Doorbell (wired) 

sdm.devices.traits.CameraClipPreview

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

फ़ील्ड

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

निर्देश

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

इवेंट

ClipPreview

वीडियो क्लिप की झलक उपलब्ध है.

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

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

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

ClipPreview इवेंट

पेलोड

{
  "eventId" : "0010793b-a7d4-4842-a1ba-5c5faed866ef",
  "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
Example: "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
previewUrl यह यूआरएल, वीडियो क्लिप की झलक देखने के लिए होता है. डिफ़ॉल्ट वीडियो कोडेक है H264. string
Example: "https://previewUrl/..."

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

फ़ील्ड ब्यौरा डेटा टाइप
eventId यह इवेंट का यूनीक आइडेंटिफ़ायर है. string
Example: "0010793b-a7d4-4842-a1ba-5c5faed866ef"
timestamp यह इवेंट के होने का समय है. string
Example: "2019-01-01T00:00:01Z"
resourceUpdate यह एक ऑब्जेक्ट है, जिसमें संसाधन के अपडेट के बारे में जानकारी दी जाती है. object
userId यह एक यूनीक, धुंधला किया गया आइडेंटिफ़ायर है, जो उपयोगकर्ता को दिखाता है. string
Example: "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi"
resourceGroup यह एक ऑब्जेक्ट है, जो उन संसाधनों को दिखाता है जिनमें इस इवेंट के जैसे ही अपडेट हो सकते हैं. इस ऑब्जेक्ट में, इवेंट का संसाधन (जो resourceUpdate ऑब्जेक्ट से मिलता है) हमेशा मौजूद रहेगा. object

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

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

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

झलक देखें

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

गड़बड़ियां

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