MediaTailor, MediaPackage 및 CDN을 사용하여 매니페스트 필터링 설정 - AWS Elemental MediaTailor
매니페스트 필터링 기능매니페스트 필터링을 위한 CDN 구성클라이언트 측 필터링 구현일반적인 필터링 시나리오특별 고려 사항 및 제한 사항필터링 구현 테스트

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

MediaTailor, MediaPackage 및 CDN을 사용하여 매니페스트 필터링 설정

AWS Elemental MediaTailor 는와 함께 매니페스트 필터링 AWS Elemental MediaPackage 을 사용하여 콘텐츠 전송 네트워크(CDN)를 통해 여러 최종 사용자에게 전달되는 매니페스트에 포함되는 오디오 및 비디오 스트림을 사용자 지정합니다. 이는 계층형 서비스 상품, 디바이스별 최적화 또는 콘텐츠 액세스 제어를 구현하는 데 특히 유용합니다.

이 주제에서는 매니페스트 필터링 기능 구현에 특히 중점을 둡니다. 매니페스트 필터링을 구현하기 전에 기본 콘텐츠 전송 네트워크 통합 설정을 완료해야 합니다. 기본 MediaPackage 및 콘텐츠 전송 네트워크 통합을 아직 설정하지 않은 경우 로 시작합니다MediaTailor를 MediaPackage 및 CDN과 통합 .

매니페스트 필터링 기능

매니페스트 필터링을 구현하기 전에이 기능으로 수행할 수 있는 작업을 이해합니다.

코어 필터링 기능

매니페스트 필터링은 콘텐츠 전송을 제어하는 데 도움이 되는 몇 가지 주요 기능을 제공합니다.

  • 프리미엄 콘텐츠(예: 4K HEVC)에 대한 최종 사용자 액세스 제한

  • 적절한 스트림을 사용하여 특정 디바이스 유형을 대상으로 지정

  • 오디오 샘플 속도, 언어 또는 비디오 코덱을 기준으로 콘텐츠 필터링

  • 다양한 구독자에게 다양한 품질 티어 제공

일반 사용 사례

이러한 사용 사례는 매니페스트 필터링이 특정 비즈니스 요구 사항을 해결하는 방법을 보여줍니다.

구독 티어

기본 구독자에게 해상도가 낮은 스트림을 제공하는 동시에 프리미엄 구독자에게 4K 콘텐츠에 대한 액세스 권한 제공

예: 기본 티어는 720p로 제한, 프리미엄 티어는 최대 4K까지 획득

디바이스 최적화

디바이스 기능에 따라 적절한 스트림을 자동으로 제공

예: 모바일 디바이스의 비트 전송률이 낮고 스마트 TVs 품질이 향상됩니다.

대역폭 관리

사용량이 가장 많은 기간 동안 스트림 품질을 제한하여 네트워크 비용 관리

예: 트래픽이 많은 이벤트 발생 시 최대 비트 전송률 감소

리전 콘텐츠

최종 사용자 위치에 따라 다양한 오디오 언어 또는 콘텐츠 변형 제공

예: 로컬 언어 오디오 트랙 자동 필터링

매니페스트 필터링 개념에 대한 자세한 내용은 AWS Elemental MediaPackage 사용 설명서의 매니페스트 필터링을 참조하세요.

매니페스트 필터링을 위한 CDN 구성

CDN이 필터링이 작동하려면 MediaPackage에 aws.manifestfilter 쿼리 파라미터를 전달해야 하므로 매니페스트 필터링을 위한 CDN 구성이 필수적입니다. 적절한 쿼리 문자열 전달이 없으면 CDN에서 필터 파라미터를 제거하고 모든 뷰어는 구독 계층 또는 디바이스 기능에 관계없이 필터링되지 않은 매니페스트를 수신합니다. 이 구성을 사용하면 필터링 로직이 의도한 대로 MediaPackage 및 함수에 도달합니다.

CDN을 통해 매니페스트 필터링을 활성화하려면 쿼리 문자열 전달을 구성해야 합니다.

  1. CloudFront 배포에서 매니페스트 요청에 대한 캐시 동작을 생성하거나 편집합니다.

  2. 캐시 정책의 경우 새 정책을 생성하거나 기존 정책을 편집합니다.

  3. 캐시 키 설정에서 "지정된 쿼리 문자열 포함"을 선택합니다.

  4. aws.manifestfilter를 허용된 쿼리 문자열 목록에 추가합니다.

  5. 다른 MediaPackage 기능도 사용하는 경우 쿼리 파라미터를 추가합니다.

    • start 및 end - 시간 이동 보기

    • time_delay - 시간 지연 기능의 경우

    • _HLS_msn 및 _HLS_part - LL-HLS의 경우

배포 생성에 대한 자세한 내용은 Amazon CloudFront 개발자 안내서의 배포 생성을 참조하세요.

클라이언트 측 필터링 구현

클라이언트 측 구현에서는 비디오 플레이어와 애플리케이션이 필터링된 콘텐츠를 요청하는 방법을 정의합니다. 이 구성은 각 최종 사용자가 구독 수준, 디바이스 기능 또는 기타 기준에 따라 수신하는 콘텐츠를 결정합니다. 적절한 구현을 통해 최종 사용자는 최적의 CDN 캐시 효율성을 유지하면서 액세스해야 하는 콘텐츠만 수신할 수 있습니다.

비디오 플레이어 및 애플리케이션에서 매니페스트 필터링을 구현하려면:

필터링 작동 방식

필터링 프로세스는 다음과 같이 작동합니다.

  1. 비디오 플레이어 또는 애플리케이션이 필터 파라미터가 포함된 매니페스트 URL을 요청합니다.

  2. CDN은 요청(쿼리 파라미터 포함)을 MediaTailor에 전달합니다.

  3. MediaTailor는 오리진 매니페스트를 요청할 때 필터 파라미터를 MediaPackage에 전달합니다.

  4. MediaPackage는 필터를 적용하고 기준과 일치하는 변형만 포함하는 사용자 지정 매니페스트를 반환합니다.

  5. MediaTailor는 광고 삽입을 위해 필터링된 매니페스트를 처리하고 플레이어에게 반환합니다.

필터링을 위한 URL 형식

올바른 URL 형식을 이해하는 것은 성공적인 필터링 구현에 매우 중요합니다. URL 형식이 잘못되면 필터링 파라미터가 무시되거나 HTTP 오류가 발생합니다. URL 구조에는 CDN이 MediaPackage에 전달하는 쿼리 문자열로 필터 파라미터가 포함되어야 합니다. 다음 단계에 따라 적절한 URL 형식을 구현합니다.

비디오 플레이어에서 매니페스트 필터링을 구현하려면:

  1. 적절한 필터 파라미터를 포함하도록 플레이어의 매니페스트 요청 URLs을 수정합니다.

  2. 쿼리 파라미터와 함께 다음 URL 형식을 사용합니다.

    https://CloudFront-Domain/v1/master/MediaTailor-Config/index.m3u8?aws.manifestfilter=video_codec:h264;audio_language:en-US

  3. 플레이어가이 URL을 요청하면 MediaTailor는 이러한 파라미터를 MediaPackage에 전달하여 필터링된 매니페스트를 생성합니다.

일반적인 필터링 시나리오

다음 예제를 사용하여 일반적인 필터링 시나리오를 구현합니다.

디바이스별 콘텐츠 전송

디바이스 기능을 기준으로 필터링하려면 매니페스트 요청에이 파라미터를 추가합니다.

aws.manifestfilter=video_codec:h264;audio_sample_rate:0-44100

이 예제에서는 모바일 디바이스에 적합한 최대 44.1kHz의 샘플 속도로 H.264 비디오 및 오디오로 콘텐츠를 제한합니다.

프리미엄 콘텐츠 제한

비트 전송률이 높은 콘텐츠에 대한 액세스를 제한하려면 매니페스트 요청에이 파라미터를 추가합니다.

aws.manifestfilter=video_bitrate:0-9000000

이 예제에서는 기본 구독 계층에 적합한 비디오 비트레이트를 9Mbps 이하로 제한합니다.

언어 선택

특정 오디오 언어를 필터링하려면 매니페스트 요청에이 파라미터를 추가합니다.

aws.manifestfilter=audio_language:fr,en-US,de

이 예제에는 프랑스어, 미국 영어 및 독일어 오디오 트랙만 포함됩니다.

해결 대상 지정

특정 비디오 해상도를 필터링하려면 매니페스트 요청에이 파라미터를 추가합니다.

aws.manifestfilter=video_height:240-360,720-1080

이 예제에는 중간 해상도를 제외하고 높이가 240~360픽셀~720-1080픽셀인 비디오 스트림이 포함되어 있습니다.

코덱 기반 필터링

특정 비디오 코덱을 필터링하려면 매니페스트 요청에이 파라미터를 추가합니다.

aws.manifestfilter=video_codec:h264,h265

이 예제에는 다른 코덱을 제외한 H.264 및 H.265 비디오 스트림만 포함됩니다.

특별 고려 사항 및 제한 사항

매니페스트 필터링을 구현할 때 발생하는 일반적인 문제를 방지하려면:

기술적 제한 사항

  • TS 매니페스트의 경우 오디오 변환 그룹을 사용하여 필터링된 오디오 스트림과 멀티플렉싱된 비디오 스트림을 제거하지 않도록 합니다.

  • TS 및 CMAF 매니페스트에서는 확인을 위해 오디오 샘플 속도와 비디오 비트레이트를 매니페스트에 쉽게 볼 수 없습니다.

  • 미디어 재생 목록 또는 세그먼트에 요청 파라미터를 추가하면 HTTP 400 오류가 발생합니다.

오류 조건

  • 필터링으로 인해 빈 매니페스트가 발생하는 경우(필터 기준을 충족하는 스트림 없음) MediaPackage는 HTTP 400 오류를 반환합니다.

  • 필터 구성(엔드포인트 필터 + 쿼리 파라미터)이 충돌하면 HTTP 404 오류가 발생합니다.

  • 잘못된 필터 구문 또는 지원되지 않는 필터 유형으로 인해 HTTP 400 오류가 발생합니다.

성능 고려 사항

  • 각 고유 필터 조합은 별도의 캐시 항목을 생성하여 캐시 효율성을 잠재적으로 줄일 수 있습니다.

  • 기준이 많은 복잡한 필터는 매니페스트 생성 성능에 영향을 미칠 수 있습니다.

  • 정적 필터링 시나리오에 엔드포인트 수준 필터를 사용하여 캐시 성능을 개선하는 것이 좋습니다.

필터링 구현 테스트

매니페스트 필터링 구현을 테스트하는 것은 최종 사용자가 액세스 수준 및 디바이스 기능에 따라 올바른 콘텐츠를 수신하도록 하는 데 매우 중요합니다. 필터링이 실패하면 최종 사용자가 잘못된 품질 수준, 지원되지 않는 형식 또는 액세스할 수 없는 콘텐츠를 수신할 수 있습니다. 포괄적인 테스트를 통해 이러한 문제가 최종 사용자에게 영향을 미치기 전에 식별하고 해결할 수 있습니다.

매니페스트 필터링이 올바르게 작동하는지 확인하려면:

  1. 필터 파라미터가 다른 매니페스트를 요청하고 결과를 확인합니다.

  2. 필터링된 매니페스트에 예상 스트림만 포함되어 있는지 확인

  3. 엣지 케이스(빈 결과, 잘못된 필터)를 테스트하여 적절한 오류 처리를 보장합니다.

  4. CDN이 필터 파라미터를 올바르게 전달하고 있는지 확인

  5. 서로 다른 디바이스 및 플레이어로 테스트하여 호환성 보장

필터링 문제 해결은 MediaPackage CDN 통합 문제 해결을 참조하세요.

HTTP 400 오류, 빈 매니페스트 또는 예상대로 작동하지 않는 필터링 파라미터가 발생하는 경우 특정 매니페스트 필터링 문제 해결 지침은 MediaPackage, CDN 및 MediaTailor 통합 문제 해결 섹션을 참조하세요.