Bộ thu web tùy chỉnh

Bắt đầu nhảy – Mã để tạo một Bộ thu web tùy chỉnh trên web rất đơn giản. Hãy chuyển đến phần trước để đăng ký ứng dụng Bộ thu web, sau đó tạo ứng dụng Bộ thu web cơ bản.

SDK Bộ thu web 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 liền mạch và dễ dàng. Gói này cung cấp tính năng hỗ trợ sẵn có cho Trợ lý Google cũng như các tính năng dành riêng cho Cast được hỗ trợ tự động trên tất cả thiết bị gửi và thiết bị hỗ trợ thao tác chạm. Khi các tính năng mới được phát hành, chúng sẽ tiếp tục được hỗ trợ mà không cần thay đổi thêm cho người gửi.

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

SDK Google Web receiver

Ứng dụng Bộ thu web của bạn truy cập API Bộ thu web với tham chiếu sau đây:

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

Các phương pháp hay nhất về giao thức URL: Xin lưu ý rằng URL ở trên không chỉ định giao thức "http:" hoặc "https:". Việc bỏ qua các giao thức này khi tạo nguồn tài nguyên cast_receiver_framework.js sẽ 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 với máy chủ lưu trữ ứng dụng Bộ thu web. Điều này có nghĩa là việc chuyển đổi giữa HTTP để phát triển và HTTPS cho sản xuất là minh bạch và không yêu cầu thay đổi mã. (Ứng dụng Bộ thu web đã xuất bản phải được lưu trữ trên máy chủ có hỗ trợ TLS).

Bản xem trước SDK

Bạn cũng có thể sử dụng phiên bản phát hành trước của SDK Đầu thu web phát trực tiếp trong thử nghiệm các ứng dụng không chính thức. Bạn có thể tìm thêm thông tin về URL xem trước SDK tại URL xem trước SDK bộ thu web Google Cast.

Vòng đời ứng dụng

Vòng đời của ứng dụng Bộ thu web bắt đầu từ thời điểm Bộ thu web được tải vào thiết bị Truyền và tiếp tục dẫn đến thời điểm ứng dụng được chia nhỏ và thiết bị Truyền quay trở lại trạng thái mặc định.

Trong suốt vòng đời của một ứng dụng Bộ thu web, tin nhắn được trao đổi giữa Bộ thu web và mọi ứng dụng người gửi được kết nối. Ứng dụng 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 một mã ứng dụng cụ thể. Điều này bắt đầu vòng đời của Bộ thu web, vì thiết bị Google Cast sẽ cố gắng tải ứng dụng Bộ thu web. Giả sử không có vấn đề về mạng, ứng dụng Bộ thu 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 mã ứng dụng. Sau khi tải, ứng dụng Bộ thu web sẽ thực hiện các thao tác thiết lập và cho biết rằng ứng dụng đã sẵn sàng xử lý thư từ mọi ứng dụng người gửi được kết nối.

Ứng dụng Bộ thu web có thể phân giải (kết thúc vòng đời hiện tại và đóng ứng dụng) trong các điều kiện sau:

  • Ứng dụng Web receiver sẽ nhận được thông báo rõ ràng từ người gửi được kết nối gần đây nhất để kết thúc phiên sử dụng.
  • Ứng dụng Web receiver ở trạng thái rảnh trong một khoảng thời gian nhất định mà không có người gửi nào đượ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 đã bắt đầu.
  • Bộ thu web gặp lỗi nghiêm trọng trong vòng đời thông thường của nó.

SDK bộ thu web xử lý mọi trường hợp phổ biến theo nguyên tắc trải nghiệm người dùng của chúng tôi.

Các lớp chính

Khung SDK của Bộ thu dữ liệu web có 2 lớp chính:

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

    • Đặt tùy chọn cấu hình ứng dụng
    • Xử lý sự kiện của hệ thống (chẳng hạn như người gửi đã kết nối hoặc bị ngắt kết nối)
    • Tạo kênh tùy chỉnh
    • Bắt đầu truyền thông tin
  • cast.framework.PlayerManager – Quản lý tính năng phát nội dung đa phương tiện. Thư viện này xử lý trình phát và phần tử nội dung đa phương tiện cơ bản theo yêu cầu của 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 việc phát video của người gửi
    • Xử lý sự kiện liên quan đến việc phát video

Đăng ký ứng dụng Bộ thu web

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

Tạo ứng dụng Bộ thu web cơ bản

Sau đây là cấu trúc chính của ứng dụng Bộ thu web cơ bản không tuỳ chỉnh:

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

Dưới đây là mã tối thiểu cho một ứng dụng Bộ thu web bằng cách sử dụng Khung ứng dụng truyền mà không cần tuỳ chỉnh. Bạn có thể sao chép và dán đúng tập lệnh này vào ứng dụng để tạo ứng dụng Bộ thu web.

<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 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 phương tiện và nhấn vào Play. Hoạt động này sẽ yêu cầu Bộ thu web truyền trực tuyến nội dung nghe nhìn đến TV để người dùng xem.

So sánh Trình thu thập dữ liệu web cơ bản này với ứng dụng bộ thu tuỳ chỉnh.

Nội dung đa phương tiện và trình phát

Khung Truyền 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ợ tính năng phát cho các giao thức truyền trực tuyến như MPEG-DASH, HLS và Phát trực tuyến mượt mà.

Một tập hợp các bộ mã hoá và giải mã nội dung nghe nhìn được hỗ trợ sẽ có trong phần Nội dung nghe nhìn được hỗ trợ. Thông qua tính năng gửi thông báo Truyền, 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à tua, trong đó SDK truyền xử lý các hoạt động tương tác với nội dung nghe nhìn. Để biết danh sách các thao tác được hỗ trợ, hãy tham khảo tài liệu tham khảo API người gửi cho nền tảng của ứng dụng: RemoteMediaClient trong Trình gửi Android, GCKMediaControlChannel trong Trình gửi iOSMedia trong Trình gửi web.

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). Giao thức truyền trực tuyến, không giống như hầu hết các giao thức dựa trên tệp, truy cập vào nội dung theo cách không đồng bộ bằng XMLHttpRequest. Trong thế giới CORS, các yêu cầu này được bảo vệ để tránh truy cập không phù hợp bằng tiêu đề CORS từ máy chủ nơi tài nguyên xuất phát. Tức là máy chủ nội dung của bạn có ý kiến về vị trí được đưa vào. Hầu hết các trình duyệt hiện đại đều hỗ trợ đầy đủ CORS. Các thiết bị iOS và Android truy cập nội dung ở cấp độ thấp hơn và không xem các tiêu đề này. Đây thường là vấn đề đầu tiên xảy ra khi nhà phát triển muốn sử dụng nội dung truyền trực tuyến. Hãy xem phần Chia sẻ tài nguyên trên nhiều nguồn gốc để biết thông tin chi tiết.