본문으로 건너뛰기

AdRenderingSettings 설정

1. AdRenderingSettings 설정 방법​

videoAdScheduleManager.setAdRenderingSettings()를 통해 AdRenderingSetting를 설정할 수 있습니다.

2. AdRenderingSettings 설정 속성​

bitrate​

  • 설정 단위: Kbps(kbit/s), (number, default: 0)

  • 콘텐츠 영상의 bitrate 값으로 설정

    정보

    사용자에 의해 콘텐츠 화질이 변경되었을 때 변경된 화질의 bitrate 값을 반영하여 AdRenderingSettings를 재설정해주는 것을 권장합니다.

  • 설정된 값과 근접한 bitrate의 광고 영상이 재생됩니다.

  • bitrate를 설정하지 않으면 기본값 0이 적용되며, 이 경우 HLS·MP4 소재 모두 최고 화질 미디어 파일이 선택됩니다.

    4.8.0 이전 버전 동작

    4.8.0 미만에서는 bitrate 미설정(0) 시 HLS 소재는 최고 화질, MP4 소재는 최저 화질이 선택되어 포맷별로 동작이 달랐습니다. 4.8.0부터 두 포맷 모두 최고 화질로 통일되었습니다.

enableHls​

Deprecated (4.8.0~)

이 속성은 4.8.0부터 deprecated되었으며 동작에 영향을 주지 않습니다.

  • 광고 HLS(HTTP Live Streaming) 재생 여부 (boolean, default: false)

    Google IMA 광고가 렌더링 될 경우에만 설정이 적용됩니다.

hideProgressInfo​

  • 인스트림 광고 진행도 UI 숨김 여부 (boolean, default: false)

  • true로 설정 시 progress bar와 현재 재생 시간 / 광고 길이 UI가 숨겨집니다.

  • GV, IMA 어댑터 모두 지원됩니다.

hideSkipInfo​

  • 인스트림 광고 스킵 UI 숨김 여부 (boolean, default: false)

  • true로 설정 시 스킵 카운트다운과 스킵 버튼이 숨겨집니다.

  • GV 어댑터에서만 지원되며, IMA 어댑터에서는 지원되지 않습니다.

loadVideoTimeout​

광고 미디어 파일 로드 타임 아웃(ms) (number, default: 8000)

3. 설정 예시​

var videoAdRenderingSettings = {
  bitrate: 1600,
  loadVideoTimeout: 8000,
  hideProgressInfo: false,
  hideSkipInfo: false,
};

videoAdScheduleManager.setAdRenderingSettings(videoAdRenderingSettings);