광고 음소거 및 볼륨 제어

circle-info

AdWhale SDK는 앱의 광고 오디오를 의도적으로 제어할 수 있도록 전역 음소거 및 볼륨 설정 기능을 제공합니다.

이 기능을 사용하면 광고가 소리를 재생하지 않도록 하거나, 또는 낮은 볼륨으로만 재생되도록 앱 정책에 맞게 조정할 수 있습니다.

동영상 광고의 오디오 제어는 일부 광고 소스에만 적용되며, 미디에이션을 통해 로드된 광고에는 적용되지 않을 수 있습니다.

지원 API

AdWhaleAds.sharedInstance.setMuted(muted: Bool)
AdWhaleAds.sharedInstance.setVolume(volume: Float)

동작 개요

설정 상태

광고 오디오 동작

setMuted(true)

광고는 의도적으로 무음 상태로 시작

setMuted(false)

광고는 소리를 재생할 수 있음

setVolume(0.1)

광고 볼륨을 기기 볼륨 대비 10% 비율로 제한

setMuted(Bool)

circle-info

이 설정은 배너, 전면, 리워드, 앱 오프닝, 네이티브 광고를 포함한 모든 광고 유형초기 오디오 재생 상태를 음소거로 설정하기 위한 전역 설정입니다.

AdWhaleAds.sharedInstance.setMuted(true)

동작 특징

  • 음소거 상태에서는 광고의 오디오가 재생되지 않습니다.

  • 음소거가 설정된 경우, setVolume()으로 지정한 볼륨 값은 적용되지 않습니다.

  • 음소거 설정은 광고를 요청(load)하기 전에 적용되어야 하며, 광고가 시작될 때의 초기 오디오 상태에만 영향을 줍니다.

  • 광고 요청 이후에 변경된 음소거 상태는 이미 요청된 광고에는 반영되지 않을 수 있습니다.

circle-exclamation

setVolume(float)

circle-info

이 설정은 광고 소리는 필요하지만, 과도한 음량을 피하고 싶은 경우에 사용합니다.

동작 특징

  • setMuted(true) 상태에서는 setVolume() 값과 관계없이 항상 무음으로 동작합니다.

  • 볼륨 값은 0.0 ~ 1.0 범위 내에서 동작합니다.

circle-exclamation

적용 예시

설정

결과

setMuted(false) + setVolume(0.3)

광고 소리가 작게 재생됨

setMuted(true) + setVolume(0.3)

무음 (의도된 동작)

권장 사용 패턴

circle-info
  • 광고 로드 직전에 반복 호출할 필요는 없습니다.

  • 전역 정책으로 한 번 설정한 뒤 유지하는 방식을 권장합니다.

기본값 안내

circle-info

앱 실행 후 음소거 또는 볼륨 설정을 별도로 호출하지 않은 경우, SDK 초기 상태에서는 아래 기본값이 적용됩니다.

설정

기본값

음소거

OFF (음소거 미적용)

볼륨

1.0 (시스템 볼륨 기준 100%)

Last updated