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ề loại thiết bị là DOORBELL (CHUYÊN DỤNG ĐỂ GÕ CỬA):

sdm.devices.types.DOORBELL

Google Nest Doorbell (phiên bản cũ) có một camera hoạt động giống như 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ợ việc tạo hình ảnh từ các sự kiện.GenerateImage
CameraImageĐặc điểm này thuộc về mọi thiết bị hỗ trợ chụp ảnh.
CameraLiveStreamĐặc điểm này thuộc về mọi thiết bị hỗ trợ 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.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 đặ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 Â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 Chuông cửa đã được nhấn.
Ví dụ: ở đây, nút chuông cửa đã được nhấn:

Dung lượng

{
  "eventId" : "48d37271-301c-486f-9266-edcb53982e06",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.DoorbellChime.Chime" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "B_NM_J0fhsbLeJBLdjLJmvlFmS..."
      }
    }
  }
  "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" : "TLJkb40AC62FKKrZvfBe1DPbhD..."
  }
}

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 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 tham 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 vào 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 thuộc tính CameraLiveStream sẽ trả về URL luồng và streamToken có 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 truyền 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 lệnh RTSP cho từng ứng dụng khách và mỗi ứng dụng khách phải sử dụng URL luồng riê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 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 luồng phát trực tiếp qua máy ảnh, bạn nên dừng luồng đó và vô hiệu hoá luồng. Để làm như vậy, hãy sử dụng lệnh StopFormatStream thích hợp của CameraLiveStream cho định dạng luồng mà bạn đã tạo.

RTSP

Để dừng luồng RTSP, hãy sử dụng mã thông báo để vô hiệu hoá bằng lệnh StopRtspStream của lệnh thuộc tính 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 30 giây sau 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.