Chuông cửa (cũ)

Nest Hello

Tất cả chuông cửa Nest cũ đều được hỗ trợ trong API Quản lý thiết bị thông minh (SDM). Thiết bị này trả về một loại thiết bị là DOORBELL:

sdm.devices.types.DOORBELL

Google Nest Doorbell (cũ) có một camera hoạt động giống như một loại thiết bị CAMERA.

Đặc điểm

Tài liệu tham khảo

Các đặc điểm, lệnh hoặc sự kiện sau đây có liên quan đến thiết bị này:

Đặc điểmMô tảLệnhSự kiện
CameraEventImageĐặc điểm này thuộc về mọi thiết bị hỗ trợ tạo hình ảnh từ các sự kiện.GenerateImage
CameraImageĐặc điểm này thuộc về bất kỳ thiết bị nào có hỗ trợ tính năng chụp ảnh.
CameraLiveStreamĐặc điểm này thuộc về bất kỳ thiết bị nào có hỗ trợ tính năng phát trực tiếp.GenerateRtspStream
ExtendRtspStream
StopRtspStream
CameraMotionĐặc điểm này thuộc về mọi thiết bị hỗ trợ sự kiện phát hiện chuyển động.Chuyển động
CameraPersonĐặc điểm này thuộc về mọi thiết bị hỗ trợ sự kiện phát hiện người.Person
(Người)
CameraSoundĐặc điểm này thuộc về mọi thiết bị hỗ trợ sự kiện phát hiện âm thanh.Âm thanh
DoorbellChimeĐặc điểm này thuộc về mọi thiết bị hỗ trợ chuông cửa và các sự kiện nhấn liên quan.Chuông
Thông tinĐặc điểm này thuộc về mọi thiết bị để cung cấp thông tin liên quan đến thiết bị.

JSON

Việc không có một đặc điểm nào trong phản hồi GET cho biết rằng đặc điểm hoặc tính năng đó hiện không có trên thiết bị. Hãy xem phần Các loại thiết bị để biết thêm thông tin.

{
  "type" : "sdm.devices.types.DOORBELL",
  "traits" : {
    "sdm.devices.traits.CameraEventImage" : {},
    "sdm.devices.traits.CameraImage" : {
      "maxImageResolution" : {
        "width" : 1280,
        "height" : 960
      }
    },
    "sdm.devices.traits.CameraLiveStream" : {
      "maxVideoResolution" : {
        "width" : 640,
        "height" : 480
      },
      "videoCodecs" : ["H264"],
      "audioCodecs" : ["AAC"],
      "supportedProtocols" : ["WEB_RTC"]
    },
    "sdm.devices.traits.CameraMotion" : {},
    "sdm.devices.traits.CameraPerson" : {},
    "sdm.devices.traits.CameraSound" : {},
    "sdm.devices.traits.DoorbellChime" : {},
    "sdm.devices.traits.Info" : {
      "customName" : "My device"
    }
  }
}

Xử lý sự kiện của chuông cửa và camera

Các sự kiện sau đây có thể được kích hoạt từ loại thiết bị CHUÔNG ĐỒNG HỒ:

Loại Phần tử 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 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 Âm thanh của đặc điểm CameraSound Camera phát hiện thấy âm thanh.
Sự kiện Sự kiện Chime của đặc điểm DoorbellChime Đã nhấn chuông cửa.
Ví dụ: trong ví dụ này, nút chuông cửa đã được nhấn:

Dung lượng

{
  "eventId" : "76f85e13-cc15-4705-83c3-0b3838118524",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.DoorbellChime.Chime" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "cV7T3NiEMXH5ZmQz21AwMaW0mF..."
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}
Trọng tải của sự kiện này chứa một eventId có thể được sử dụng với lệnh GenerateImage. Lệnh này trả về một URL tải xuống cho hình ảnh máy ảnh liên quan đến sự kiện:

Yêu cầu

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.CameraEventImage.GenerateImage",
  "params" : {
    "eventId" : "mFNqXZk08luMZuuBBPCPbS7mZ4..."
  }
}

Phản hồi

{
  "results" : {
    "url" : "https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...",
    "token" : "g.0.eventToken"
  }
}

Tải hình ảnh trong máy ảnh xuống

Thực hiện lệnh gọi GET đến url từ phản hồi lệnh GenerateImage, sử dụng token trong tiêu đề Uỷ quyền HTTP với quyền Uỷ quyền cơ bản để tải hình ảnh máy ảnh xuống:

curl -H "Authorization: Basic g.0.eventToken" \
      https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...

Sử dụng các tham số truy vấn width hoặc height để tuỳ chỉnh độ phân giải của hình ảnh đã tải xuống. Bạn chỉ cần chỉ định một trong các thông số này. Tham số còn lại được tự động điều chỉnh theo tỷ lệ khung hình của máy ảnh.

Ví dụ: nếu tỷ lệ khung hình của máy ảnh là 4:3, để tải hình ảnh máy ảnh xuống với độ phân giải 480 x 360, hãy chỉ định chiều rộng hoặc chiều cao:

Chiều rộng

curl -H "Authorization: Basic g.0.eventToken" \
      https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...?width=480

Chiều cao

curl -H "Authorization: Basic g.0.eventToken" \
      https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...?height=360

Các hạn chế khác đối với URL tải xuống sẽ được áp dụng:

  • Nếu bạn cung cấp cả hai tham số trong URL, thì width sẽ được dùng và height sẽ bị bỏ qua.
  • Nếu bạn không cung cấp tham số nào trong URL, thì hệ thống sẽ chọn giá trị mặc định là 480 cho width.

Xem đặc điểm CameraImage để biết thông tin về các thuộc tính hình ảnh.

Truy cập sự kiện phát trực tiếp

Có thể truy cập vào luồng phát trực tiếp từ camera. Các định dạng truyền trực tuyến sau đây được hỗ trợ cho thiết bị này:

  • RTSP

Để xem danh sách đầy đủ các máy ảnh và định dạng luồng được hỗ trợ, hãy xem phần Thiết bị được hỗ trợ.

Để truy cập vào luồng phát trực tiếp, hãy sử dụng lệnh TạoFormatLuồng thích hợp của CameraLiveStream trường hợp.

RTSP

Đối với luồng RTSP, lệnh GenerateRtspStream của lệnh CameraLiveStream trait sẽ trả về URL của luồng phát và streamToken liên quan:

Yêu cầu

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.CameraLiveStream.GenerateRtspStream",
  "params" : {}
}

Phản hồi

{
  "results" : {
    "streamUrls" : {
      "rtspUrl" : "rtsps://someurl.com/CjY5Y3VKaTZwR3o4Y19YbTVfMF...?auth=g.0.streamingToken"
    },
    "streamExtensionToken" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
    "streamToken" : "g.0.streamingToken",
    "expiresAt" : "2018-01-04T18:30:00.000Z"
  }
}

Sau đó, hãy sử dụng URL của luồng để truy cập vào sự kiện phát trực tiếp của camera:

rtsps://someurl.com/CjY5Y3VKaTZwR3o4Y19YbTVfMF...?auth=g.0.streamingToken

Bạn không thể chia sẻ URL của sự kiện phát trực tiếp RTSP giữa các ứng dụng. Mỗi lần, chỉ một ứng dụng có thể sử dụng một URL của sự kiện phát trực tiếp. Nếu nhiều ứng dụng khách muốn phát trực tuyến từ cùng một máy ảnh cùng một lúc, thì bạn phải gửi các lệnh RTSP cho từng ứng dụng riêng lẻ và mỗi ứng dụng riêng lẻ phải sử dụng URL luồng riêng của ứng dụng đó.

Kéo dài sự kiện phát trực tiếp

Phiên phát trực tiếp bằng máy ảnh chỉ có hiệu lực trong 5 phút. Nếu bạn cần kéo dài thời lượng của sự kiện phát trực tiếp, hãy sử dụng lệnh Mở rộngFormatluồng thích hợp của thuộc tính CameraLiveStream cho định dạng luồng mà bạn đã tạo.

RTSP

Để mở rộng luồng RTSP, hãy sử dụng lệnh ExtendRtspStream của lệnh thuộc tính CameraLiveStream để lấy các giá trị streamExtensionToken và streamToken mới:

Yêu cầu

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.CameraLiveStream.ExtendRtspStream",
  "params" : {
    "streamExtensionToken" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
  }
}

Phản hồi

{
  "results" : {
    "streamExtensionToken" : "dGNUlTU2CjY5Y3VKaTZwR3o4Y1...",
    "streamToken" : "g.0.newStreamingToken",
    "expiresAt" : "2018-01-04T18:30:00.000Z"
  }
}

Cập nhật URL của sự kiện phát trực tiếp bằng các giá trị mới này để tiếp tục xem sự kiện phát trực tiếp:

rtsps://someurl.com/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...?auth=g.0.newStreamingToken

Dừng sự kiện phát trực tiếp

Bất cứ khi nào không còn sử dụng tính năng phát trực tiếp từ camera, bạn nên dừng phát trực tiếp và vô hiệu hoá sự kiện phát trực tiếp đó. Để thực hiện việc này, hãy dùng lệnh StopFormatStream thích hợp của traitCameraLiveStreamcho định dạng luồng mà bạn đã tạo.

RTSP

Để dừng truyền trực tuyến RTSP, hãy sử dụng mã thông báo này để vô hiệu hoá bằng lệnh StopRtspStream trong lệnh trait CameraLiveStream:

Yêu cầu

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.CameraLiveStream.StopRtspStream",
  "params" : {
    "streamExtensionToken" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
  }
}

Phản hồi

{}

Lỗi

(Các) mã lỗi sau đây có thể được trả về liên quan đến thiết bị này:

Thông báo Lỗi RPC Khắc phục sự cố
Bạn không thể tải hình ảnh chụp bằng máy ảnh xuống nữa. DEADLINE_EXCEEDED Hình ảnh sự kiện sẽ hết hạn sau 30 giây kể từ khi sự kiện được xuất bản. Hãy nhớ tải hình ảnh xuống trước khi hết hạn.
Mã sự kiện không thuộc về máy ảnh. FAILED_PRECONDITION Sử dụng đúng eventID do sự kiện máy ảnh trả về.

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.