CameraClipPreview स्कीमा

Nest Doorbell (battery) Nest Doorbell (wired) 

sdm.devices.traits.CameraClipPreview

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

फ़ील्ड

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

निर्देश

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

इवेंट

ClipPreview

वीडियो क्लिप की झलक देखी जा सकती है.

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

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

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

ClipPreview इवेंट

पेलोड

{
  "eventId" : "c3d24f38-d0be-4cf1-a00d-9cb772ab5db1",
  "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
उदाहरण: "c3d24f38-d0be-4cf1-a00d-9cb772ab5db1"
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/...

गड़बड़ियां

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