Giản đồ CameraClipPreview

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

sdm.devices.traits.CameraClipPreview

Đặc điểm này thuộc về mọi thiết bị hỗ trợ tính năng tải bản xem trước đoạn video xuống.

Trường

Không có trường nào cho đặc điểm này.

Lệnh

Không có lệnh nào dùng được cho đặc điểm này.

Sự kiện

ClipPreview

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

Bản xem trước đoạn video là tệp video 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 một định dạng khác (ví dụ: ảnh gif động) để hiển thị một trình tự 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 khách trên 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ử Mô tả
Sự kiện Sự kiện Chuyển động của đặc điểm CameraMotion Camera phát hiện thấy chuyển động.
Sự kiện Sự kiện Người của thuộc tính 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 Chuông cửa đã được nhấn.
Sử dụng eventSessionId để liên kết sự kiện này và previewUrl có 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" : "cac055e6-c8df-471f-94ff-6cbfd6c7e969",
  "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 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 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/..."

Trường tải trọng sự kiện

Trường 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ụ: "cac055e6-c8df-471f-94ff-6cbfd6c7e969"
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ề nội dung cập nhật tài nguyên. object
userId Giá trị nhận dạng duy nhất, được 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 các 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 có 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 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 đến 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.