기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# HLS 매니페스트 내의 경로 사용자 지정
표준 MediaLive 채널에서 HLS 출력 그룹을 생성하는 경우 사용자 지정 매니페스트를 활성화할 수 있습니다.
다운스트림 시스템이 MediaPackage인 경우 MediaPackage 출력 그룹 또는 HLS 출력 그룹에서 사용자 지정 매니페스트를 설정할 수 없습니다 MediaPackage. MediaPackage는 기본 경로에서만 작동합니다.
하위 매니페스트의 경로를 변경하여 기본 매니페스트를 사용자 지정할 수 있습니다. 미디어 파일의 경로를 변경하여 각 하위 매니페스트를 사용자 지정할 수도 있습니다. 일반적으로 다운스트림 시스템에 특별한 경로 요구 사항이 있는 경우에만 구문을 변경하면 됩니다. Akamai CDN에서는 대개 구문을 변경해야 합니다.
**참고**
HLS 매니페스트에 대한 본 단원의 정보는 사용자가 [채널 처음부터 새로 생성](creating-channel-scratch.md) 단원에 설명된 채널을 생성하는 일반적인 단계에 익숙하다는 전제 하에 제공됩니다.
이 기능과 관련된 콘솔의 키 필드는 **채널 생성** 페이지의 **HLS 출력 그룹** 섹션의 **위치** 그룹에 있습니다. 이러한 필드를 작성하는 단계는 [절차](creating-hls-output-group.md#hls-create-procedure)를(을) 참조하세요.
**Topics**
+ [사용자 지정 경로를 설정하기 위한 절차](hls-custom-manifests-procedure.md)
+ [매니페스트 작동 방식](hls-manifests-how-work.md)
+ [사용자 지정 경로에 대한 규칙](hls-custom-paths-rules.md)
+ [사용자 지정 경로를 설정하는 지침](hls-custom-paths-guidance.md)
+ [사용자 지정 경로의 예제](hls-custom-paths-examples.md)
# 사용자 지정 경로를 설정하기 위한 절차
매니페스트 경로를 사용자 지정하려면 다음 필드를 사용해야 합니다.
+ **HLS 출력 그룹 - 위치** – **기본 URL 매니페스트** 필드
+ **HLS 출력 그룹 - 위치** – **기본 URL 콘텐츠** 필드
**매니페스트에서 사용자 지정 경로를 구성하려면**
1. 다운스트림 시스템 담당자에게 문의하여 사용자 지정 경로가 필요한지 확인합니다. 기본 매니페스트에 하위 매니페스트의 사용자 지정 경로가 필요하거나, 하위 매니페스트에 미디어 파일의 사용자 지정 경로가 필요하거나, 기본 매니페스트와 하위 매니페스트 모두에 사용자 지정 경로가 필요할 수 있습니다. [매니페스트 작동 방식](hls-manifests-how-work.md)을(를) 참조하세요.
1. [구문과 경로 구성 규칙](hls-destinations-design-step.md#hls-syntax-http)에 주의를 기울여 경로를 설계합니다.
[다른 다운스트림 시스템에 대해서는 이 지침](hls-custom-paths-guidance.md)을 참조하십시오.
[다음 예제](hls-custom-paths-examples.md)를 참조하십시오.
1. HLS 출력 그룹 페이지의 **위치** 섹션에서 다음 필드 중 하나 또는 모두를 작성합니다.
+ **기본 URL 매니페스트 A** 및 **기본 URL 매니페스트 B**. 단일 파이프라인 채널의 경우 필드 A만 작성하고, 표준 채널의 경우 필드 A와 필드 B를 작성합니다.
+ **기본 URL 콘텐츠 A** 및 **기본 URL 콘텐츠 B**. 단일 파이프라인 채널의 경우 필드 A만 작성하고, 표준 채널의 경우 필드 A와 필드 B를 작성합니다.
# 매니페스트 작동 방식
다음 단원에서는 매니페스트 경로가 작동하는 방식에 대해 설명합니다.
## 매니페스트 경로의 기본 작동 방식
MediaLive에서 생성하는 매니페스트에는 다른 파일의 경로에 대한 다음과 같은 정보가 포함됩니다.
+ 기본 매니페스트 내의 콘텐츠에는 각 하위 매니페스트의 경로가 포함됩니다.
기본적으로 이 경로의 구문은 다음과 같습니다.
```
baseFilename nameModifier extension
```
예제:
```
curling-high.m3u8
```
이 경로는 기본 매니페스트의 위치를 기준으로 합니다.
+ 각 하위 매니페스트 내의 콘텐츠에는 해당 미디어 파일의 경로가 포함됩니다.
기본적으로 이 경로의 구문은 다음과 같습니다.
```
baseFilename nameModifier optionalSegmentModifier counter extension
```
예제:
```
curling-high-000001.ts
```
이 경로는 하위 매니페스트의 위치를 기준으로 합니다.
## 사용자 지정 경로의 작동 방식
매니페스트 내의 기본 경로가 다운스트림 시스템에서 세 개의 파일 세트를 처리하는 방식에 적합하지 않은 경우 *기본 URL* 필드를 작성할 수 있습니다.
+ MediaLive가 하위 매니페스트에 대한 사용자 지정 경로를 구성하도록 **기본 URL 매니페스트** 필드를 작성합니다.
+ MediaLive가 미디어 파일에 대한 사용자 지정 경로를 구성하도록 **기본 URL 콘텐츠** 필드를 작성합니다.
경로를 사용자 지정하면 구문이 변경됩니다.
+ **기본 URL 매니페스트** 필드를 작성할 때 기본 매니페스트 내의 하위 매니페스트 경로에 대한 구문은 다음과 같습니다.
```
baseURLManifest baseFilename nameModifier extension
```
예제:
```
http://viewing/sports/curling-high.m3u8
```
+ **기본 URL 콘텐츠** 필드를 작성할 때 하위 매니페스트 내의 미디어 파일 경로에 대한 구문은 다음과 같습니다.
```
baseURLContent baseFilename nameModifier optionalSegmentModifier counter
extension
```
예제:
```
http://viewing/media/sports/curling-high-000001.ts
```
## MediaLive가 이러한 경로를 구성하는 방법
하위 매니페스트의 사용자 지정 경로는 다음과 같이 구성됩니다.
+ 사용자가 **기본 URL 매니페스트** 필드 또는 **기본 URL 콘텐츠** 필드 또는 둘 모두를 작성합니다.
예제:
```
http://198.51.100/sports/viewing/
```
값의 끝에 슬래시를 붙여야 합니다.
+ MediaLive가 해당 값을 [기본 경로](#hls-default-manifest-paths) 앞에 추가합니다. 예제:
```
http://198.51.100/sports/viewing/curling-high.m3u8
```
# 사용자 지정 경로에 대한 규칙
MediaLive HLS 출력 그룹에서 매니페스트를 사용자 지정하도록 설정한 후에는 다운스트림 시스템 담당자에게 다음 규칙을 공유해야 합니다.
일반적으로 사용자 지정 경로가 해당 환경에서 작동하는지 확인하는 것은 다운스트림 시스템 담당자의 책임입니다. MediaLive는 어떤 식으로든 값을 검증하지 않습니다. 따라서:
+ 프로토콜을 지정하는 경우(선택 사항) **대상 URL** 필드에 지정한 프로토콜과 동일해야 합니다.
+ 동일한 파이프라인의 **기본 URL 매니페스트**와 **기본 URL 콘텐츠** 필드는 동일한 값이나 다른 값을 가질 수 있으며, 모든 부분(도메인, 경로)에서 동일하거나 다를 수 있습니다.
+ 이 값은 상대 경로 또는 절대 경로가 될 수 있습니다.
+ 하위 매니페스트의 상대 경로는 항상 기본 매니페스트의 위치를 기준으로 합니다.
+ 미디어 파일의 상대 경로는 항상 하위 매니페스트의 위치를 기준으로 합니다.
+ 경로는 슬래시로 끝나야 합니다.
# 사용자 지정 경로를 설정하는 지침
HLS 출력의 사용자 지정 경로에 있는 콘텐츠는 MediaLive의 다운스트림에 있는 시스템에 적합해야 합니다. 다른 다운스트림 시스템에 대한 *기본 URL* 필드를 사용하기 위한 몇 가지 지침은 다음과 같습니다.
**다운스트림 시스템을 제어하는 경우 사용자 지정 경로 설정**
다운스트림 시스템을 제어하고 있을 수 있습니다. 예를 들어 다운스트림 시스템은 Amazon CloudFront로 콘텐츠를 전송하는 Amazon S3 또는 MediaStore일 수 있습니다. HLS 파일을 처리하려면 하나 이상의 파일 세트를 이동해야 할 수 있습니다. 이 경우 파일의 최종 위치 경로와 일치하도록 이러한 *기본 URL* 필드를 작성할 수 있습니다.
**다운스트림 패키저가 MediaPackage인 경우 사용자 지정 경로 설정**
다운스트림 패키지가 MediaPackage 경우 **기본 URL** 필드를 비워 둡니다. MediaPackage는 이 정보를 사용하지 않습니다.
**서드 파티 다운스트림 시스템을 사용하는 경우 사용자 지정 경로 설정**
서드 파티 다운스트림 시스템을 사용하는 경우 다운스트림 시스템에서 이러한 **기본 URL** 필드를 작성할지 여부를 알려야 합니다.
# 사용자 지정 경로의 예제
다음은 MediaLive HLS 출력 그룹에서 매니페스트를 사용자 지정할 수 있는 다양한 방법의 예입니다. 이러한 모든 예제에서는 다음을 가정합니다.
+ 기본 매니페스트에서 하위 매니페스트의 기본 경로는 다음 상대 경로입니다.
```
curling-high.m3u8
```
+ 하위 매니페스트에서 미디어 파일의 기본 경로는 다음 상대 경로입니다.
```
curling-high-000001.ts
```
**Example 1**
다운스트림 시스템에서 MediaLive가 푸시하는 위치로부터 파일을 이동하려고 합니다. 다운스트림 시스템은 하위 매니페스트가 여전히 상위 매니페스트와 동일한 상대 위치에 있고 미디어 파일이 여전히 하위 매니페스트와 동일한 상대 위치에 있도록 파일을 이동합니다.
따라서 경로를 사용자 지정할 필요가 없습니다. 기본 경로는 이동 후에도 계속 작동합니다.
**Example 2**
기본 매니페스트와 하위 매니페스트에 해당 파일의 절대 경로를 포함하려고 합니다. 다음과 같이 설정합니다.
+ **기본 URL 매니페스트 A** 필드를 작성하여 다음 절대 경로를 지정합니다.
```
http://198.51.100/sports/viewing/
```
기본 매니페스트 내에서 하위 매니페스트의 경로는 다음과 같습니다.
```
http://198.51.100/sports/viewing/curling-high.m3u8
```
+ **기본 URL 콘텐츠** 필드를 작성하여 다음 절대 경로를 지정합니다.
```
http://203.0.113.55/sports/viewing/
```
하위 매니페스트 내에서 미디어 파일의 경로는 다음과 같습니다.
```
http://203.0.113.55/sports/viewing/curling-high-000001.ts
```
이 예제에서는 두 파일 세트의 도메인이 다를 수 있음을 보여 줍니다.
**Example 3**
상위 매니페스트에 하위 매니페스트의 절대 경로를 포함하지만, 하위 매니페스트에 하위 매니페스트와 관련된 미디어 파일의 경로를 포함하려고 합니다. 이 경우 하위 매니페스트의 경로를 사용자 지정하지만 미디어 파일의 기본 경로를 계속 사용합니다.
+ **기본 URL 매니페스트 A** 필드를 작성하여 다음 절대 경로를 지정합니다.
파이프라인 A의 기본 매니페스트 내에서 하위 매니페스트의 경로는 다음과 같습니다.
```
http://198.51.100/sports/viewing/curling-high.m3u8
```
+ **기본 URL 콘텐츠 A** 필드는 작성하지 않습니다.
하위 매니페스트 내에서 미디어 파일의 경로는 여전히 기본값입니다.
```
curling-high-000001.ts
```