이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Shaka 플레이어 이전 시 HLS

개요

Cast Web Receiver SDK는 여러 웹을 통한 콘텐츠 재생을 지원합니다. 스트리밍 프로토콜을 참조하세요. 기준: 프로토콜이 사용되면 SDK는 플레이어를 로드하여 콘텐츠 재생을 처리합니다. HLS 콘텐츠의 경우 미디어 플레이어 라이브러리 (MPL)가 로드됩니다. 만약 DASH 콘텐츠, 샤카 플레이어는 있습니다.

앞으로 Cast SDK와 Shaka Player 엔지니어링팀은 Shaka에서 HLS 콘텐츠 재생 지원을 늘리기 위한 통합 노력 플레이어를 탭합니다. MPL은 더 이상 중요 업데이트를 받지 않습니다. Google에서는 Shaka Player를 사용할 수 있습니다.

Shaka Player의 이점

플레이어 수가 변화함에 따라 애플리케이션은 다음과 같은 이점을 활용할 수 있습니다.

사용자를 위한 더욱 강력한 스트리밍 세션 및 로드 시간 개선 장애 및 지연 시간을 단축할 수 있습니다
최신 HLS 기능 계속 채택.
플레이어 콘텐츠에 대한 근본 원인 분석의 명확성 개선 Shaka Player의 오픈소스 특성으로 인한 호환성 문제
파트너는 오픈소스 플레이어 코드베이스를 사용하여 다음 작업을 할 수 있습니다. Shaka Player 프로젝트에 contribute합니다.
덕분에 프로덕션에 이르는 기능 및 버그 수정 시간이 크게 단축됩니다. Shaka Player의 발표 주기가 빈번함 웹 수신기 SDK의 출시와는 별개입니다.
재생 환경에 대한 제어 기능 향상: shakaVersion API
엔지니어링 리소스를 통해 Google의 재생 지원 확대 Shaka Player의 HLS 재생에 중점을 두었습니다. roadmap도 사용할 수 있습니다.

타임라인

Web Receiver SDK가 Shaka Player를 기본 플레이어로 사용하도록 전환됩니다. 사용할 수 있습니다. 이는 단계별 접근 방식으로 수행되며 파트너의 도움을 받을 수 있습니다.

단계	시작일	개요
1	2022년 10월	Cast 웹 수신기 SDK는 Shaka Player에서 HLS 콘텐츠를 재생하도록 선택하는 API를 도입합니다.
2	2024년 하반기	Cast 웹 수신기 SDK는 HLS 콘텐츠 재생을 위해 기본 플레이어를 Shaka Player로 변경합니다.

웹 수신기 SDK 엔지니어링팀은 성능 중심 접근 방식을 취하고 있습니다 Shaka Player의 성능이 켜져 있을 때만 다음 단계로 넘어갑니다. MPL의 기준 성능과 동등한 수준입니다. 이러한 변경사항은 cast-sdk-announcements Google 그룹 및 업데이트 이 가이드를 참고하세요.

선택

CAF 버전 3.0.0105부터 애플리케이션 수준이 있습니다. 구성을 선택하여 HLS 재생에 Shaka Player를 사용하도록 합니다. 이 버전 지원되는 다양한 Shaka Player 버전에서 선택할 수 있는 API도 도입되었습니다. 있습니다. 이러한 플래그는 CastReceiverOptions 클래스를 통해 useShakaForHls 및 shakaVersion 속성을 사용하고 CastReceiverContext가 시작됩니다. HLS를 위해 Shaka를 선택하는 모든 애플리케이션 Shaka Player 버전을 4.3.4 이상으로 설정하여 최신 HLS 개선사항을 확인하세요. 선택하려면 다음 코드 스니펫을 따르세요.

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

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

context.start(castReceiverOptions);

콘텐츠 유효성 검사

파트너는 선택 전에 Shaka Player에서 콘텐츠 재생을 확인해야 합니다. Shaka Player를 사용할 것을 기대하고 있습니다. 각 포드에 대해 다음과 같은 유사 콘텐츠를 확인해 보세요.

스트림 유형: 라이브 또는 VOD
컨테이너 형식: TS, MP4, 기본 스트림
불연속적이거나 삽입된 광고가 포함된 콘텐츠
스마트 디스플레이, Chromecast 동글, Android TV 기기, Chromecast 내장 TV, 스마트 스피커

오류나 예기치 않은 동작을 발견하면 버그를 신고하세요. 페이지에 심각한 재생 실패가 없는지 확인한 후 프로덕션 환경으로 변경사항을 푸시합니다.

선택 해제

웹 수신기 SDK가 Shaka Player HLS의 선택 해제 모델로 전환됩니다. 타임라인에 따라 콘텐츠가 재생됩니다. 속성 useShakaForHls에서 기본값을 변경합니다. false부터 true까지입니다. 이때 애플리케이션은 HLS에 MPL을 사용하도록 선택할 수 있습니다. 이 속성을 false로 수동 설정하여 재생할 수 없습니다. 이 CastReceiverContext가 시작되면 웹 수신기 SDK가 로드로 되돌아갑니다. Shaka Player가 아닌 MPL입니다. 선택 해제 방법은 아래 샘플을 참고하세요.

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

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

context.start(castReceiverOptions);

문제 신고

파트너는 HLS 재생 시 발견된 문제를 신고하는 것이 좋습니다. 있습니다. 앞서 언급한 바와 같이 MPL은 더 이상 중요 업데이트를 받지 않습니다. 해당되는 경우 문제가 발생하는 경우 선택 섹션에서 Shaka Player로 전환하면 있습니다. 문제가 해결되지 않거나 오류가 발생하면 아래 단계를 따르세요. 다른 문제가 있다는 것입니다.

shakaVersion을(를) 다른 브랜치 버전을 사용하여 문제를 해결합니다. 예를 들어 문제가 4.3 브랜치에서 지원되고 있는 경우 다음 위치에서 최신 버전으로 설정해 보세요. 4.2.x 또는 3.3.x 버전 Shaka Player 릴리스를 확인합니다. 메모를 사용하여 최신 버전으로 업데이트하시기 바랍니다. Note that the shakaVersion API에는 최솟값과 최댓값이 있습니다. 지원되는 버전을 확인하세요. 만약 회귀가 있는 경우 Shaka Player Issue Tracker를 사용합니다.
플레이어 구성 매개변수를 변경해 보세요. 샤카 플레이어 구성 가능한 PlayerConfiguration 객체 웹 수신기 SDK는 기본값 집합을 정의하고 애플리케이션이 다음 작업을 할 수 있도록 합니다. 이 구성을 수정할 수 있습니다. PlaybackConfig의 shakaConfig 속성 객체를 지정합니다. 이는 플레이어 인스턴스가 생성됨. 더보기:

애플리케이션 구성과 옵션을 참조하세요. 기본값 권장 값은 웹 수신기 SDK에서 설정한 값입니다.
이 문제가 Shaka Player Issue Tracker 또는 Cast Issue Tracker를 사용하세요. 버그에 댓글을 달고 관련된 문제 추가 문제를 설명하는 경우에는 이 정보가 포함됩니다
Shaka Player 데모 사이트에서 콘텐츠를 테스트합니다. 만약 데모 사이트에서 콘텐츠에 대한 문제가 재현되는지 확인한 후 버그를 반환합니다.
다음과 같은 경우 Cast Issue Tracker에서 버그를 신고하세요. 전송 엔드포인트에서 Shaka Player 고유 문제가 발생하는 경우

FAQ

플레이어 변경은 많은 궁금증을 불러일으킬 수 있습니다. 아래에서 가장 많이 이전 프로세스를 안내하는 데 도움이 되는 일반적인 질문에 대한 답변을 제공합니다.

Shaka Player로 이전해야 하나요?

HLS 콘텐츠를 사용하는 파트너는 다음과 같이 이전 프로세스를 시작하는 것이 좋습니다. 가능한 한 빨리. 결과적으로 앱은 보다 안정적인 스트리밍을 제공할 것입니다. 개선할 수 있습니다 자세한 이점은 샤카 플레이어 혜택 섹션에 나와 있습니다. 파트너는 확인해야 함 Shaka Player를 사용하여 앱이 제대로 작동하는지 확인하고, 있습니다. 일부 앱은 Web Receiver SDK가 인증하지 않으면 거부 모델로 전환 콘텐츠가 Shaka Player에서 제대로 재생되는지 확인합니다.

플레이어를 변경할 때 예상되는 노력 수준은 어느 정도인가요?

파트너는 테스트 환경에서 애플리케이션과 콘텐츠를 테스트해야 합니다. 하여 HLS와 비교할 때 사용자 환경이 비슷하거나 개선되도록 합니다. 이를 위해 파트너는 동영상을 재생할 수 있는지 철저히 테스트해야 합니다 Shaka Player를 사용합니다. 다음에 대한 자세한 내용은 콘텐츠 유효성 검사를 참조하세요. 콘텐츠의 어떤 측면에 집중해야 하는지 알아보겠습니다 검증 후 파트너는 다음을 수행해야 합니다. 프로덕션 애플리케이션 환경에서 선택하여 플래그를 추가하여 Shaka Player의 이점을 활용합니다. 개략적으로 설명하자면 최소한의 소프트웨어 개발 변경이고 Google Cloud 파트너가 성공적으로 마이그레이션할 수 있습니다

내 애플리케이션에서 곧 HLS를 사용하여 콘텐츠를 스트리밍할 예정입니다. 어떻게 해야 하나요?

새 통합에서는 재생에 Shaka Player를 사용하도록 선택해야 합니다. 내 장기적으로 더 많은 지원을 받을 수 있을 것이며 새로운 HLS 기능을 활용하고 성능을 향상할 수 있습니다. 새 통합에 문제가 발생하면 가능한 한 빨리 버그를 제출하여 충분한 시간을 두고 문제를 해결할 수 있습니다. 애플리케이션에 마감 기한이 촉박한 경우 버그 신고에 해당 정보를 제공하고 우선순위를 지정할 수 있습니다 Google 엔지니어링팀이 해결책을 찾기 위해 노력할 것입니다. 사용자를 충분히 지원하기 위해 사용하는 것이 좋습니다

콘텐츠나 앱이 Shaka Player와 호환되지 않습니다. 어떻게 해야 하나요?

Shaka Player 프로젝트 또는 Cast 프로젝트에 버그를 신고해야 합니다. (문제 신고 참고). Cast SDK 엔지니어링팀은 이러한 추적기의 모니터링을 통해 당면한 문제를 해결하기 위해 사용자와 협력합니다. 이러한 문제가 일찍 발견될수록 문제 해결에 더 많은 도움이 될 수 있습니다

MPL에서 더 이상 중요 업데이트를 수신하지 않습니다. 이는 정확히 무엇을 의미하나요?

지금까지 MPL은 새로운 HLS 기능을 채택했으며 중요 업데이트 이제 MPL에서 더 이상 메시지를 수신하지 않게 됨에 따라 새로운 HLS 기능이 플레이어에 추가되지 않습니다. 마찬가지로 HLS에 대해 보고된 모든 문제는 MPL에서의 재생은 MPL에서 수정되지 않습니다. 이러한 문제는 재생할 수 있도록 Shaka Player로 전환됩니다. 문제가 지속되면 버그를 신고해야 하는 경우 Shaka에 발생한 관련 문제와 함께 신고해야 합니다. 플레이어를 탭합니다. 파트너는 MPL 사용을 피해야 합니다.

내 콘텐츠에서 스무스 스트리밍 프로토콜을 사용하는데 애플리케이션에 어떤 영향을 주나요?

MPL 바이너리는 여전히 호스팅되며 수신자에서 액세스할 수 있습니다. 애플리케이션입니다. 하지만 원활한 스트리밍 관련 기능 요청 및 버그는 수정사항은 원활한 스트리밍 사양은 다음 기간 동안 업데이트되지 않았습니다. 4년이 넘었습니다. DASH 또는 HLS를 사용하려면 콘텐츠를 이전하는 것이 좋습니다. 계속해서 성능 업데이트를 수신하고 있습니다.

내 콘텐츠가 HLS 또는 Smooth Stream 프로토콜을 사용하지 않는데 이것이 애플리케이션에 어떤 영향을 주나요?

콘텐츠 라이브러리가 이러한 스트리밍 프로토콜 중 하나를 사용하지 않는다면 이전의 영향을 받지 않습니다. 다음 항목을 변경할 필요는 없습니다. 애플리케이션입니다.

핵심 기능

플레이어의 스타일 지정