Skip to main content

사운드 재생

1. 광고 재생의 종류​

  • 광고가 재생될 때, 소리가 켜져있는 상태로 재생될 경우 사운드 재생이라고 합니다.

  • 광고가 재생될 때, 소리가 꺼져있는 상태로 재생될 경우 음소거 재생이라고 합니다.

SDK는 사운드 재생과 음소거 재생을 순차적으로 시도하며 모두 실패할 경우 재생 실패 에러를 발생시킵니다.

caution

사용자의 환경 (OS, 브라우저 등)에 따라 적용되는 재생 종류가 다를 수 있습니다.

2. 사운드 재생을 최대한 보장하기​

2-1. contentVideo의 볼륨 설정하기​

SDK는 광고의 볼륨을 설정할 때 contentVideo 요소의 volume, mute 값을 참조합니다. (참고: 광고 초기 볼륨 설정)

따라서 사운드 재생을 시도하기 위해서는 아래 조건을 모두 만족해야 합니다.

  1. contentVideo.volume > 0

  2. contentVideo.muted === false

2-2. 사용자 클릭 스코프 내에서 AdDisplayContainer 초기화​

  • 사용자가 콘텐츠 영상을 클릭하여 재생할 때 클릭 스코프 내에서 [videoAdScheduleManager.initializeAdDisplayContainer()]가 호출되어야 합니다. (참고: AdDisplayContainer 초기화하기)

    contentPlayButtonElement.addEventListener('click', () => {
      const videoAdScheduleManager = gfpInstream.findAdScheduleManager(adVideoContainer);

      if (videoAdScheduleManager) {
        videoAdScheduleManager.initializeAdDisplayContainer();
      }
    });
    info

    click 이벤트 외에 touchstart, keydown 이벤트에서도 초기화가 가능합나다.

3. 참고 자료​