Amazon IVS 플레이어 SDK

Amazon Interactive Video Service(IVS)를 사용하려면 Amazon IVS 플레이어를 사용해야 합니다. 플레이어는 Amazon IVS 스트림 재생을 위한 교차 플랫폼 SDK 제품군입니다. 플레이어는 Amazon IVS 아키텍처를 활용하도록 설계되었으며 Amazon IVS 재생에 최적화되어 있습니다.

성능을 보장할 수 있는 유일한 플레이어는 Amazon IVS 플레이어입니다. 지연 시간을 줄이려면 Amazon IVS 플레이어가 필요합니다.

Amazon IVS 플레이어의 주요 기능은 다음과 같습니다.

• 저지연 스트리밍 — 시청자 경험을 풍부하게 하는 우수한 대화형 사용자 경험을 구축하는 데 있어 지연 시간이 짧아야 합니다. 브로드캐스터와 시청자 간 전송 경로 전체에서 지연 시간이 점진적으로 발생하면 응답성이 저하됩니다.

  엔드 투 엔드 지연 시간은 카메라에 라이브 스트림이 캡처된 시점부터 시청자 화면에 표시될 때까지의 지연입니다. Amazon IVS는 매우 짧은 엔드 투 엔드 지연 시간 (브로드캐스트 위치 및 방송사 설정에 따라 5초 미만)을 제공하도록 설계되어 있습니다. 이 저지연을 달성하려면 Amazon IVS 플레이어가 필요합니다.

• 교차 플랫폼 일관성 - 시청자는 다양한 플랫폼에서 방송을 시청합니다. 모바일 디바이스부터 웹 브라우저에 이르기까지 Amazon IVS 플레이어는 모든 사용자에게 유사한 경험을 제공합니다. 모든 플랫폼이 동일한 플레이어 기능 라이브러리를 사용하기 때문에 이러한 일관성이 가능합니다. 플레이어 라이브러리는 Amazon IVS 아키텍처의 필수 구성 요소입니다. 하나의 비디오 스택을 사용하면 지연 시간이 짧은 모드, 시한 메타데이터, 분석, 오류 추적, 보고, 로깅 등 모든 비디오 재생 동작을 지원되는 모든 플랫폼에서 일관되게 사용할 수 있습니다.

• 가변 비트 전송률(ABR) 스트리밍 - Amazon IVS 플레이어는 지연 시간이 짧은 환경에 최적화된 ABR 알고리즘을 사용합니다. 플레이어는 실시간으로 서비스 품질 및 대역폭 가용성을 측정하고 비디오 품질과 버퍼 레벨을 조정하여 중단 없는 재생을 제공합니다. 연결 품질이 저하되면 ABR은 낮은 비트 전송률로 전환되고, 연결 품질이 향상되면 더 높은 비트 전송률로 전환됩니다.

• 시한 메타데이터 - Amazon IVS 플레이어는 설문 조사 및 퀴즈와 같은 대화형 요소를 구축하는 데 사용하는 시한 메타데이터를 지원합니다. 메타데이터는 다른 데이터를 설명하고 해당 데이터에 대한 정보를 제공하는 데이터의 집합입니다. '시한' 메타데이터에서는 스트림에 대한 데이터 조각과 함께 타임코드가 제공됩니다. 재생 중에 타임코드는 다음과 같은 데이터를 기반으로 작업을 트리거하는 큐 포인트 역할을 합니다.

  • 스포츠 스트림에 대한 플레이어 통계 전송

  • 라이브 쇼핑 스트림에 대한 제품 세부 정보 전송

  • 라이브 퀴즈 스트림에 대한 질문 전송

• 강력한 오류 처리 — 일시적인 오류를 처리하면 시청 경험이 중단되지 않도록 방지할 수 있습니다. Amazon IVS 플레이어의 강력한 오류 처리 기능은 많은 잠재적인 스트리밍 오류를 감지하여 대체 변환으로 자동 전환합니다. 시청자는 시정 조치를 취하지 않고도 브로드캐스트를 중단없이 계속 시청할 수 있습니다.

• 손쉬운 통합 - Amazon IVS 플레이어 API는 Amazon IVS 고객 애플리케이션 및 플레이어 라이브러리 간의 격차를 해소합니다. API에는 지원되는 모든 플랫폼에 대한 바인딩이 있으므로 익숙한 코딩 환경 및 기술을 사용하면서 플레이어를 애플리케이션에 쉽게 통합할 수 있습니다. 고객은 UI 요소를 완벽하게 제어하여 애플리케이션의 브랜딩 및 프레젠테이션을 사용자 지정할 수 있습니다.

Amazon IVS 플레이어는 Airplay를 사용한 캐스팅을 지원하지 않습니다. Chromecast를 사용한 캐스팅은 기본 Chromecast 수신기 앱을 사용하여 플레이어 외부에서 구현할 수 있습니다. 그러나 이러한 앱의 대기 시간은 Amazon IVS 플레이어 SDK보다 높기 때문에 전환이 원활하지 않습니다. 또한 Amazon IVS 브로드캐스트 SDK에 대한 설명서(지연 시간이 짧은 스트리밍 및 실시간 스트리밍)를 참조하세요.

브라우저 및 플랫폼 요구 사항

다양한 브라우저의 최신 릴리스 버전에 대한 자세한 내용은 다음을 참조하세요.

• Chrome 플랫폼 상태

• Firefox 릴리스

• Microsoft Edge 릴리스 일정

• Safari 릴리스 정보

Amazon IVS는 일부 이전 브라우저에서 작동할 수 있지만 이전 브라우저와 관련된 버그는 수정되지 않습니다.

IVS 플레이어 웹 SDK(Video.js 및 플레이어 JW 통합 포함)는 브라우저와 유사한 환경에서는 지원되지 않습니다. 여기에는 웹 애플리케이션을 지원하는 네이티브 WebViews 및 “10피트 디바이스” (TV, 콘솔, 셋톱 박스) 가 포함됩니다. 아래 나열된 표 이외의 특정 브라우저 지원에 대해 잘 모르는 경우 IVS 지원팀에 문의하세요.

데스크톱 브라우저

데스크톱 브라우저	지원되는 플랫폼	지원되는 버전
Chrome	Windows, macOS	두 가지 주요 버전(현재 및 최신 이전 버전)
Firefox	Windows, macOS	두 가지 주요 버전(현재 및 최신 이전 버전)
Edge	Windows 8.1 이상	44.0 이상 (자동 품질 모드에서 Microsoft Edge 레거시에서는 아주 짧은 지연 시간 재생이 아니라 정상 지연 시간 재생만 지원됩니다. 자동 품질 모드는 ABR 사용 여부를 나타냅니다. 예를 들어, 웹 플레이어에서 setAutoQualityMode를 참조하세요.
Safari	macOS	두 가지 주요 버전(현재 및 최신 이전 버전) (macOS 14 이상용 Safari의 자동 품질 모드에서 IVS 플레이어 1.3.0 이상은 대기 시간이 매우 짧은 재생을 지원합니다. 이전 버전의 Safari 및 IVS 플레이어에서는 일반 대기 시간 재생만 지원됩니다. 위의 ‘자동 품질 모드’를 참조하세요.)

모바일 브라우저

모바일 브라우저	지원되는 버전
iOS용 Chrome, iOS용 Safari	두 가지 주요 버전(현재 및 최신 이전 버전) (지연 시간이 매우 짧은 재생은 지원되지 않습니다. 일반 지연 시간 재생이 지원됩니다. 이 제약 조건은 iOS에 대해 모든 브라우저에 적용됩니다.) (플레이어 1.3.0 이상에서만 시한 메타데이터가 지원됩니다.)
iPadOS용 Chrome, iPadOS용 Safari	두 가지 주요 버전(현재 및 최신 이전 버전) (‘모바일 웹 사이트 요청(Request Mobile Website)’을 선택한 경우: 대기 시간이 매우 짧은 재생이 지원되지 않습니다. 플레이어 1.3.0 이상에서만 시한 메타데이터가 지원됩니다.)
Android용 Chrome	두 가지 주요 버전(현재 및 최신 이전 버전)

기본 플랫폼

플랫폼	지원되는 버전	지원되는 디바이스
Android	5.0(Lollipop) 이상	휴대폰 및 태블릿
iOS	12.0 이상	모두

IVS는 최소 4개의 주요 iOS 버전과 6개의 주요 Android 버전을 지원합니다. 현재 버전 지원은 이러한 최소 한도 이상으로 확장될 수 있습니다. 메이저 버전이 더 이상 지원되지 않을 경우 최소 3개월 전에 SDK 릴리스 노트를 통해 고객에게 알립니다.

타사 플레이어의 지연 시간 줄이기

기본 및 표준 채널 유형의 경우: 지연 시간을 가능한 한 최소화하려면 Amazon IVS 플레이어를 사용해야 합니다. 타사 플레이어(iOS Safari 포함)에서는 다음 구성을 사용하여 지연 시간을 약 10초 정도로 줄일 수 있습니다.

• 인코더(예: OBS)의 키프레임 간격을 2초 이하로 설정합니다.

• RTMP(S) URL에 ?keyframeInterval=2을 추가합니다. 예: rtmps://a1b2c3d4e5f6.global-contribute.live-video.net:443/app/sk_us-west-2_abcd1234efgh5678ijkl?keyframeInterval=2

참고: RTMP URL의 일부로 지정된 키프레임 간격은 인코더에 구성된 값보다 크거나 같아야 합니다. 그렇지 않으면 재생 문제가 발생할 수 있습니다. 값을 2~6 사이의 정수로 설정할 수 있지만 2를 사용하면 지연 시간이 가장 짧습니다.

고급 채널 유형의 경우: 위의 지침이 적용되지 않습니다. 고급 채널 유형에서는 소스 인코딩 키프레임 간격 설정과 관계없이 인코딩 효율성을 위해 키프레임 간 최대 2초의 키프레임 간격을 자동으로 생성합니다.

iOS Safari

iOS Safari에서는 IVS 플레이어를 사용하고 서비스 작업자를 사용하도록 구성하여 지연 시간을 약 6초~8초로 줄일 수 있습니다. 구현 세부 정보 및 참조 샘플은 Player SDK 웹 안내서에서 서비스 작업자 설정을 참조하세요.

참고: 지연 시간을 최소화하려면 키프레임 간격을 2초로 설정한 IVS 스트림이 필요합니다.

오디오 전용 재생

모든 IVS 채널 유형은 오디오 전용 렌디션을 지원합니다. 이는 모바일 애플리케이션에 특히 유용할 수 있습니다. 예를 들어 모바일 앱에서는 대역폭을 절약하기 위해 사용자가 애플리케이션을 백그라운드할 때 플레이어를 오디오 전용 변환으로 전환할 수 있습니다.

ADVANCED-SD 및 ADVANCED-HD 채널의 경우 오디오 전용 렌디션이 다변량 재생 목록에 자동으로 포함됩니다. BASIC 및 STANDARD 채널의 경우 오디오 전용 변환을 포함하려면 재생 URL에 쿼리 매개 변수를 추가해야 합니다. ?allow_audio_only=true

참고: IVS 웹 플레이어 SDK는 버전 1.24.0 이상에서만 오디오 전용 재생을 지원합니다.

지원

스트림에서 재생 오류나 기타 재생 문제가 발생하면 플레이어 API를 통해 고유한 재생 세션 식별자를 확인합니다.

이 Amazon IVS 플레이어의 경우:	다음을 사용하세요.
Android	sessionId 함수
iOS	IVSPlayer의 sessionId속성
웹	getSessionId 함수

이 재생 세션 식별자를 AWS Support와 공유합니다. 이를 통해 문제를 해결하는 데 도움이 되는 정보를 얻을 수 있습니다.

참고: 플레이어는 지속적으로 개선됩니다. Amazon IVS 출시 정보를 참조하여 사용 가능한 버전 및 해결된 문제를 확인하세요. 해당하는 경우 지원 센터에 문의하기 전에 플레이어 버전을 업데이트하고 문제가 해결되는지 확인합니다.

버전 관리

Amazon IVS 플레이어 SDK는 유의적 버저닝을 사용합니다.

이를 설명하기 위해 다음을 가정합니다.

• 최신 릴리스는 버전 4.1.3입니다.

• 이전 주요 버전의 최신 릴리스는 3.2.4입니다.

• 버전 1.x의 최신 릴리스는 1.5.6입니다.

이전 버전과 호환되는 새 기능은 최신 버전의 마이너 릴리스로 추가됩니다. 이 경우 새 기능의 다음 집합이 버전 4.2.0으로 추가됩니다.

이전 버전과 호환되는 마이너 버그 수정은 최신 버전의 패치 릴리스로 추가됩니다. 여기서 마이너 버그의 다음 수정 집합은 버전 4.1.4로 추가됩니다.

이전 버전과 호환되는 메이저 버그 수정은 다르게 처리됩니다. 이러한 버그 수정은 다음과 같이 여러 버전에 추가됩니다.

• 최신 버전의 패치 릴리스에 추가되는 경우. 이 경우 버전 4.1.4입니다.

• 이전 마이너 버전의 패치 릴리스에 추가되는 경우. 이 경우 3.2.5입니다.

• 최신 버전 1.x 릴리스의 패치 릴리스에 추가되는 경우. 이 경우 버전 1.5.7입니다.

메이저 버그 수정은 Amazon IVS 제품 팀에서 정의합니다. 일반적인 예로는 중요한 보안 업데이트와 고객에게 필요한 기타 수정이 있습니다.

참고: 위의 예에서 릴리스된 버전은 숫자가 차례대로 높아집니다(예: 4.1.3에서 4.1.4). 실제로는 하나 이상의 패치 번호가 내부에 남고 릴리스되지 않을 수 있으므로, 예를 들어 릴리스된 버전은 4.1.3에서 4.1.6으로 증가할 수 있습니다.