개요
Cast 웹 수신기 SDK는 여러 웹 스트리밍 프로토콜을 사용하여 콘텐츠 재생을 지원합니다. 사용된 프로토콜에 따라 SDK는 콘텐츠 재생을 처리하는 플레이어를 로드합니다. HLS 콘텐츠의 경우 미디어 플레이어 라이브러리 (MPL)가 로드됩니다. DASH 콘텐츠의 경우 Shaka Player가 로드됩니다.
앞으로 Cast SDK 및 Shaka Player 엔지니어링팀은 Shaka Player에서 HLS 콘텐츠 재생 지원을 늘리기 위해 노력을 통합할 예정입니다. MPL은 더 이상 중요 업데이트를 수신하지 않습니다. 애플리케이션의 HLS 콘텐츠 재생에 Shaka Player를 사용하도록 선택하는 것이 좋습니다.
Shaka Player 이점
플레이어를 변경할 때 애플리케이션은 다음과 같은 이점을 활용합니다.
- 로드 시간 오류 및 지연 시간 개선으로 사용자를 위한 더욱 강력한 스트리밍 세션
- 최신 HLS 기능의 지속적인 채택
- Shaka Player의 오픈소스 특성으로 인해 플레이어-콘텐츠 호환성 문제에 대한 근본 원인 분석의 명확성 향상
- 오픈소스 플레이어 코드베이스를 통해 파트너는 기여할 수 있습니다.
- Shaka Player's release cadence is frequent and independent of the Web Receiver SDK's releases as 프로덕션에 대한 기능 및 버그 수정 시간의 상당한 단축
- 재생 환경에 대한 더 큰 제어를 제공하는
shakaVersionAPI. - Google의 재생 지원 증가 로드맵에서 볼 수 있듯이 Shaka Player에서 HLS 재생에 중점을 둔 엔지니어링 리소스를 통해 .
타임라인
웹 수신기 SDK는 HLS 콘텐츠 재생의 기본 플레이어로 Shaka Player를 사용하도록 전환됩니다. 이는 파트너에게 이전 프로세스를 안내하기 위해 단계적 접근 방식으로 진행됩니다.
| 단계 | 시작일 | 개요 |
|---|---|---|
| 1 | 2022년 10월 | Cast 웹 수신기 SDK는 Shaka Player에서 HLS 콘텐츠를 재생하도록 선택하는 API를 도입 했습니다. |
| 2 | 2026년 5월 18일 | 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를 선택하는 모든 애플리케이션은 최신 HLS 개선사항을 활용하기 위해 Shaka Player 버전을 최소 4.15.35로 설정해야 합니다. 선택하려면 아래의 코드 스니펫을 따르세요.
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 또는 기본 스트림
- 불연속 또는 삽입된 광고가 있는 콘텐츠
- 다음 기기 유형에서 재생: 스마트 디스플레이, Google Cast 동글, Android TV 기기, Google Cast가 있는 TV, 스마트 스피커
오류 또는 예기치 않은 동작이 발견되면 버그를 신고하세요. 콘텐츠에 중요한 재생 오류가 없는지 확인한 후 변경사항을 프로덕션 환경에 푸시합니다.
선택 해제
웹 수신기 SDK는 타임라인에 따라 Shaka Player HLS
콘텐츠 재생을 위한 선택 해제 모델로 전환됩니다. 속성
useShakaForHls은 기본값
을 false에서 true로 변경합니다. 이때 애플리케이션은 이 속성을 false로 직접 설정하여 HLS 재생에 MPL을 사용하도록 선택할 수 있습니다. 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은 더 이상 중요 업데이트를 수신하지 않습니다. MPL에 문제가 발생하면 가이드의 선택 섹션에 있는 단계에 따라 Shaka Player로 전환하면 문제가 해결되는지 확인하세요. 문제가 계속되거나 플레이어를 전환할 때 다른 문제가 발생하는 경우 아래 단계를 따르세요.
shakaVersion을(를) 다른 브랜치 버전으로 설정하여 문제를 해결해 보세요. 예를 들어4.15브랜치에서 문제가 발생하는 경우 다른 브랜치의 최신 출시로 설정해 보세요. Shaka Player 출시 노트를 확인하여 가장 관련성이 높은 업데이트가 포함된 출시를 찾으세요.shakaVersionAPI에는 참조 문서에 자세히 설명된 대로 지원되는 최소 버전과 최대 버전이 있습니다. 회귀가 관찰되면 Shaka Player Issue Tracker에서 문제를 신고하세요.- 플레이어 구성 매개변수를 변경해 보세요. Shaka Player는
PlayerConfiguration객체를 통해 구성할 수 있습니다. 웹 수신기 SDK는 기본값 집합을 정의하고 애플리케이션이shakaConfig속성을 통해 이 구성을 수정할 수 있도록 합니다.PlaybackConfig객체 이는 플레이어 인스턴스가 생성될 때 로드 시간 중에 평가됩니다. 애플리케이션 구성 및 옵션에서 자세히 알아보세요. 웹 수신기 SDK에서 설정한 기본값은 권장되는 값입니다. - Shaka Player Issue Tracker 또는 Cast Issue Tracker에서 문제가 신고되었는지 확인하세요. 버그에 댓글을 달고 문제도 설명하는 경우 관련 정보를 추가하세요.
- Shaka Player 데모 사이트에서 콘텐츠를 테스트하세요. 콘텐츠의 데모 사이트에서 문제가 재현되는 경우 Shaka Player 프로젝트에 버그를 신고하세요.
- Cast Issue Tracker에 버그를 신고하세요. Cast 엔드포인트에서 Shaka Player에 고유한 문제가 있는 경우
FAQ
플레이어를 변경하면 많은 질문이 생길 수 있습니다. 아래에서 이전 프로세스를 안내하는 데 도움이 되는 가장 일반적인 질문에 대한 답변을 확인할 수 있습니다.
Shaka Player로 이전해야 하나요?
HLS 콘텐츠를 사용하는 파트너는 가능한 한 빨리 이전 프로세스를 시작하는 것이 좋습니다. 이렇게 하면 앱에서 사용자에게 더욱 강력한 스트리밍 환경을 제공할 수 있습니다. 자세한 내용은 이 가이드의 Shaka Player 혜택 섹션을 참고하세요. 파트너는 원활한 전환을 위해 Shaka Player를 사용하여 앱이 제대로 작동하는지 확인해야 합니다. 파트너가 사전에 Shaka Player에서 콘텐츠가 제대로 재생되는지 확인하지 않으면 웹 수신기 SDK 가 선택 해제 모델로 전환될 때 일부 앱이 위험에 처할 수 있습니다.
플레이어를 변경할 때 예상되는 노력 수준은 어느 정도인가요?
파트너는 테스트 환경에서 애플리케이션과 콘텐츠를 테스트하여 사용자 환경이 HLS와 비교했을 때 유사하거나 개선되었는지 확인해야 합니다. 이렇게 하려면 파트너는 내부 환경에서 이 기능을 선택하고 콘텐츠가 Shaka Player를 사용하여 재생될 수 있는지 철저히 테스트해야 합니다. 콘텐츠의 어떤 측면에 집중해야 하는지에 관한 자세한 내용은 콘텐츠 검사를 참고하세요. 검증이 완료되면 파트너는 프로덕션 애플리케이션 환경에서 선택 플래그를 추가하여 Shaka Player에서 제공하는 혜택을 활용하기 시작해야 합니다. 파트너가 성공적으로 이전하려면 최소한의 소프트웨어 개발 변경사항과 대부분의 QA 요구사항이 있습니다.
애플리케이션에서 곧 HLS를 사용하여 콘텐츠를 스트리밍할 예정인데 어떻게 해야 하나요?
새 통합은 재생에 Shaka Player를 사용하도록 선택해야 합니다. 애플리케이션은 장기적으로 더 잘 지원되며 새로운 HLS 기능과 성능 개선사항도 활용할 수 있습니다. 새 통합에 문제가 발생하는 경우 엔지니어링팀이 문제를 해결할 수 있는 충분한 시간을 확보할 수 있도록 최대한 빨리 버그를 신고하세요. 애플리케이션에 마감일이 임박한 경우 버그 보고서에 해당 정보와 영향을 포함하여 우선순위를 지정하세요. 엔지니어링팀은 사용자를 적절히 지원하는 솔루션을 제공하기 위해 노력할 것입니다.
콘텐츠 또는 앱이 Shaka Player에서 작동하지 않습니다. 어떻게 해야 하나요?
Shaka Player 프로젝트 또는 Cast 프로젝트에 버그를 신고해야 합니다 (문제 신고 참고). Cast SDK 엔지니어링팀은 이러한 트래커를 적극적으로 모니터링하고 있으며 당면한 문제를 해결하기 위해 파트너와 협력할 것입니다. 이러한 문제가 더 빨리 감지될수록 수정사항을 제공하는 데 더 많은 시간이 걸립니다.
MPL은 더 이상 중요 업데이트를 수신하지 않습니다. 정확히 무슨 뜻인가요?
이전에는 MPL이 중요 업데이트를 통해 새로운 HLS 기능을 채택하고 주요 버그를 패치했습니다. 이제 MPL이 더 이상 중요 업데이트를 수신하지 않으므로 새로운 HLS 기능이 플레이어에 추가되지 않습니다. 마찬가지로 MPL에서 HLS 재생에 대해 신고된 문제는 MPL에서 수정되지 않습니다. 이러한 문제는 재생을 위해 Shaka Player로 전환하여 해결해야 합니다. 문제가 계속되면 Shaka Player에서 발생한 관련 문제로 a 버그를 신고해야 합니다. 파트너는 MPL 사용을 중단해야 합니다.
콘텐츠에서 Smooth Streaming 프로토콜을 사용합니다. 애플리케이션에 어떤 영향을 미치나요?
MPL 바이너리는 계속 호스팅되며 수신기 애플리케이션에서 액세스할 수 있습니다. 하지만 Smooth Streaming 사양이 4년 넘게 업데이트되지 않았으므로 Smooth Streaming 관련 기능 요청 및 버그 수정은 지원되지 않습니다. 콘텐츠에 대한 성능 업데이트와 지원을 계속 받으려면 콘텐츠를 이전하여 DASH 또는 HLS 스트리밍 프로토콜을 사용하는 것이 좋습니다.
콘텐츠에서 HLS 또는 Smooth Stream 프로토콜을 사용하지 않습니다. 애플리케이션에 어떤 영향을 미치나요?
콘텐츠 라이브러리에서 이러한 스트리밍 프로토콜 중 하나를 사용하지 않는 경우 이전의 영향을 받지 않습니다. 애플리케이션에서 변경할 필요가 없습니다.