NestAdsRichPopupOptions

open class NestAdsRichPopupOptions

리치 팝업 광고의 외관 및 동작을 커스터마이징하는 옵션 클래스입니다.

Public Variables

open var backgroundColor: UIColor

팝업의 배경색입니다.

default: .black

---

open var closeButtonColor: UIColor

닫기 버튼의 색상입니다.

default: .white

---

open var mediaSizeType: MediaSizeType

미디어(이미지/비디오) 크기 타입입니다.

default: .fluid

---

open var buttonOptions: NestAdsButtonOptions

CTA 버튼 옵션입니다.

default: NestAdsButtonOptions()

---

open var videoOptions: NestAdsStandardVideoOptions

비디오 옵션입니다.

default: NestAdsStandardVideoOptions()

---

Public Methods

public init(backgroundColor: UIColor?, closeButtonColor: UIColor?, mediaSizeType: MediaSizeType?, buttonOptions: NestAdsButtonOptions?, videoOptions: NestAdsStandardVideoOptions?)

NestAdsRichPopupOptions를 생성합니다.

매개변수	설명
backgroundColor	팝업 배경색 (nil인 경우 기본값 사용)
closeButtonColor	닫기 버튼 색상 (nil인 경우 기본값 사용)
mediaSizeType	미디어 크기 타입 (nil인 경우 기본값 사용)
buttonOptions	CTA 버튼 옵션 (nil인 경우 기본값 사용)
videoOptions	비디오 옵션 (nil인 경우 기본값 사용)

---

MediaSizeType

미디어 크기 타입을 나타내는 열거형입니다.

case fluid

너비는 부모와 일치하고, 높이는 콘텐츠에 맞춰집니다 (scaleAspectFit).

---

case fill

너비와 높이 모두 부모와 일치합니다 (scaleAspectFill with center crop).

---

case fixed(width: CGFloat, height: CGFloat)

사용자 정의 너비와 높이를 사용합니다.

---

NestAdsButtonOptions

CTA 버튼의 외관을 커스터마이징하는 옵션 클래스입니다.

open var backgroundColor: UIColor

버튼 배경색

default: UIColor(red: 0, green: 0, blue: 0, alpha: 0.7) (70% 불투명도의 검정)

---

open var outlineColor: UIColor?

버튼 테두리/아웃라인 색상 (선택사항)

default: nil

---

open var opacity: CGFloat

버튼 불투명도

default: 0.8

---

open var fontColor: UIColor

버튼 텍스트 색상

default: .white

---

open var fontSize: CGFloat

버튼 폰트 크기

default: 12.0

---

open var fontName: String?

버튼 폰트 이름 (nil인 경우 시스템 폰트 사용)

default: nil

---

open var cornerRadius: CGFloat

버튼 모서리 반경

default: 100.0 (완전히 둥근 모서리)

---

public init(backgroundColor: UIColor?, outlineColor: UIColor?, opacity: CGFloat?, fontColor: UIColor?, fontSize: CGFloat?, fontName: String?, cornerRadius: CGFloat?)

NestAdsButtonOptions를 생성합니다.

---

NestAdsStandardVideoOptions

비디오 재생 및 UI 외관을 설정하는 옵션 클래스입니다.

open var startMuted: Bool

비디오를 음소거 상태로 시작할지 여부

default: true

---

open var playCondition: VideoPlayCondition

비디오 재생 조건

default: .autoStart

---

open var quality: String

비디오 화질

default: NestAdsVideoQualityAuto

---

open var backgroundColor: UIColor

비디오 배경색

default: UIColor(red: 1, green: 1, blue: 1, alpha: 0.8) (80% 불투명도의 흰색)

---

open var progressBarColor: UIColor

진행 바 색상

default: .white

---

open var muteButtonColor: UIColor

음소거 버튼 색상

default: .white

---

open var controllerButtonColor: UIColor

컨트롤러 버튼 색상

default: .white

---

public init(startMuted: Bool, playCondition: VideoPlayCondition, quality: String, backgroundColor: UIColor?, progressBarColor: UIColor?, muteButtonColor: UIColor?, controllerButtonColor: UIColor?)

NestAdsStandardVideoOptions를 생성합니다.

---

VideoPlayCondition

비디오 재생 조건을 나타내는 열거형입니다.

case autoStart

표시되면 자동으로 재생합니다.

---

case autoStartOnWifi

WiFi 연결 시에만 자동으로 재생합니다.

---

case manualStart

사용자가 수동으로 재생합니다.

---

case custom

사용자 정의 재생 제어 (SDK가 재생을 제어하지 않음).

---

사용 예시

// CTA 버튼 옵션 설정
let buttonOptions = NestAdsButtonOptions(
    backgroundColor: UIColor(red: 0, green: 0, blue: 0, alpha: 0.8),
    outlineColor: nil,
    opacity: 0.9,
    fontColor: .white,
    fontSize: 14,
    fontName: nil,
    cornerRadius: 8
)

// 비디오 옵션 설정
let videoOptions = NestAdsStandardVideoOptions(
    startMuted: true,
    playCondition: .autoStart,
    quality: NestAdsVideoQualityAuto,
    backgroundColor: nil,
    progressBarColor: .white,
    muteButtonColor: .white,
    controllerButtonColor: .white
)

// 리치 팝업 옵션 설정
let options = NestAdsRichPopupOptions(
    backgroundColor: .black,
    closeButtonColor: .white,
    mediaSizeType: .fluid,
    buttonOptions: buttonOptions,
    videoOptions: videoOptions
)

richPopupAdView.options = options

---

미디어 크기 타입 예시

// Fluid: 너비는 부모와 일치, 높이는 콘텐츠에 맞춤
options.mediaSizeType = .fluid

// Fill: 너비와 높이 모두 부모와 일치
options.mediaSizeType = .fill

// Fixed: 사용자 정의 크기
options.mediaSizeType = .fixed(width: 320, height: 480)