Bộ thu web tùy chỉnh

Bắt đầu ngay – Mã để tạo một Web tuỳ chỉnh cơ bản Bộ nhận rất đơn giản. Chuyển tới đăng ký Trình nhận web của bạn , sau đó tạo một phiên bản ứng dụng Web receiver.

Web receiver SDK sử dụng trình phát nội dung đa phương tiện tích hợp sẵn để cung cấp trải nghiệm phát lại. Ứng dụng này cũng cung cấp dịch vụ hỗ trợ có sẵn cho Trợ lý Google dưới dạng các tính năng dành riêng cho Cast được tự động hỗ trợ trên tất cả các trình gửi và thiết bị hỗ trợ cảm ứng. Khi các tính năng mới ra mắt, chúng vẫn sẽ được hỗ trợ mà không có thay đổi bổ sung dành cho người gửi.

Custom Web receiver là một ứng dụng HTML5 được tuỳ chỉnh phải được lưu trữ trên hiển thị nội dung của bạn trên thiết bị hỗ trợ Cast. Bạn có thể cần phải tạo một Báo cáo tùy chỉnh Bộ thu web tuỳ thuộc vào nhu cầu kinh doanh của bạn. Để được trợ giúp trong việc quyết định người nhận nào để sử dụng, hãy xem chọn hướng dẫn về Trình nhận web.

SDK Bộ nhận web của Google

Ứng dụng Web receiver của bạn truy cập vào Web receiver API bằng các thông tin sau tham chiếu:

<script src="//www.gstatic.com/cast/sdk/libs/caf_receiver/v3/cast_receiver_framework.js"></script>

Phương pháp hay nhất cho giao thức URL: Xin lưu ý rằng URL ở trên không chỉ định "http:" hoặc "https:" giao thức. Bỏ qua các giao thức này khi tìm nguồn cung ứng Tài nguyên cast_receiver_framework.js cho phép tìm nạp tài nguyên này bằng cách sử dụng cùng một giao thức như máy chủ lưu trữ ứng dụng Web receiver. Điều này có nghĩa là minh bạch hoạt động chuyển đổi giữa HTTP cho hoạt động phát triển và HTTPS cho hoạt động sản xuất và sẽ không yêu cầu thay đổi mã. (Bạn phải lưu trữ các ứng dụng Trình nhận web đã phát hành trên các máy chủ có hỗ trợ TLS.)

Bản xem trước SDK

Phiên bản phát hành trước của SDK Cast Web receiver cũng có sẵn để sử dụng trong kiểm thử các ứng dụng phi sản xuất. Thông tin khác về URL bản xem trước SDK tại URL xem trước SDK Bộ thu web của Google Cast.

Vòng đời của ứng dụng

Vòng đời của ứng dụng Web receiver bắt đầu từ thời điểm mà Web receiver này hoạt động được tải lên Thiết bị truyền và chuyển tới điểm mà ứng dụng bị gỡ bỏ và Thiết bị truyền hoàn nguyên về trạng thái mặc định.

Trong vòng đời của ứng dụng Web receiver, tin nhắn được trao đổi giữa Web receiver và bất kỳ ứng dụng dành cho người gửi nào được kết nối. Ứng dụng của người gửi sẽ gửi tin nhắn ban đầu tới thiết bị Google Cast để yêu cầu tạo phiên bằng cách sử dụng ID ứng dụng cụ thể. Việc này khởi động vòng đời của Web receiver, vì thiết bị Google Cast sẽ cố tải ứng dụng Web nhận. Giả sử có không có sự cố mạng nào, ứng dụng Trình nhận web sẽ được tải xuống từ mạng bằng cách sử dụng URL đã phân giải được liên kết với ID ứng dụng. Sau khi tải, Web receiver ứng dụng sẽ thực hiện hoạt động thiết lập và cho biết rằng ứng dụng đã sẵn sàng xử lý thư từ bất kỳ ứng dụng dành cho người gửi nào được kết nối.

Ứng dụng Web receiver có thể bị hỏng (kết thúc vòng đời hiện tại và đóng ) theo các điều kiện sau:

  • Ứng dụng Trình nhận web nhận được thông báo rõ ràng từ thiết bị được kết nối gần đây nhất người gửi để kết thúc phiên đăng ký.
  • Ứng dụng Web receiver không hoạt động trong một khoảng thời gian xác định mà không người gửi được kết nối và quyết định kết thúc phiên đăng ký.
  • Một phiên truyền khác đã được bắt đầu.
  • Web receiver gặp lỗi nghiêm trọng trong vòng đời bình thường.

Web receiver SDK xử lý tất cả các trường hợp phổ biến theo Nguyên tắc về trải nghiệm người dùng.

Các lớp chính

Khung SDK của Bộ thu web có 2 lớp chính:

  • cast.framework.CastReceiverContext – Quản lý khung tổng thể và tải mọi thư viện cần thiết. Với đối tượng này, bạn có thể:

    • Đặt tuỳ chọn cấu hình ứng dụng
    • Xử lý các sự kiện hệ thống (chẳng hạn như người gửi được kết nối hoặc đã ngắt kết nối)
    • Tạo kênh tuỳ chỉnh
    • Bắt đầu giao tiếp truyền

  • cast.framework.PlayerManager – Quản lý nội dung nghe nhìn video. Thư viện này xử lý trình phát cơ bản và phần tử đa phương tiện theo từ người gửi. Với đối tượng này, bạn có thể:

    • Xử lý thao tác phát
    • Xử lý các yêu cầu liên quan đến hoạt động phát từ người gửi
    • Xử lý các sự kiện liên quan đến hoạt động phát

Đăng ký ứng dụng Trình nhận web

Trước khi phát triển ứng dụng Trình nhận web, bạn cần đăng ký tài khoản Web Ứng dụng bộ nhận với Bảng điều khiển dành cho nhà phát triển SDK Google Cast. Xem Hãy đăng ký để biết thêm thông tin. Tất cả bộ nhận web ứng dụng yêu cầu các ứng dụng của người gửi cung cấp ID ứng dụng cùng với các thông báo lệnh họ gửi đến Web receiver thông qua API người gửi. Khi bạn đăng ký trang web của người nhận, bạn sẽ nhận được ID ứng dụng để đưa vào Lệnh gọi API.

Tạo ứng dụng Trình nhận web cơ bản

Sau đây là cấu trúc chính của một ứng dụng Web receiver cơ bản không có tuỳ chỉnh:

  1. Một phần tử HTML cast-media-player đại diện cho trình phát nội dung đa phương tiện.
  2. Một phần tử HTML của tập lệnh để tải khung Web receiver.
  3. Gọi điện start() để khởi động ứng dụng Trình nhận web mà không có tuỳ chọn.

Dưới đây là mã tối thiểu cho ứng dụng Web receiver dùng ứng dụng truyền Khung mà không có bất kỳ tuỳ chỉnh nào. Bạn có thể sao chép và dán tập lệnh này một cách chính xác nguyên trạng vào ứng dụng của bạn để tạo ứng dụng Web receiver.

<html>
<head>
  <script type="text/javascript"
      src="//www.gstatic.com/cast/sdk/libs/caf_receiver/v3/cast_receiver_framework.js">
  </script>
</head>
<body>
  <cast-media-player></cast-media-player>
  <script>
    cast.framework.CastReceiverContext.getInstance().start();
  </script>
</body>
</html>

Tại thời điểm này, người dùng có thể mở ứng dụng dành cho người gửi, kết nối với Thiết bị truyền của họ, sau đó chuyển đến nội dung đa phương tiện rồi nhấn nút Phát để yêu cầu Bộ thu web truyền trực tuyến nội dung đa phương tiện đến TV để người dùng xem.

So sánh Trình thu sóng web cơ bản này với ứng dụng receiver tuỳ chỉnh.

Nội dung nghe nhìn và trình phát

Khung Cast cung cấp một trình phát nội dung đa phương tiện tích hợp sẵn, được biểu thị bằng Phần tử HTML cast-media-player. Trình phát nội dung đa phương tiện này hỗ trợ phát cho các giao thức phát trực tuyến như MPEG-DASH, HLS và moot Streaming.

Một bộ bộ mã hoá và vùng chứa nội dung đa phương tiện được hỗ trợ được liệt kê tại Phương tiện được hỗ trợ. Thông qua công cụ nhắn tin trên Cast, nhà phát triển có thể hỗ trợ danh sách các thao tác do người gửi khởi tạo như tải, phát, tạm dừng và tìm kiếm, nơi SDK truyền xử lý các tương tác với nội dung đa phương tiện. Để xem danh sách các thao tác được hỗ trợ, hãy tham khảo tài liệu tham khảo API dành cho người gửi cho nền tảng của ứng dụng: RemoteMediaClient trong Android Sender, GCKMediaControlChannel trong iOS Sender và Media trong Web Sender.

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

Google Cast hỗ trợ đầy đủ tính năng Chia sẻ tài nguyên trên nhiều nguồn gốc (CORS). Hiện câu trả lời theo thời gian thực khác với hầu hết các giao thức dựa trên tệp, truy cập nội dung theo cách không đồng bộ thông qua XMLHttpRequest. Trong môi trường CORS, những yêu cầu này được bảo vệ chống lại truy cập không phù hợp theo tiêu đề CORS từ máy chủ nơi tài nguyên bắt nguồn. Điều này có nghĩa là máy chủ nội dung của bạn có quyền quyết định nơi có thể xuất hiện nội dung đó bao gồm. Hầu hết các trình duyệt hiện đại đều hỗ trợ đầy đủ CORS. Thiết bị iOS và Android truy cập nội dung ở cấp độ thấp hơn và đừng xem những tiêu đề này. Đây là thường là vấn đề đầu tiên xảy ra khi nhà phát triển muốn sử dụng tính năng truyền trực tuyến nội dung. Xem bài viết Chia sẻ tài nguyên trên nhiều nguồn gốc để chi tiết.

Trước
Bộ thu đa phương tiện đã tạo kiểu
Tiếp
Tính năng chính