Giản đồ CameraClipPreview

Nest Doorbell (battery) Nest Doorbell (wired)

sdm.devices.traits.CameraClipPreview

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

Trường

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

Lệnh

Đặc điểm này không có lệnh nào.

Sự kiện

ClipPreview

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

Bản xem trước đoạn trích 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 một định dạng khác (ví dụ: ảnh GIF động) để hiển thị một chuỗi 10 khung hình hoàn chỉnh. Bạn nên cân nhắc các tính năng của ứng dụng khách thiết bị khi chọn phương thức xem trước đoạn trích.

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 đặc điểm CameraPerson	Camera đã phát hiện thấy một người.
Sự kiện	Sự kiện Chuông 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 liên quan với một hoặc nhiều sự kiện được hỗ trợ.

Sự kiện ClipPreview

Tải trọng

{
  "eventId" : "c4c7432d-0048-4501-b5f5-94a7d95f70b3",
  "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

Trường	Mô tả	Loại dữ liệu
`eventSessionId`	Mã nhận dạng được gán cho các sự kiện xảy ra trong một phiên duy nhất của các sự kiện liên quan. Có thể dùng để hợp nhất các sự kiện.	`string` Example: "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
`previewUrl`	URL để xem trước đoạn trích video. Bộ mã hoá và giải mã video mặc định là H264.	`string` Example: "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 riêng biệt cho sự kiện.	`string` Example: "c4c7432d-0048-4501-b5f5-94a7d95f70b3"
`timestamp`	Thời điểm sự kiện xảy ra.	`string` Example: "2019-01-01T00:00:01Z"
`resourceUpdate`	Một đối tượng cung cấp thông tin chi tiết về bản cập nhật tài nguyên.	`object`
`userId`	Giá trị nhận dạng duy nhất, được làm xáo trộn, đại diện cho người dùng.	`string` Example: "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi"
`resourceGroup`	Một đối tượng cho biết các tài nguyên có thể có các bản cập nhật tương tự cho 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`

Xem bài viết 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 chúng.

Xem trước đoạn trích

Để xem trước đoạn trích 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

Xem bài viết Tài liệu tham khảo về mã lỗi API để biết danh sách đầy đủ các mã lỗi API.