# kADGWipeTheme

フレーム/フレーム内テキスト/クローズボタンのテーマ選択

  • kADGWipeThemeLight : フレーム(薄グレー)/テキスト(黒)/クローズボタン(黒地白抜き)
  • kADGWipeThemeDark : フレーム(濃グレー)/テキスト(白)/クローズボタン(白フチ+黒地白抜き)

# kADGWipePosition

フレームの初期表示位置の選択

  • kADGWipePositionTopRight : 右上
  • kADGWipePositionBottomRight : 右下
  • kADGWipePositionTopLeft : 左上
  • kADGWipePositionBottomLeft : 左下

# ADGWipe

NSObject
└ ADGWipe

# Properties

# delegate

@property (nonatomic, assign) id delegate

デリゲートのインスタンスを取得・設定します。


# rootViewController

@property (nonatomic, assign, setter=setRootViewController:) UIViewController *rootViewController

画面上の一番基底となるViewControllerを取得・設定します。


# Methods

# -initWithLocationID:position:margin:width:rootViewController:

- (nonnull instancetype)initWithLocationID:(nonnull NSString *)locationID
                                  position:(kADGWipePosition)position
                                    margin:(float)margin
                                     width:(float)width
                        rootViewController:(id)rootViewController;

イニシャライザ

Parameters

Parameter Description
locationID ページID(広告枠ID)
position WipeAdの初期位置
margin 指定されたpositionに対しての追加マージン
(右上、左上ならTopマージン, 右下、左下ならBottomマージンとなる)
width 広告の横幅(dp)
rootViewController 表示対象のViewController

Return
ADGWipeのインスタンス


# -setWipeViewTheme:

- (void)setWipeViewTheme:(kADGWipeTheme)theme;

WipeAdのテーマをセットする
kADGWipeThemeLight : フレーム(薄グレー)/テキスト(黒)/クローズボタン(黒地白抜き)
kADGWipeThemeDark : フレーム(濃グレー)/テキスト(白)/クローズボタン(白フチ+黒地白抜き)

Parameters

Parameter Description
theme kADGWipeThemeLight / kADGWipeThemeDark

# - setFrameHidden:

- (void)setFrameHidden:(BOOL)isHidden;

WipeAdのフレーム有無をセットする

Parameters

Parameter Description
isHidden YES:フレームなし / NO:フレームあり

# - setFrameColor:

- (void)setFrameColor:(id)frameColor;

WipeAdのフレーム色(UIColor)をセットする

Parameters

Parameter Description
frameColor フレーム色

# - setFrameColor:alpha:

- (void)setFrameColor:(nonnull NSString *)hex alpha:(CGFloat)alpha;

WipeAdのフレーム色(HEX)と透過度(alpha)をセットする

Parameters

Parameter Description
hex フレーム色
alpha 透過度

# - setFrameColorTheme:

- (void)setFrameColorTheme:(kADGWipeTheme)theme;

WipeAdのフレーム色のテーマカラーをセットする

Parameters

Parameter Description
theme kADGWipeThemeLight:薄いグレー / kADGWipeThemeDark:濃いグレー

# - setFrameTextColorTheme:

- (void)setFrameTextColorTheme:(kADGWipeTheme)theme;

フレーム内のテキスト色を変更する

Parameters

Parameter Description
theme kADGWipeThemeLight:黒文字 / kADGWipeThemeDark:白文字

# - setFrameText:

- (void)setFrameText:(nonnull NSString *)text;

フレーム内のテキストを変更する
(default:Advertisement)

Parameters

Parameter Description
text テキスト

# - setEnableTestMode:

- (void)setEnableTestMode:(BOOL)isTest;

テストモードを変更する

Parameters

Parameter Description
isTest YES:テストモードON / NO:テストモードOFF

# - setContentUrl:

- (void)setContentUrl:(nonnull NSString *)url;

コンテンツURLをセットする

Parameters

Parameter Description
url コンテンツURL

# - preload

- (void)preload;

広告をロードする


# - show

- (BOOL)show;

広告を表示する

Return
YES:成功 / NO:失敗


# - dismiss

- (void)dismiss;

広告を非表示にする


# ADGWipeDelegate

ADGManagerViewControllerDelegate
└ ADGWipeDelegate

# Methods

# ADGWipeClose

- (void)ADGWipeClose;

ワイプアドがクローズされたことを通知する

# 表示位置の詳細計算

# 上端配置時のマージン計算(kADGWipePositionTopRight / kADGWipePositionTopLeft)

画面最上端(Y座標0)からの実際のマージンは以下の要素の合計で決定されます:

総マージン = ユーザー指定マージン + ステータスバー高さ + ナビゲーションバー高さ + 画面端マージン(5.0)

# 各要素の詳細

  1. ユーザー指定マージン: 初期化時のmarginパラメータで指定した値
  2. ステータスバー高さ:
    • 通常: 20ピクセル
    • iPhone X以降のノッチ付き端末: 44〜59ピクセル
    • フルスクリーンモード: 0ピクセル
  3. ナビゲーションバー高さ:
    • 標準: 44ピクセル(存在する場合)
    • 存在しない場合: 0ピクセル
  4. 画面端マージン: 5.0ピクセル(固定値)

# 計算例

  • 最小構成(フルスクリーン、ナビゲーションバーなし、ユーザー指定マージン0): 5ピクセル
  • 標準構成(通常のステータスバー、ナビゲーションバーあり、ユーザー指定マージン10): 10 + 20 + 44 + 5 = 79ピクセル
  • iPhone X以降(ノッチ付き、ナビゲーションバーあり、ユーザー指定マージン10): 10 + 44 + 44 + 5 = 103ピクセル

# 下端配置時のマージン計算(kADGWipePositionBottomRight / kADGWipePositionBottomLeft)

画面最下端からの実際のマージンは以下の要素の合計で決定されます:

総マージン = ユーザー指定マージン + ワイプアド高さ + フレーム高さ(25.0) + 画面下端マージン(35.0)

# 画面下端マージンは35ピクセルで固定されており、これはホームインジケータを考慮した値です。

Last Updated: 8/1/2025, 5:57:25 AM