Giản đồ Trait CameraStream của nhà thông minh

action.devices.traits.CameraStream – Đặc điểm này hướng dẫn cách điều khiển luồng camera của thiết bị.

Đặc điểm này thuộc về các thiết bị có khả năng truyền trực tuyến nguồn cấp dữ liệu video đến màn hình thông minh, thiết bị có hỗ trợ Chromecast hoặc điện thoại thông minh. Nhìn chung, đây là camera an ninh hoặc camera em bé. Tuy nhiên, đặc điểm này cũng áp dụng cho các thiết bị phức tạp hơn có camera (ví dụ: thiết bị hội nghị truyền hình hoặc rô bốt máy hút bụi có camera trên đó).

ĐẶC ĐIỂM của thiết bị

Các thiết bị có đặc điểm này có thể báo cáo các thuộc tính sau trong thao tác SYNC. Để tìm hiểu thêm về cách xử lý ý định SYNC, vui lòng xem bài viết Phương thức thực hiện ý định.

Ví dụ

Máy ảnh hỗ trợ nhiều giao thức, không yêu cầu mã xác thực.

{
  "cameraStreamSupportedProtocols": [
    "webrtc",
    "hls",
    "dash",
    "smooth_stream",
    "progressive_mp4"
  ],
  "cameraStreamNeedAuthToken": false
}

Máy ảnh hỗ trợ một giao thức duy nhất, cần có mã xác thực.

{
  "cameraStreamSupportedProtocols": [
    "hls"
  ],
  "cameraStreamNeedAuthToken": true
}

Giao thức truyền trực tuyến được hỗ trợ

Trait này hỗ trợ các giao thức phát trực tuyến sau:

• webrtc: WebRTC
• hls: Phát trực tuyến dựa trên HTTP
• dash: Truyền phát thích ứng động qua HTTP
• smooth_stream: Phát trực tuyến mượt
• progressive_mp4: MP4 tiến bộ (chủ yếu được sử dụng cho đoạn video)

Khi truyền trực tuyến các giao thức hls,dash,smooth_stream và progressive_mp4 tới thiết bị truyền (Chromecast, màn hình thông minh và TV thông minh có hỗ trợ Chromecast), Bộ thu web truyền được chạy để xử lý và kết xuất luồng trên thiết bị. Nhà phát triển nên tạo Trình thu nhận web tuỳ chỉnh để cho phép truy cập vào các công cụ gỡ lỗi, tuỳ chỉnh hành vi của người chơi, tuỳ chỉnh thương hiệu giao diện người dùng và thêm số liệu phân tích. Để cho phép sử dụng trình thu nhận tuỳ chỉnh và chọn không sử dụng trình thu nhận mặc định, hãy đặt mã ứng dụng trình thu nhận được tạo khi bạn đăng ký ứng dụng Truyền trong trường cameraStreamReceiverAppId của phản hồi EXECUTE.

Để tìm hiểu thêm về các ứng dụng Trình thu nhận web tuỳ chỉnh, hãy truy cập vào hướng dẫn trang web dành cho nhà phát triển.

TÌNH TRẠNG của thiết bị

Không nội dung nào.

Lệnh trên thiết bị

Các thiết bị có đặc điểm này có thể phản hồi các lệnh sau trong thao tác EXECUTE. Để tìm hiểu thêm về cách xử lý ý định EXECUTE, vui lòng xem bài viết Phương thức thực hiện ý định.

action.devices.commands.GetCameraStream

Các tham số

Kết quả

Kết quả không phải cho WebRTC

Kết quả WebRTC

Ví dụ

Hiển thị camera cửa trước (bộ thu Truyền mặc định).

{
  "cameraStreamAccessUrl": "https://fluffysheep.com/baaaaa.mp4",
  "cameraStreamProtocol": "progressive_mp4"
}

Hiển thị camera cửa trước (bộ thu Cast tuỳ chỉnh).

{
  "cameraStreamAccessUrl": "https://fluffysheep.com/baaaaa.mp4",
  "cameraStreamReceiverAppId": "1g2f89213hg",
  "cameraStreamAuthToken": "12657342190192783",
  "cameraStreamProtocol": "progressive_mp4"
}

Hiển thị camera cửa trước (luồng WebRTC).

{
  "cameraStreamIceServers": "[{\"urls\": \"stun:stun.l.partner.com:19302\"},{\"urls\":\"turn:192.158.29.39:3478?transport=udp\",\"credential\": \"JZEOEt2V3Qb0y27GRntt2u2PAYA=\",\"username\": \"28224511:1379330808\"},{\"urls\": \"turn:192.158.29.39:3478?transport=tcp\",\"credential\": \"JZEOEt2V3Qb0y27GRntt2u2PAYA=\",\"username\": \"28224511:1379330808\"}]",
  "cameraStreamSignalingUrl": "https://example.com/signaling/answer",
  "cameraStreamOffer": "o=- 4611731400430051336 2 IN IP4 127.0.0.1...",
  "cameraStreamProtocol": "webrtc"
}

Thiết bị LỖI

Thông số kỹ thuật của giao thức WebRTC

Lợi ích của việc sử dụng WebRTC là độ trễ thấp và tính năng trò chuyện 1 chiều. WebRTC sử dụng phương thức POST có nội dung và phản hồi POST ở định dạng JSON.

Màn hình thông minh Google Nest và các thiết bị Chromecast có Google TV hiện hỗ trợ WebRTC.

Phần này mô tả các yêu cầu khi sử dụng giao thức truyền trực tuyến WebRTC.

Yêu cầu và đề xuất WebRTC

• Google hiện hỗ trợ giao tiếp 1 chiều (nửa song công).
• Bạn phải hỗ trợ gói và rtcp-mux.
• Bạn phải sử dụng (D)TLS 1.2 trở lên.
• Không hỗ trợ ICE nhỏ giọt. Bạn phải tập hợp tất cả các ứng viên ICE trước khi gửi SDP.
• Bạn nên bao gồm các ứng viên ICE UDP/IPv4, TCP/IPv4, UDP/IPv6 và TCP/IPv6 để tăng xác suất kết nối thành công.

Độ phân giải video được hỗ trợ:

• Tối thiểu: 480p
• Tối đa: 1080p

Bộ mã hoá và giải mã video được hỗ trợ:

• VP8
• H.264

Các bộ mã hoá và giải mã âm thanh được hỗ trợ:

• Opus (bộ mã hoá và giải mã ưu tiên)
• G.711/PCMU
• G.722

Chia sẻ tài nguyên trên nhiều nguồn gốc

Chia sẻ tài nguyên trên nhiều nguồn gốc (CORS) là một cơ chế sử dụng các Tiêu đề HTTP bổ sung để thông báo cho các trình duyệt nhằm cho phép ứng dụng web đang chạy tại một nguồn truy cập vào các tài nguyên đã chọn từ một nguồn gốc khác. Máy chủ lưu trữ cameraStreamSignalingUrl phải phản hồi bằng tiêu đề sau:

Access-Control-Allow-Origin: https://www.gstatic.com

Phản hồi và yêu cầu báo hiệu mẫu

Ví dụ sau đây cho thấy một yêu cầu mà Google gửi đến dịch vụ tín hiệu và phản hồi tương ứng cho Google.

Header:

Authentication: Bearer <cameraStreamAuthToken>
Content-Type: application/json

POST body:

// When camera offer SDP is provided in the execution response, Google provides an answer SDP.
{
  "action": "answer",
  "deviceId": "123",
  "sdp": "o=- 4611731400430051336 2 IN IP4 127.0.0.1..."
}

// When camera offer SDP is not provided in execution response, Google generates and provides an offer SDP.
{
  "action": "offer",
  "deviceId": "123",
  "sdp": "o=- 4611731400430051336 2 IN IP4 127.0.0.1..."
}

// Close the current stream session.
{
  "action": "end"
  "deviceId": "123"
}

// Response to accept the answer SDP in the request.
Response Code : 200
{}

// Response to provide the answer SDP from the service provider.
Response Code : 200
{
  // When the camera offer SDP is not provided in the execution response,
  // Google provides the answer SDP via the signaling response.
  "action": "answer"
  "sdp": "o=- 4611731400430051336 2 IN IP4 127.0.0.1..."
}

// Response to close current session.
Response Code : 200
{}