AdSize

Kotlin |Java

public final class AdSize

---

バナー広告のサイズ。

概要

定数
static final int	AUTO_HEIGHT = -2 現在の向きのデバイスの高さに基づいて広告の高さをスケーリングする定数。
static final AdSize	BANNER Mobile Marketing Association（MMA）バナー広告サイズ（320x50 密度非依存ピクセル）。
static final AdSize	FLUID 親の幅に合わせてサイズが動的に調整され、読み込みが完了すると広告のコンテンツに合わせて高さが拡大/縮小されるバナー。
static final AdSize	FULL_BANNER Interactive Advertising Bureau（IAB）フルバナー広告サイズ（468x60 密度非依存ピクセル）。
static final int	FULL_WIDTH = -1 広告の幅を現在の向きのデバイスの幅に合わせる定数。
static final AdSize	INVALID 広告リクエストがすぐに失敗する無効な AdSize。
static final AdSize	LARGE_BANNER ラージバナー広告サイズ（320x100 密度非依存ピクセル）。
static final AdSize	LEADERBOARD Interactive Advertising Bureau（IAB）リーダーボード広告サイズ（728x90 密度非依存ピクセル）。
static final AdSize	MEDIUM_RECTANGLE Interactive Advertising Bureau（IAB）レクタングル（中）広告サイズ（300x250 密度非依存ピクセル）。
static final AdSize	SMART_BANNER このフィールドは非推奨です。 getLargeAnchoredAdaptiveBannerAdSize を代わりに使用してください。
static final AdSize	WIDE_SKYSCRAPER IAB ワイド スカイスクレイパー広告サイズ（160x600 密度非依存ピクセル）。

パブリック フィールド
final int	height
final int	width

パブリック コンストラクタ
AdSize(int width, int height) 新しい AdSize を作成します。

パブリック メソッド
boolean	equals(@Nullable Object other) この AdSize を指定されたオブジェクトと比較し、等しいかどうかを示します。
static AdSize	getCurrentOrientationAnchoredAdaptiveBannerAdSize(     Context context,     int width ) このメソッドは非推奨です。 getLargeAnchoredAdaptiveBannerAdSize を代わりに使用してください。
static AdSize	getCurrentOrientationInlineAdaptiveBannerAdSize(     Context context,     int width ) 指定された幅と、常に 0 の高さを持つ AdSize を返します。
int	getHeight() この AdSize の高さを密度非依存ピクセル単位で返します。
int	getHeightInPixels(Context context) この AdSize の高さ（物理ピクセル単位）を返します。
static AdSize	getInlineAdaptiveBannerAdSize(int width, int maxHeight) 指定された幅と、常に 0 の高さを持つ AdSize を返します。
static AdSize	getLandscapeAnchoredAdaptiveBannerAdSize(Context context, int width) このメソッドは非推奨です。 getLargeLandscapeAnchoredAdaptiveBannerAdSize を代わりに使用してください。
static AdSize	getLandscapeInlineAdaptiveBannerAdSize(Context context, int width) 指定された幅と、常に 0 の高さを持つ AdSize を返します。
static AdSize	getLargeAnchoredAdaptiveBannerAdSize(Context context, int width) 指定した幅と Google によって最適化された高さで AdSize を返し、ラージ バナー広告を作成します。
static AdSize	getLargeLandscapeAnchoredAdaptiveBannerAdSize(     Context context,     int width ) 指定した幅と Google によって最適化された高さで AdSize を返し、ラージ バナー広告を作成します。
static AdSize	getLargePortraitAnchoredAdaptiveBannerAdSize(     Context context,     int width ) 指定した幅と Google によって最適化された高さで AdSize を返し、ラージ バナー広告を作成します。
static AdSize	getPortraitAnchoredAdaptiveBannerAdSize(Context context, int width) このメソッドは非推奨です。 getLargePortraitAnchoredAdaptiveBannerAdSize を代わりに使用してください。
static AdSize	getPortraitInlineAdaptiveBannerAdSize(Context context, int width) 指定された幅と、常に 0 の高さを持つ AdSize を返します。
int	getWidth() この AdSize の幅を密度非依存ピクセル単位で返します。
int	getWidthInPixels(Context context) この AdSize の幅を物理ピクセル単位で返します。
int	hashCode()
boolean	isAutoHeight() この AdSize が自動高さかどうかを返します。
boolean	isFluid() この AdSize が流動的なサイズかどうかを返します。
boolean	isFullWidth() この AdSize が全角かどうかを返します。
String	toString()

定数

AUTO_HEIGHT

public static final int AUTO_HEIGHT = -2

現在の向きのデバイスの高さに基づいて広告の高さをスケーリングする定数。AUTO_HEIGHT 広告は、AdView の初期化時に高さを決定し、その後は変更されません。

バナー

public static final AdSize BANNER

Mobile Marketing Association（MMA）バナー広告サイズ（320x50 密度非依存ピクセル）。

FLUID

public static final AdSize FLUID

親の幅に合わせてサイズが動的に調整され、読み込みが完了すると広告のコンテンツに合わせて高さが拡大/縮小されるバナー。

FULL_BANNER

public static final AdSize FULL_BANNER

Interactive Advertising Bureau（IAB）フルバナー広告サイズ（468x60 密度非依存ピクセル）。

FULL_WIDTH

public static final int FULL_WIDTH = -1

広告の幅を現在の向きのデバイスの幅に合わせる定数。FULL_WIDTH 広告は AdView の初期化時に幅を決定し、その後は変更されません。

無効

public static final AdSize INVALID

広告リクエストがすぐに失敗する無効な AdSize。

LARGE_BANNER

public static final AdSize LARGE_BANNER

ラージバナー広告サイズ（320x100 密度非依存ピクセル）。

LEADERBOARD

public static final AdSize LEADERBOARD

Interactive Advertising Bureau（IAB）リーダーボード広告サイズ（728x90 密度非依存ピクセル）。

MEDIUM_RECTANGLE

public static final AdSize MEDIUM_RECTANGLE

Interactive Advertising Bureau（IAB）レクタングル（中）広告サイズ（300x250 密度非依存ピクセル）。

SMART_BANNER

public static final AdSize SMART_BANNER

このフィールドは非推奨になりました。

getLargeAnchoredAdaptiveBannerAdSize を代わりに使用してください。

全幅で高さが自動調整される、サイズが動的に変化するバナー。

WIDE_SKYSCRAPER

public static final AdSize WIDE_SKYSCRAPER

IAB ワイド スカイスクレイパー広告サイズ（160x600 密度非依存ピクセル）。このサイズは現在、Google モバイル広告ネットワークではサポートされていません。メディエーション広告ネットワークのみを対象としています。

パブリック フィールド

height

public final int height

width

public final int width

パブリック コンストラクタ

AdSize

public AdSize(int width, int height)

新しい AdSize を作成します。

パラメータ
int width	広告の幅（密度非依存ピクセル単位）。
int height	密度非依存ピクセル単位の広告の高さ。

例外
java.lang.IllegalArgumentException	幅または高さが負の値の場合。

パブリック メソッド

等号

public boolean equals(@Nullable Object other)

この AdSize を指定されたオブジェクトと比較し、等しいかどうかを示します。

getCurrentOrientationAnchoredAdaptiveBannerAdSize

public static AdSize getCurrentOrientationAnchoredAdaptiveBannerAdSize(
    Context context,
    int width
)

このメソッドは非推奨です。

getLargeAnchoredAdaptiveBannerAdSize を代わりに使用してください。

指定した幅と Google によって最適化された高さで AdSize を返し、バナー広告を作成します。返されるサイズは AdSize と同様のアスペクト比になり、アプリの上部または下部に固定するのに適しています。高さは、デバイスの現在の向きの高さの 15% を超えることはなく、50 ピクセルを下回ることもありません。この関数は、幅とデバイスの組み合わせに関係なく、常に同じ高さを返します。コンテキストが null の場合、またはコンテキストからデバイスの高さを特定できない場合は、INVALID が返されます。

戻り値
AdSize	AdSize オブジェクト。コンテキストが null の場合、またはコンテキストからデバイスの高さを特定できない場合は、INVALID を返します。

getCurrentOrientationInlineAdaptiveBannerAdSize

public static AdSize getCurrentOrientationInlineAdaptiveBannerAdSize(
    Context context,
    int width
)

指定された幅と、常に 0 の高さを持つ AdSize を返します。この広告サイズを使用すると、Google のサーバーは、リクエストされた向きの画面の高さ以内で最適な広告サイズを選択できるようになります。返される広告の正確なサイズは、onAdLoaded コールバック内で getAdSize を呼び出すことで取得できます。この広告サイズは、スクロール可能なコンテンツ内に表示することを目的とした広告に最適です。

getHeight

public int getHeight()

この AdSize の高さを密度非依存ピクセル単位で返します。

getHeightInPixels

public int getHeightInPixels(Context context)

この AdSize の高さ（物理ピクセル単位）を返します。Fluid サイズの場合は -1 を返します。

getInlineAdaptiveBannerAdSize

public static AdSize getInlineAdaptiveBannerAdSize(int width, int maxHeight)

指定された幅と、常に 0 の高さを持つ AdSize を返します。この広告サイズを使用すると、Google のサーバーは、maxHeight パラメータで指定された最大の高さ以内で最適な広告サイズを選択できるようになります。返される広告の正確なサイズは、onAdLoaded コールバック内で getAdSize を呼び出すことで取得できます。この広告サイズは、スクロール可能なコンテンツ内に表示することを目的とした広告に最適です。

パラメータ
int maxHeight	読み込まれた広告の最大高さ。32 dp 以上にする必要がありますが、maxHeight は 50 dp 以上にすることが推奨されます。

getLandscapeAnchoredAdaptiveBannerAdSize

public static AdSize getLandscapeAnchoredAdaptiveBannerAdSize(Context context, int width)

このメソッドは非推奨です。

getLargeLandscapeAnchoredAdaptiveBannerAdSize を代わりに使用してください。

指定した幅と Google によって最適化された高さで AdSize を返し、バナー広告を作成します。返されるサイズは BANNER に近いアスペクト比になり、アプリの上部または下部に固定するのに適しています。高さは横向きモードのデバイスの高さの 15% を超えることはなく、50 ピクセルを下回ることもありません。この関数は、幅とデバイスの組み合わせに関係なく、常に同じ高さを返します。コンテキストが null の場合、またはコンテキストからデバイスの高さを特定できない場合は、INVALID が返されます。

戻り値
AdSize	AdSize オブジェクト。コンテキストが null の場合、またはコンテキストからデバイスの高さを特定できない場合は、INVALID を返します。

getLandscapeInlineAdaptiveBannerAdSize

public static AdSize getLandscapeInlineAdaptiveBannerAdSize(Context context, int width)

指定された幅と、常に 0 の高さを持つ AdSize を返します。この広告サイズを使用すると、Google のサーバーは、横向きの画面の高さ以内で最適な広告サイズを選択できるようになります。返される広告の正確なサイズは、onAdLoaded コールバック内で getAdSize を呼び出すことで取得できます。この広告サイズは、スクロール可能なコンテンツ内に表示することを目的とした広告に最適です。

getLargeAnchoredAdaptiveBannerAdSize

public static AdSize getLargeAnchoredAdaptiveBannerAdSize(Context context, int width)

指定した幅と Google によって最適化された高さで AdSize を返し、ラージ バナー広告を作成します。返されるサイズは、アプリの上部または下部に固定するのに適しています。高さは、デバイスの現在の向きの高さの 20% を超えることはなく、常に 50 ～ 150 密度非依存ピクセルの範囲内です。この関数は、幅とデバイスの組み合わせに関係なく、常に同じ高さを返します。コンテキストが null の場合、またはコンテキストからデバイスの高さを特定できない場合は、INVALID が返されます。

パラメータ
Context context	画面の寸法など、デバイス固有の情報を特定するために使用される Context。
int width	広告ユニットの希望する幅（密度非依存ピクセル単位）。

戻り値
AdSize	AdSize オブジェクト。コンテキストが null の場合、またはコンテキストからデバイスの高さを特定できない場合は、INVALID を返します。

getLargeLandscapeAnchoredAdaptiveBannerAdSize

public static AdSize getLargeLandscapeAnchoredAdaptiveBannerAdSize(
    Context context,
    int width
)

指定した幅と Google によって最適化された高さで AdSize を返し、ラージ バナー広告を作成します。返されるサイズは、アプリの上部または下部に固定されたバナー広告での使用に適しています。高さは、横向きモードのデバイスの高さの 20% を超えることはなく、常に 50 ～ 150 密度非依存ピクセルです。この関数は、幅とデバイスの組み合わせに関係なく、常に同じ高さを返します。コンテキストが null の場合、またはコンテキストからデバイスの高さを特定できない場合は、INVALID が返されます。

パラメータ
Context context	画面の寸法など、デバイス固有の情報を特定するために使用される Context。
int width	広告ユニットの希望する幅（密度非依存ピクセル単位）。

戻り値
AdSize	AdSize オブジェクト。コンテキストが null の場合、またはコンテキストからデバイスの高さを特定できない場合は、INVALID を返します。

getLargePortraitAnchoredAdaptiveBannerAdSize

public static AdSize getLargePortraitAnchoredAdaptiveBannerAdSize(
    Context context,
    int width
)

指定した幅と Google によって最適化された高さで AdSize を返し、ラージ バナー広告を作成します。返されるサイズは、アプリの上部または下部に固定されたバナー広告での使用に適しています。高さはデバイスの縦向きの高さの 20% を超えることはなく、常に 50 ～ 150 密度非依存ピクセルの範囲内です。この関数は、幅とデバイスの組み合わせに関係なく、常に同じ高さを返します。

パラメータ
Context context	画面の寸法など、デバイス固有の情報を特定するために使用される Context。
int width	広告ユニットの希望する幅（密度非依存ピクセル単位）。

戻り値
AdSize	AdSize オブジェクト。コンテキストが null の場合、またはコンテキストからデバイスの高さを特定できない場合は、INVALID を返します。

getPortraitAnchoredAdaptiveBannerAdSize

public static AdSize getPortraitAnchoredAdaptiveBannerAdSize(Context context, int width)

このメソッドは非推奨です。

getLargePortraitAnchoredAdaptiveBannerAdSize を代わりに使用してください。

指定した幅と Google によって最適化された高さで AdSize を返し、バナー広告を作成します。返されるサイズは BANNER に近いアスペクト比になり、アプリの上部または下部にアンカーするのに適しています。高さは、デバイスの縦向きの高さの 15% を超えることはなく、50 ピクセルを下回ることもありません。この関数は、幅とデバイスの組み合わせに関係なく、常に同じ高さを返します。

戻り値
AdSize	AdSize オブジェクト。コンテキストが null の場合、またはコンテキストからデバイスの高さを特定できない場合は、INVALID を返します。

getPortraitInlineAdaptiveBannerAdSize

public static AdSize getPortraitInlineAdaptiveBannerAdSize(Context context, int width)

指定された幅と、常に 0 の高さを持つ AdSize を返します。この広告サイズを使用すると、Google のサーバーは、縦向きの画面の高さ以内で最適な広告サイズを選択できるようになります。返される広告の正確なサイズは、onAdLoaded コールバック内で getAdSize を呼び出すことで取得できます。この広告サイズは、スクロール可能なコンテンツ内に表示することを目的とした広告に最適です。

getWidth

public int getWidth()

この AdSize の幅を密度非依存ピクセル単位で返します。

getWidthInPixels

public int getWidthInPixels(Context context)

この AdSize の幅を物理ピクセル単位で返します。Fluid サイズの場合は -1 を返します。

hashCode

public int hashCode()

isAutoHeight

public boolean isAutoHeight()

この AdSize が自動高さかどうかを返します。

isFluid

public boolean isFluid()

この AdSize が流動的なサイズかどうかを返します。

isFullWidth

public boolean isFullWidth()

この AdSize が全角かどうかを返します。

toString

public String toString()