필터

아티클
06/30/2023

경고

Azure Media Services는 2024년 6월 30일에 사용 중지됩니다. 자세한 내용은 AMS 사용 중지 가이드를 참조하세요.

고객에게 콘텐츠를 전송하는 경우(라이브 스트리밍 이벤트 또는 주문형 비디오) 클라이언트에는 기본 자산의 매니페스트 파일에 설명된 것보다 더 많은 유연성이 필요할 수 있습니다. Azure Media Services는 미리 정의된 필터에 따라 동적 매니페스트를 제공합니다.

필터는 고객이 다음과 같은 작업을 수행할 수 있도록 하는 서버 쪽 규칙입니다.

전체 비디오를 재생하는 대신 비디오의 한 섹션만 재생합니다. 예를 들면 다음과 같습니다.
- 라이브 이벤트의 하위 클립을 표시하는 매니페스트를 줄입니다("하위 클립 필터링").
- 비디오의 시작 부분을 자릅니다("비디오 트리밍").
콘텐츠를 재생하는 데 사용되는 디바이스에서 지원하는 지정된 변환 및/또는 지정된 언어 트랙만 전달합니다(“변환 필터링”).
플레이어의 DVR 창 길이를 제한하기 위해 프레젠테이션 창(DVR)을 조정합니다("프레젠테이션 창 조정").

Media Services를 사용하면 콘텐츠에 사용할 계정 필터 및 자산 필터를 만들 수 있습니다. 또한 미리 만든 필터를 스트리밍 로케이터와 연결할 수 있습니다.

필터 형식

두 가지 형식의 필터가 있습니다.

계정 필터(전역) - Azure Media Services 계정의 모든 자산에 적용 가능하며 계정의 수명 동안 보유합니다.
자산 필터(로컬) -필터를 만들 때 연결된 자산에만 적용 가능하며 자산의 수명 동안 보유합니다.

계정 필터 및 자산 필터 형식은 필터를 정의/설명할 수 있는 정확히 동일한 속성을 가집니다. 자산 필터를 작성하는 경우 외에는 필터를 연결할 자산 이름을 지정해야 합니다.

시나리오에 따라 더 적합한 필터 유형이 다릅니다(자산 필터 또는 계정 필터). 계정 필터는 일반적으로 디바이스 프로필에 적합(변환 필터링)한 반면, 자산 필터는 특정 자산을 트리밍하는 데 사용할 수 있습니다.

다음 속성을 사용하여 필터를 설명합니다.

이름	설명
firstQuality	필터의 첫 번째 품질 비트 전송률입니다.
presentationTimeRange	라이브 이벤트 매니페스트의 프레젠테이션 시간 범위입니다. 이 속성은 매니페스트 시작/종료 지점, 프레젠테이션 창 길이 및 라이브 시작 위치를 필터링하는 데 사용됩니다. 자세한 내용은 PresentationTimeRange를 참조하세요.
tracks	트랙 선택 조건입니다. 자세한 내용은 tracks를 참조하세요.

presentationTimeRange

이 속성은 자산 필터와 함께 사용합니다. 계정 필터를 사용하여 이 속성을 설정하지 않는 것이 좋습니다.

이름	Description
startTimestamp	VoD(주문형 비디오) 또는 라이브 스트리밍에 적용됩니다. 스트림의 절대 시작점을 나타내는 long 값입니다. 값은 가장 가까운 다음 GOP 시작 지점으로 반올림됩니다. 단위는 timescale이므로 1억 5천만의 startTimestamp는 15초입니다. startTimestamp 및 endTimestamp를 사용하여 재생 목록(매니페스트)에 있는 조각을 자릅니다. 예를 들어, 기본 timescale을 사용하는 startTimestamp = 40000000 및 endTimestamp = 100000000은 VoD 프레젠테이션 4초~10초 사이에 조각이 포함된 재생 목록을 생성합니다. 경계에 걸쳐 있는 조각인 경우 전체 조각이 매니페스트에 포함됩니다.
endTimestamp	VoD(주문형 비디오)에 적용됩니다. 라이브 스트리밍 프레젠테이션의 경우 이 속성은 자동으로 무시되며 프레젠테이션이 종료되고 스트림이 VoD가 되면 적용됩니다. 이 값은 프레젠테이션의 절대 엔드포인트를 나타내며, 가장 가까운 다음 GOP 시작으로 반올림된 long 값입니다. 단위는 timescale이므로, 18억의 endTimestamp는 3분입니다. startTimestamp 및 endTimestamp를 사용하여 재생 목록(매니페스트)에 있는 조각을 자릅니다. 예를 들어, 기본 timescale을 사용하는 startTimestamp = 40000000 및 endTimestamp = 100000000은 VoD 프레젠테이션 4초~10초 사이에 조각이 포함된 재생 목록을 생성합니다. 경계에 걸쳐 있는 조각인 경우 전체 조각이 매니페스트에 포함됩니다.
timescale	프레젠테이션 시간 범위의 모든 타임스탬프 및 기간에 적용되며, 1초 단위로 증가하는 수로 지정됩니다. 기본값은 1초에 1천만 증분이며, 각 증가값은 100나노초입니다. 그러나 값은 비디오의 원본 또는 클라우드에서 인코딩이 포함된 라이브 이벤트를 사용하는 경우(기본값: 90Khz 또는 비디오의 경우 90000)에 따라 다를 수 있습니다. 예를 들어 startTimestamp를 30초로 설정하려면 기본 timescale을 사용하는 경우 3억 값을 사용합니다. 자산에 대한 매니페스트를 확인하여 비디오 트랙의 날짜 표시줄이 설정한 규모에 있는지 확인해야 합니다. 인코딩과 함께 라이브 이벤트를 사용하는 경우 비디오 트랙의 경우 90Khz(90000) 및 오디오 트랙의 경우 48khz(48000)로 표시될 수 있습니다.
liveBackoffDuration	라이브 스트리밍에만 적용됩니다. 이 값은 클라이언트가 검색할 수 있는 최신 라이브 위치를 정의합니다. 이 속성을 사용하여 라이브 재생 위치를 지연하고 플레이어를 위한 서버 쪽 버퍼를 생성할 수 있습니다. 이 속성의 단위는 timescale입니다(아래 참조). 최대 라이브 백오프 지속 시간은 300초(30억)입니다. 예를 들어 값이 20억이면 실제 라이브 에지에서 사용 가능한 최신 콘텐츠가 20초 지연됩니다.
presentationWindowDuration	라이브 스트리밍에만 적용됩니다. presentationWindowDuration을 사용하여 재생 목록에 포함할 조각 슬라이딩 윈도우를 적용합니다. 이 속성의 단위는 timescale입니다(아래 참조). 예를 들어presentationWindowDuration=1200000000을 설정하면 2분 슬라이딩 윈도우가 적용됩니다. 라이브 에지 2분 이내의 미디어가 재생 목록에 포함됩니다. 경계에 걸쳐 있는 조각인 경우 전체 조각이 재생 목록에 포함됩니다. 최소 프레젠테이션 기간은 60초입니다.
forceEndTimestamp	라이브 스트리밍에만 적용됩니다. endTimestamp 속성이 있어야 하는지를 나타냅니다. true이면 endTimestamp를 지정해야 합니다. 그렇지 않으면 잘못된 요청 코드가 반환됩니다. 허용되는 값: true, false

tracks

동적으로 작성된 매니페스트에 포함해야 하는 스트림(라이브 스트리밍 또는 주문형 비디오)의 트랙을 기반으로 필터 트랙 속성 조건(FilterTrackPropertyConditions)의 목록을 지정합니다. 필터는 논리 AND 및 OR 연산을 사용하여 결합됩니다.

필터 트랙 속성 조건은 트랙 유형, 값(다음 표에 설명) 및 연산(Equal, NotEqual)을 설명합니다.

이름	설명
Bitrate	필터링을 위해 트랙의 비트 전송률을 사용합니다. 최상의 값은 비트 전송률의 범위(초당 비트 수)입니다. 예를 들어 “0-2427000”입니다. 참고: 특정 비트 전송률 값을 예를 들어 250000(초당 비트 수)과 같이 사용할 수 있지만, 정확한 비트 전송률이 자산별로 변동될 수 있으므로 이 방법은 권장되지 않습니다.
FourCC	필터링을 위해 트랙의 FourCC 값을 사용합니다. 값은 RFC 6381에 지정된 코덱 형식의 첫 번째 요소입니다. 현재 지원되는 코덱은 다음과 같습니다. 비디오: “avc1”, “hev1”, “hvc1” 오디오: “mp4a”, “ec-3” 자산의 트랙에 대한 FourCC 값을 확인하려면 매니페스트 파일 가져오기 및 검사를 참조하세요.
언어	필터링을 위해 트랙의 언어를 사용합니다. 값은 RFC 5646에 지정된, 포함할 언어의 태그입니다. 예: "en".
이름	필터링을 위해 트랙의 이름을 사용합니다.
유형	필터링을 위해 트랙의 유형을 사용합니다. 허용되는 값은 “video”, “audio” 또는 “text”입니다.

예제

다음 예제에서는 라이브 스트리밍 필터를 정의합니다.

{
  "properties": {
    "presentationTimeRange": {
      "startTimestamp": 0,
      "endTimestamp": 170000000,
      "presentationWindowDuration": 9223372036854776000,
      "liveBackoffDuration": 0,
      "timescale": 10000000,
      "forceEndTimestamp": false
    },
    "firstQuality": {
      "bitrate": 128000
    },
    "tracks": [
      {
        "trackSelections": [
          {
            "property": "Type",
            "operation": "Equal",
            "value": "Audio"
          },
          {
            "property": "Language",
            "operation": "NotEqual",
            "value": "en"
          },
          {
            "property": "FourCC",
            "operation": "NotEqual",
            "value": "EC-3"
          }
        ]
      },
      {
        "trackSelections": [
          {
            "property": "Type",
            "operation": "Equal",
            "value": "Video"
          },
          {
            "property": "Bitrate",
            "operation": "Equal",
            "value": "3000000-5000000"
          }
        ]
      }
    ]
  }
}

스트리밍 로케이터를 만들 때 HLS 또는 DASH 매니페스트 필터링

Media Services를 사용하면 스트리밍 로케이터 엔터티의 필터 속성에 필터 컬렉션을 전달하여 미리 필터링되는 스트리밍 로케이터를 만들 수 있습니다. 이를 통해 스트리밍 로케이터의 모든 매니페스트를 사전 필터링할 수 있습니다. 원래의 매니페스트는 이 스트리밍 로케이터를 통해 더 이상 사용할 수 없으며, 필터링된 스트리밍 로케이터에서 DASH 또는 HLS에 대한 URL을 요청하는 클라이언트만 필터링된 응답에 액세스할 수 있습니다. 이는 자산의 일부만 게시하고 사용자가 HLS 또는 DASH 매니페스트 URL의 쿼리 문자열을 조작하여 자산에 대한 원래의 전체 매니페스트에 액세스하지 못하게 하려는 경우에 유용합니다.

스트리밍 로케이터에 자산 또는 계정 필터 목록을 지정할 수 있습니다. 동적 패키지 작성 도구는 클라이언트가 URL에 지정하는 필터 목록과 함께 이 필터 목록을 적용합니다. 이 조합은 URL + 스트리밍 로케이터에 지정된 필터를 기반으로 하는 동적 매니페스트를 생성합니다.

필터 업데이트

필터 및 스트리밍 로케이터는 즉시 업데이트할 수 있지만 프런트 엔드 웹 서버에서 업데이트하는 데 최대 10초가 걸릴 수 있으며 이미 프로덕션에서 게시되고 사용된 동일한 스트리밍 로케이터를 업데이트하는 경우 콘텐츠의 다운스트림 CDN 캐싱에 문제가 있을 수 있습니다.

특히 CDN을 사용하는 경우 적극적으로 게시된 스트리밍 로케이터와 관련된 필터의 정의를 업데이트하지 않는 것이 좋습니다. 스트리밍 서버와 CDN은 내부 캐시를 사용할 수 있으며, 이로 인해 부실 캐시된 데이터가 반환될 수 있습니다.

필터 정의를 변경해야 하는 경우, 새 필터를 만들어 스트리밍 로케이터 URL에 추가하거나 업데이트한 필터를 직접 참조하는 고유한 새 스트리밍 로케이터를 게시하는 것이 좋습니다.

도움말 및 지원 보기

다음 방법 중 하나로 Media Services에 문의하거나 업데이트를 따를 수 있습니다.

질문과 대답
Stack Overflow. 를 사용하여 질문에 태그를 지정합니다 azure-media-services.
@MSFTAzureMedia 또는 @AzureSupport 사용하여 지원을 요청합니다.
Azure Portal 통해 지원 티켓을 엽니다.

다음을 통해 공유

필터