Giản đồ CameraClipPreview

Nest Doorbell (pin) Nest Doorbell (có dây) 

sdm.devices.traits.CameraClipPreview

Đặc điểm này thuộc về bất kỳ thiết bị nào hỗ trợ tải bản xem trước đ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 dùng được cho trait này.

Sự kiện

ClipPreview

Bạn có thể xem trước một đoạn video.

Bản xem trước đoạn video là một tệp video dài 10 khung ở định dạng mp4. Bạn có thể chọn hiển thị tệp video mp4 hoặc chuyển mã 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 tính năng 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 trait DoorbellChime Đã nhấn chuông cửa.
Sử dụng 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" : "511e6217-5108-4f06-9d4f-18037a23048c",
  "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"
  ]
}

Trường sự kiện ClipPreview

Kỹ thuật 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 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 để xem trước đoạn video. Bộ mã hoá và giải mã video mặc định là H264. string
Ví dụ: "https://previewUrl/..."

Các trường tải trọng của sự kiện

Kỹ thuật 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ụ: "511e6217-5108-4f06-9d4f-18037a23048c"
timestamp Thời gian khi sự kiện xảy ra. string
Ví dụ: "2019-01-01T00:00:01Z"
resourceUpdate Đối tượng nêu chi tiết thông tin về việc cập nhật tài nguyên. object
userId Một 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ự như sự kiện này. Tài nguyên của chính sự kiện đó (từ đối tượng resourceUpdate) sẽ luôn hiện diện trong đối tượng này. object

Hãy xem bài viết Sự kiện để biết thêm thông tin về các loại sự kiện khác nhau và cách thức hoạt động của những sự kiện này.

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 đề Ủy 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.