Giản đồ CameraClipPreview
Nest Doorbell (pin)
sdm.devices.traits.CameraClipPreview
Trait này thuộc mọi thiết bị hỗ trợ việc tải bản xem trước của đoạn video xuống.
Trường
Không có trường nào cho trait này.
Lệnh
Không có lệnh nào cho trait này.
Sự kiện
ClipPreview
Có một đoạn video để xem trước.
Bản xem trước đoạn video là một tệp video gồm 10 khung hình ở định dạng mp4. Bạn có thể chọn hiển thị tệp video mp4 hoặc chuyển mã tệp đó sang định dạng khác (ví dụ: gif động) để hiển thị chuỗi 10 khung hình hoàn chỉnh. Bạn nên cân nhắc các chức năng của ứng dụng thiết bị khi chọn phương thức xem trước đoạn video.
Sự kiện này được hỗ trợ cho các sự kiện sau:
Loại | Phần tử | Nội dung mô tả |
---|---|---|
Sự kiện | Sự kiện Chuyển động của trait CameraMotion | Camera đã phát hiện thấy chuyển động. |
Sự kiện | Sự kiện Person của đặc điểm CameraPerson | Camera đã phát hiện thấy một người. |
Sự kiện | Sự kiện Chime của đặc điểm DoorbellChime | Đã nhấn chuông cửa. |
eventSessionId
để liên kết sự kiện này và previewUrl
liên quan với một hoặc nhiều sự kiện được hỗ trợ.
Sự kiện ClipPreview
Dung lượng
{ "eventId" : "54e55063-25e6-44a5-9aa7-704405bb1c91",
"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" ] }
Các trường sự kiện ClipPreview
Trường | Nội dung mô tả | Loại dữ liệu |
---|---|---|
eventSessionId |
Mã nhận dạng được cấp cho các sự kiện xảy ra trong một phiên hoạt động duy nhất của các sự kiện liên quan. Có thể được dùng để hợp nhất các sự kiện. | string Ví dụ: "CjY5Y3VKaTZwR3o4Y19YbTVfMF..." |
previewUrl |
URL mà tại đó bạn có thể xem trước đoạn video. Bộ mã hoá và giải mã video mặc định là H264. | string Ví dụ: "https://previewUrl/..." |
Trường tải trọng sự kiện
Trường | Nội dung mô tả | Loại dữ liệu |
---|---|---|
eventId |
Giá trị nhận dạng duy nhất của sự kiện. | string Ví dụ: "54e55063-25e6-44a5-9aa7-704405bb1c91" |
timestamp |
Thời gian xảy ra sự kiện. | string Ví dụ: "2019-01-01T00:00:01Z" |
resourceUpdate |
Một đối tượng cung cấp thông tin chi tiết về việc cập nhật tài nguyên. | object |
userId |
Giá trị nhận dạng duy nhất, bị làm rối mã nguồn đại diện cho người dùng. | string Ví dụ: "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi" |
resourceGroup |
Một đối tượng cho biết những tài nguyên có thể có nội dung cập nhật tương tự đối với sự kiện này. Tài nguyên của chính sự kiện đó (từ đối tượng resourceUpdate ) sẽ luôn xuất hiện trong đối tượng này. |
object |
Hãy xem phần Sự kiện để biết thêm thông tin về các loại sự kiện khác nhau và cách hoạt động của các sự kiện đó.
Xem trước đoạn video
Để xem trước đoạn video, hãy thực hiện lệnh gọi GET tới previewUrl
bằng mã truy cập OAuth trong tiêu đề Uỷ quyền HTTP:
Xem trước
curl -H 'Authorization: Bearer access-token' \
https://previewUrl/...
Lỗi
Hãy xem Tài liệu tham khảo về mã lỗi API để biết danh sách đầy đủ các mã lỗi API.