Skip to main content

광고 볼륨 설정

1. 광고 볼륨 설정​

1-1. 광고 초기 볼륨 설정​

  • 광고 초기 볼륨은 콘텐츠 video 요소의 볼륨을 참조합니다.

    콘텐츠 볼륨이 음소거 되어있거나 볼륨이 0이면 광고 영상 또한 음소거로 설정됩니다.

1-2. 광고 재생 중 음소거가 해제될 때의 볼륨​

  • 광고가 음소거로 재생된 후 사용자에 의해 음소거가 해제되었을 때 광고 볼륨은 SDK 전역설정의 contentInitialVolume이 적용됩니다.

    따라서, 광고 영상에서 음소거가 해재되었을 때를 위해 콘텐츠 볼륨이 음소거 되기 전의 볼륨값을 contentInitialVolume으로 설정해야 합니다.

    예시

    1. 콘텐츠 영상이 볼륨 0.5로 재생됨
    2. (사용자) 서비스의 UI를 클릭하여 음소거
    3. (서비스) SDK 전역 설정의 contentInitialVolume을 0.5로 설정
    4. (SDK) 광고 영상이 재생됨. 콘텐츠 video가 음소거 이므로 음소거 상태로 광고 재생
    5. (사용자) 광고의 UI를 클릭하여 음소거 해제
    6. (SDK) SDK 전역 설정의 contentInitialVolume을 참조하여 광고 볼륨을 0.5로 설정

contentInitialVolume 미설정시 기본값 1이 적용됩니다.

2. 광고 볼륨을 참조하여 콘텐츠 볼륨을 변경하기​

광고 재생 중 볼륨 또는 mute 상태가 변경되었을 때 광고 볼륨 변경 AD_VOLUME_CHANGED 이벤트를 통해 변경된 볼륨 값을 전달합니다.

window.gfpInstream.cmd.push(function () {
  videoAdScheduleManager.addEventListener(gfpInstream.GfpAdEvent.AD_VOLUME_CHANGED, function ({ volume, muted }) {
    console.debug(volume, muted);
  });
});

3. 광고 최고 볼륨 설정​

콘텐츠 볼륨과 광고 볼륨의 차이가 크다고 생각되는 경우 광고의 최대 볼륨 값을 제한할 수 있습니다.
SDK 전역 설정 adMaxVolume 값을 참조합니다.

  • 미설정시 기본값 1이 적용됩니다.
info

광고 최고 볼륨이 설정되더라도 광고 볼륨 UI는 절대값이 아닌 최고 볼륨의 퍼센티지를 나타냅니다.
예를 들어, 광고 최고 볼륨이 0.8로 설정된 후 광고 볼륨이 0.8인 경우 광고 볼륨 UI는 최대 게이지로 나옵니다.
즉, 사용자가 0.8 이상으로 볼륨을 키울 수 없습니다.

caution

iOS 모바일 환경에서는 자바스크립트로 볼륨 조절을 불가하며 항상 1로 설정이 되어있습니다.

아래 페이지 내 Volume Control in JavaScript 참조

https://developer.apple.com/library/archive/documentation/AudioVideo/Conceptual/Using_HTML5_Audio_Video/Device-SpecificConsiderations/Device-SpecificConsiderations.html