Query String Handling

Default Query String 사용하기

사용자는 Low-Latency HLS (또는 HLS)의 기본 동작 방식을 <DefaultQueryString>을 통해 제어 할 수 있습니다.

다음과 같이 Server.xml의 <Publishers><LLHLS><DefaultQueryString> (또는 <Publishers><HLS><DefaultQueryString>)에서 설정 할 수 있습니다:

<?xml version="1.0" encoding="UTF-8"?>
<Server version="8">
  ...
  <VirtualHosts>
    <VirtualHost>
      <Applications>
        <Application>
          <Publishers>
            ...
            <LLHLS>
              <DefaultQueryString>
                <Query>
                  <Key>_HLS_legacy</Key>
                  <Value>NO</Value>
                </Query>
                <Query>
                  <Key>_HLS_rewind</Key>
                  <Value>YES</Value>
                </Query>
              </DefaultQueryString>
            </LLHLS>
            ...
          </Publishers>
       </Application>
      </Applications>
    </VirtualHost>
  </VirtualHosts>
  ...
</Server>

Playback URL에 이미 Query 문자열이 추가 되어 있는 경우 이 설정은 무시됩니다.

Key	Value	Description
_HLS_legacy	YES | NO * Default: NO	_HLS_legacy 값을 YES로 설정하면, LL-HLS Playlist 내에 Partial Segment 정보를 제거하여 Legacy HLS (HLSv6 등)와 동일하게 동작합니다. * LL-HLS Only
_HLS_rewind	YES | NO * Default: YES	_HLS_rewind 값이 YES로 설정되어 있고 Live Rewind 기능이 활성화 된 경우, Playlist 내에 이전 Segment 정보가 포함됩니다.

Query String 승계하기

사용자가 <PropagateQueryString> 을 활성화하면, 최초 Master Playlist 요청에 포함된 Query String이 하위 모든 요청 (Media Playlist, Segment, Partial Segment)에 자동으로 포함됩니다. Query String에 Session Key, Authentication Token 등을 포함시켜 이 기능을 활용한다면, 모든 요청을 CDN에서 검사할 수 있기 때문에 콘텐츠 접근 제어가 용이합니다.

다음과 같이 Server.xml의 <Publishers><LLHLS><PropagateQueryString> (또는 <Publishers><HLS><PropagateQueryString>)에서 설정 할 수 있습니다:

<?xml version="1.0" encoding="UTF-8"?>
<Server version="8">
  ...
  <VirtualHosts>
    <VirtualHost>
      <Applications>
        <Application>
          <Publishers>
            ...
            <LLHLS>
              <OriginMode>true</OriginMode>
              <PropagateQueryString>true</PropagateQueryString>
            </LLHLS>
            ...
          </Publishers>
        </Application>
      </Applications>
    </VirtualHost>
  </VirtualHosts>
  ...
</Server>

Query String에 민감한 정보를 직접 포함시키지 않도록 주의가 필요합니다.