HLS trong quá trình di chuyển trình phát Shaka

Tổng quan

Cast Web receiver SDK hỗ trợ phát nội dung bằng cách sử dụng một số web phát trực tuyến. Dựa trên được sử dụng, SDK sẽ tải một trình phát để xử lý việc phát lại nội dung. Trong trường hợp nội dung HLS (Phát trực tuyến dựa trên HTTP), Thư viện trình phát nội dung đa phương tiện (MPL) sẽ được tải. Trong trường hợp Nội dung DASH, Shaka Player là đã tải xong.

Từ giờ trở đi, nhóm kỹ thuật của Cast SDK và Shaka Player sẽ hợp nhất những nỗ lực tăng khả năng hỗ trợ phát nội dung HLS trên Shaka Trình phát. MPL sẽ không còn nhận được những bản cập nhật quan trọng nữa. Bạn nên chọn sử dụng Shaka Player để phát nội dung HLS của ứng dụng.

Lợi ích của Shaka Player

Khi thay đổi trình phát, ứng dụng sẽ tận dụng những lợi ích sau:

  • Phiên truyền trực tuyến hiệu quả hơn cho người dùng, cùng với thời gian tải cải thiện lỗi và độ trễ.
  • Tiếp tục sử dụng các tính năng mới nhất của giao thức HLS.
  • Tăng tính rõ ràng trong bản phân tích nguyên nhân gốc cho nội dung của người chơi do bản chất nguồn mở của Shaka Player.
  • Cơ sở mã trình phát nguồn mở cho phép đối tác đóng góp vào Dự án Shaka Player.
  • Giảm đáng kể thời gian phát hành tính năng và sửa lỗi vì Bản phát hành của Shaka Player tần suất là thường xuyên và độc lập với các bản phát hành của Web receiver SDK.
  • Kiểm soát tốt hơn môi trường phát do API shakaVersion.
  • Tăng cường hỗ trợ phát lại của Google nhờ các tài nguyên kỹ thuật tập trung vào phát HLS trên Shaka Player như bạn thấy trên lộ trình.

Dòng thời gian

SDK Web receiver sẽ chuyển sang sử dụng Shaka Player làm trình phát mặc định để phát nội dung HLS. Việc này sẽ được thực hiện theo phương pháp từng giai đoạn để định hướng đối tác thông qua quá trình di chuyển.

Pha ban đầu Ngày bắt đầu Tổng quan
1 10/2022 SDK Cast Web receiver giới thiệu các API để chọn sử dụng nhằm phát nội dung HLS trên Shaka Player.
2 Nửa sau năm 2024 SDK Cast Web receiver thay đổi trình phát mặc định thành Shaka Player để phát nội dung HLS.

Nhóm kỹ sư SDK của Web receiver đang áp dụng phương pháp tiếp cận dựa trên hiệu suất và sẽ chỉ chuyển sang giai đoạn tiếp theo khi hiệu suất của Shaka Player ở trạng thái bật ngang bằng với hiệu suất cơ sở của MPL. Những thay đổi này sẽ được thông báo trong cast-sdk-announcements trên google group và được cập nhật trong hướng dẫn này.

Chọn nhận

Bắt đầu từ phiên bản CAF 3.0.0105, sẽ có một cấp ứng dụng cấu hình để chọn sử dụng sử dụng Shaka Player để phát lại HLS. Phiên bản này cũng giới thiệu một API để bạn chọn trong số nhiều phiên bản Shaka Player được hỗ trợ để tải. Những cờ này được cung cấp trong Lớp CastReceiverOptions thông qua lớp useShakaForHls và shakaVersion thuộc tính và sẽ được đánh giá khi CastReceiverContext đã khởi động. Mọi ứng dụng chọn sử dụng Shaka cho HLS nên thiết lập một phiên bản Shaka Player tối thiểu là 4.3.4 để tận dụng những cải tiến mới nhất về giao thức HLS. Để chọn sử dụng, hãy làm theo đoạn mã dưới đây:

const context = cast.framework.CastReceiverContext.getInstance();

let castReceiverOptions = new cast.framework.CastReceiverOptions();
castReceiverOptions.useShakaForHls = true;

context.start(castReceiverOptions);

Xác thực nội dung

Đối tác nên xác thực việc phát nội dung trên Shaka Player trước khi chọn sử dụng Shaka Player trong ứng dụng phát hành chính thức. Bạn nên thử nghiệm cho mỗi các biến thể trong nội dung của bạn được liệt kê dưới đây:

  • Loại sự kiện phát trực tiếp: TRỰC TIẾP hoặc VOD
  • Định dạng vùng chứa: TS, MP4 hoặc luồng cơ bản
  • Nội dung có quảng cáo bị gián đoạn hoặc được nhúng
  • Phát trên các loại thiết bị sau: màn hình thông minh, thiết bị phần cứng Chromecast, Thiết bị Android TV, TV có loa thông minh và tích hợp Chromecast

Nếu bạn phát hiện bất kỳ lỗi hoặc hành vi không mong muốn nào, hãy báo cáo lỗi. Sau khi bạn có thể xác minh rằng không có lỗi phát lại nghiêm trọng nào trong thiết bị của mình hãy áp dụng các thay đổi vào môi trường sản xuất.

Chọn không tham gia

Web receiver SDK sẽ chuyển sang mô hình chọn không sử dụng cho Shaka Player HLS phát nội dung theo tiến trình. Cơ sở lưu trú useShakaForHls sẽ thay đổi giá trị mặc định từ false đến true. Khi đó, ứng dụng có thể chọn sử dụng MPL cho HLS phát lại bằng cách đặt thuộc tính này thành false theo cách thủ công. Khi CastReceiverContext đã khởi động, SDK Web receiver sẽ quay về trạng thái tải MPL thay vì Shaka Player. Hãy xem mẫu bên dưới để biết cách chọn không sử dụng:

const context = cast.framework.CastReceiverContext.getInstance();

let castReceiverOptions = new cast.framework.CastReceiverOptions();
castReceiverOptions.useShakaForHls = false;

context.start(castReceiverOptions);

Báo cáo sự cố

Các đối tác nên báo cáo mọi vấn đề họ phát hiện được khi phát HLS nội dung. Như đã đề cập, MPL sẽ không còn nhận được các bản cập nhật quan trọng nữa. Nếu có gặp vấn đề với MPL, hãy làm theo các bước trong phần Chọn sử dụng của hướng dẫn này để xác minh xem việc chuyển sang Shaka Player có bỏ chặn vấn đề. Hãy làm theo các bước bên dưới nếu vấn đề vẫn tiếp diễn hoặc nếu bạn gặp phải một vấn đề khác khi chuyển đổi người chơi.

  1. Hãy thử đặt shakaVersion thành phiên bản nhánh khác để giải quyết vấn đề này. Ví dụ: nếu vấn đề đã xảy ra trên nhánh 4.3, hãy thử đặt thành bản phát hành mới nhất trong phiên bản 4.2.x hoặc 3.3.x. Kiểm tra bản phát hành Shaaka Player ghi chú để tìm bản phát hành có nội dung cập nhật phù hợp nhất. Lưu ý rằng shakaVersion API có giá trị tối thiểu và tối đa được hỗ trợ như đã nêu chi tiết trong tài liệu tham khảo. Nếu bạn quan sát thấy có sự hồi quy, hãy báo cáo vấn đề trong Trình phát SSH công cụ theo dõi lỗi.

  2. Hãy thử thay đổi các thông số cấu hình trình phát. Shaka Player là có thể định cấu hình thông qua Đối tượng PlayerConfiguration. Web SDK bộ nhận xác định một tập hợp các giá trị mặc định và cho phép các ứng dụng sửa đổi cấu hình này thông qua Thuộc tính shakaConfig trong PlaybackConfig . Điều này được đánh giá trong thời gian tải khi thực thể trình phát được đã tạo. Xem thêm trong

    cấu hình ứng dụng và . Mặc định các giá trị do Web nhận SDK đặt là các giá trị được đề xuất.

  3. Xem liệu vấn đề đó đã được báo cáo trong Công cụ theo dõi lỗi của Trình phát Shaaka hoặc Truyền công cụ theo dõi lỗi. Nhận xét về lỗi và thêm mọi thông tin liên quan nếu tài liệu đó cũng mô tả vấn đề của bạn.

  4. Kiểm tra nội dung của bạn trên trang web minh hoạ của Shaaka Player. Nếu bạn phát hiện thấy vấn đề tái tạo trong trang web minh hoạ cho nội dung của bạn, hãy gửi lỗi với dự án Shaka Player.

  5. Báo lỗi trong Công cụ theo dõi sự cố truyền nếu bạn có một vấn đề duy nhất đối với Shaka Player trên các thiết bị đầu cuối truyền.

Câu hỏi thường gặp

Việc thay đổi người chơi có thể dấy lên nhiều câu hỏi. Dưới đây, bạn sẽ tìm thấy giúp giải đáp các câu hỏi thường gặp để hướng dẫn bạn trong suốt quá trình di chuyển.

Tôi có nên chuyển sang Shaka Player không?

Những đối tác sử dụng nội dung HLS nên bắt đầu quá trình di chuyển sớm nhất có thể. Do đó, ứng dụng của bạn sẽ cung cấp một quy trình truyền trực tuyến mạnh mẽ hơn cho người dùng. Bạn có thể xem thêm nhiều lợi ích trong bài viết Trình phát SSH các lợi ích của hướng dẫn này. Đối tác cần xác minh ứng dụng của họ đang hoạt động đúng cách bằng cách sử dụng Shaka Player để đảm bảo chuyển đổi. Một số ứng dụng có thể gặp rủi ro về khi SDK Bộ nhận web chuyển đổi sang mô hình chọn không tham gia nếu đối tác không xác minh nội dung của họ phát đúng cách trên Shaka Player trước thời hạn.

Mức độ nỗ lực dự kiến khi thay đổi người chơi là bao nhiêu?

Đối tác cần thử nghiệm đơn đăng ký và nội dung của mình trong môi trường thử nghiệm để đảm bảo trải nghiệm người dùng tương tự hoặc được cải thiện khi so sánh với HLS. Để làm được việc này, đối tác cần phải chọn sử dụng tính năng này trong môi trường nội bộ và kiểm tra kỹ lưỡng để đảm bảo nội dung của họ có thể chơi bằng Shaka Player. Xem phần xác thực nội dung để biết thông tin chi tiết về bạn cần tập trung vào khía cạnh nào của nội dung. Sau khi được xác thực, đối tác cần phải thêm cờ để chọn tham gia trong môi trường ứng dụng phát hành chính thức để bắt đầu tận dụng các lợi ích do Shaka Player cung cấp. Ở mức độ cao, là những thay đổi rất nhỏ trong quá trình phát triển phần mềm và chủ yếu là yêu cầu đảm bảo chất lượng đối với đối tác để di chuyển thành công.

Ứng dụng của tôi sẽ sớm sử dụng HLS để phát trực tuyến nội dung, tôi nên làm gì?

Người dùng mới nên chọn sử dụng Shaka Player để phát nội dung tích hợp mới. Thông tin đơn đăng ký sẽ được hỗ trợ tốt hơn về lâu dài và cũng sẽ mất tận dụng các tính năng HLS mới và cải tiến hiệu suất. Nếu khách hàng mới đang gặp sự cố khi tích hợp, hãy gửi lỗi sớm nhất có thể để nhóm kỹ thuật có đủ thời gian để giải quyết sự cố. Nếu ứng dụng của bạn có đúng thời hạn, đưa thông tin đó vào báo cáo lỗi cũng như tác động để sắp xếp mức độ ưu tiên phù hợp. Nhóm kỹ thuật của chúng tôi sẽ làm việc để cung cấp giải pháp để hỗ trợ đầy đủ cho người dùng của bạn.

Nội dung hoặc ứng dụng của tôi không hoạt động với Shaka Player, bây giờ tôi phải làm gì?

Bạn nên báo cáo lỗi bằng Dự án Shaka Player hoặc dự án Cast (xem phần Báo cáo vấn đề). Nhóm kỹ thuật SDK Truyền đang tích cực theo dõi những thiết bị theo dõi này và sẽ phối hợp với bạn để giải quyết mọi vấn đề đang xảy ra. Càng phát hiện sớm những vấn đề này, bạn càng có nhiều thời gian để xử lý cung cấp bản sửa lỗi.

MPL không còn nhận được các bản cập nhật quan trọng nữa, chính xác thì điều đó có nghĩa là gì?

Trước đây, MPL sử dụng các tính năng HLS mới và vá các lỗi lớn thông qua các bản cập nhật quan trọng. Giờ đây, MPL sẽ không còn nhận được các giao thức truyền dữ liệu, giao thức HLS mới các tính năng sẽ không được thêm vào trình phát. Tương tự, mọi vấn đề được báo cáo cho HLS việc phát lại trên MPL sẽ không được khắc phục ở MPL. Các vấn đề này sẽ được giải quyết chậm nhất vào chuyển sang Shaka Player để phát lại. Nếu vấn đề vẫn tiếp diễn, thì lỗi phải được gửi cùng với(các) vấn đề liên quan mà Shaka gặp phải Trình phát. Đối tác không nên sử dụng MPL.

Nội dung của tôi sử dụng giao thức mooth Streaming, điều này ảnh hưởng như thế nào đến ứng dụng của tôi?

Tệp nhị phân MPL vẫn sẽ được lưu trữ và người nhận của bạn có thể truy cập được . Tuy nhiên, mọi lỗi và yêu cầu tính năng liên quan đến tính năng Truyền phát mượt mà sẽ không được hỗ trợ vì Thông số kỹ thuật cho tính năng Phát trực tuyến mượt mà chưa được cập nhật trong trong hơn 4 năm. Bạn nên di chuyển nội dung để sử dụng DASH hoặc HLS trực tuyến để tiếp tục nhận thông tin cập nhật về hiệu suất và dịch vụ hỗ trợ cho nội dung của bạn.

Nội dung của tôi không sử dụng giao thức HLS (Phát trực tuyến dựa trên HTTP) hoặc đàn (Luồng) êm ái. Việc này ảnh hưởng như thế nào đến ứng dụng của tôi?

Nếu thư viện nội dung của bạn không dùng giao thức phát trực tuyến nào trong số đó, bạn sẽ không bị ảnh hưởng bởi việc di chuyển. Bạn không cần thay đổi gì trong .

Trước
Tính năng chính
Tiếp
Định kiểu cho trình phát