AdSize

Kotlin |Java

public final class AdSize

---

橫幅廣告的大小。

摘要

常數
static final int	AUTO_HEIGHT = -2 這個常數會根據裝置目前方向的高度，調整廣告高度。
static final AdSize	BANNER 行動行銷協會 (MMA) 橫幅廣告大小 (320x50 與密度無關的像素)。
static final AdSize	FLUID 動態調整大小的橫幅，寬度與父項相符，載入完成後會展開/收縮高度，配合廣告內容。
static final AdSize	FULL_BANNER 美國互動廣告協會 (IAB) 完整橫幅廣告大小 (468x60 密度獨立像素)。
static final int	FULL_WIDTH = -1 這個常數會使廣告寬度與目前螢幕方向的裝置寬度相符。
static final AdSize	INVALID 無效的 AdSize，會導致廣告請求立即失敗。
static final AdSize	LARGE_BANNER 大型橫幅廣告尺寸 (320x100 與密度無關的像素)。
static final AdSize	LEADERBOARD 互動廣告協會 (IAB) 超級橫幅廣告大小 (728x90 密度獨立像素)。
static final AdSize	MEDIUM_RECTANGLE 美國互動廣告協會 (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 ) 傳回具有指定寬度的 AdSize，高度一律為 0。
int	getHeight() 傳回這個 AdSize 的高度，單位為密度獨立像素。
int	getHeightInPixels(Context context) 傳回這個 AdSize 的高度 (以實體像素為單位)。
static AdSize	getInlineAdaptiveBannerAdSize(int width, int maxHeight) 傳回具有指定寬度的 AdSize，高度一律為 0。
static AdSize	getLandscapeAnchoredAdaptiveBannerAdSize(Context context, int width) 這個方法已淘汰。 請改用 getLargeLandscapeAnchoredAdaptiveBannerAdSize。
static AdSize	getLandscapeInlineAdaptiveBannerAdSize(Context context, int width) 傳回具有指定寬度的 AdSize，高度一律為 0。
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) 傳回具有指定寬度的 AdSize，高度一律為 0。
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

行動行銷協會 (MMA) 橫幅廣告大小 (320x50 與密度無關的像素)。

FLUID

public static final AdSize FLUID

動態調整大小的橫幅，寬度與父項相符，載入完成後會展開/收縮高度，配合廣告內容。

FULL_BANNER

public static final AdSize FULL_BANNER

美國互動廣告協會 (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 與密度無關的像素)。

排行榜

public static final AdSize LEADERBOARD

互動廣告協會 (IAB) 超級橫幅廣告大小 (728x90 密度獨立像素)。

MEDIUM_RECTANGLE

public static final AdSize MEDIUM_RECTANGLE

美國互動廣告協會 (IAB) 中矩形廣告大小 (300x250 密度無關像素)。

SMART_BANNER

public static final AdSize SMART_BANNER

這個欄位已淘汰。

請改用 getLargeAnchoredAdaptiveBannerAdSize。

動態調整大小的橫幅，寬度會填滿整個畫面，高度則會自動調整。

WIDE_SKYSCRAPER

public static final AdSize WIDE_SKYSCRAPER

IAB 寬幅摩天大廣告大小 (160x600 密度獨立像素)。Google 行動廣告聯播網目前不支援這個大小，僅適用於中介服務廣告聯播網。

公開欄位

高度

public final int height

寬度

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 像素。無論寬度 / 裝置組合為何，這項函式一律會傳回相同的高度。如果內容為空值，或無法從內容判斷裝置高度，系統會傳回 INVALID。

傳回
AdSize	AdSize 物件。如果內容為空值，或無法從內容判斷裝置高度，則會傳回 INVALID。

getCurrentOrientationInlineAdaptiveBannerAdSize

public static AdSize getCurrentOrientationInlineAdaptiveBannerAdSize(
    Context context,
    int width
)

傳回具有指定寬度的 AdSize，高度一律為 0。Google 伺服器會根據這個廣告尺寸，在要求的螢幕方向中，選擇高度小於或等於螢幕高度的最佳廣告尺寸。如要擷取傳回的確切廣告大小，請在 onAdLoaded 回呼中呼叫 getAdSize。這種廣告大小最適合在可捲動的內容中顯示廣告。

getHeight

public int getHeight()

傳回這個 AdSize 的高度，單位為密度獨立像素。

getHeightInPixels

public int getHeightInPixels(Context context)

傳回這個 AdSize 的高度 (以實體像素為單位)。如果是自動調整大小，則會傳回 -1。

getInlineAdaptiveBannerAdSize

public static AdSize getInlineAdaptiveBannerAdSize(int width, int maxHeight)

傳回具有指定寬度的 AdSize，高度一律為 0。Google 伺服器會根據這個廣告尺寸，選擇高度小於或等於 maxHeight 參數中指定高度上限的最佳廣告尺寸。如要擷取傳回的確切廣告大小，請在 onAdLoaded 回呼中呼叫 getAdSize。這種廣告大小最適合在可捲動的內容中顯示廣告。

參數
int maxHeight	載入廣告的高度上限。至少須為 32 dp，但建議使用 50 dp 以上的 maxHeight。

getLandscapeAnchoredAdaptiveBannerAdSize

public static AdSize getLandscapeAnchoredAdaptiveBannerAdSize(Context context, int width)

這個方法已淘汰。

請改用 getLargeLandscapeAnchoredAdaptiveBannerAdSize。

傳回指定寬度和 Google 調整至最佳狀態的高度，以建立橫幅廣告。AdSize傳回的尺寸長寬比與 BANNER 類似，適合錨定在應用程式頂端或底部。橫向模式的高度上限為裝置高度的 15%，下限則為 50 像素。無論寬度 / 裝置組合為何，這項函式一律會傳回相同的高度。如果內容為空值，或無法從內容判斷裝置高度，系統會傳回 INVALID。

傳回
AdSize	AdSize 物件。如果內容為空值，或無法從內容判斷裝置高度，則會傳回 INVALID。

getLandscapeInlineAdaptiveBannerAdSize

public static AdSize getLandscapeInlineAdaptiveBannerAdSize(Context context, int width)

傳回具有指定寬度的 AdSize，高度一律為 0。Google 伺服器會根據這個廣告尺寸，選擇高度小於或等於橫向螢幕高度的最佳廣告尺寸。如要擷取傳回的確切廣告大小，請在 onAdLoaded 回呼中呼叫 getAdSize。這種廣告大小最適合在可捲動的內容中顯示廣告。

getLargeAnchoredAdaptiveBannerAdSize

public static AdSize getLargeAnchoredAdaptiveBannerAdSize(Context context, int width)

傳回指定寬度和 Google 調整至最佳狀態的高度，以建立大型橫幅廣告的 AdSize。傳回的大小適合錨定在應用程式頂端或底部。高度上限為裝置目前螢幕方向高度的 20%，下限則為 50 個密度獨立像素，上限為 150 個密度獨立像素。無論寬度 / 裝置組合為何，這項函式一律會傳回相同的高度。如果內容為空值，或無法從內容判斷裝置高度，系統會傳回 INVALID。

參數
Context context	用於判斷裝置專屬資訊，例如螢幕尺寸。Context
int width	廣告單元的所需寬度，以密度獨立像素為單位。

傳回
AdSize	AdSize 物件。如果內容為空值，或無法從內容判斷裝置高度，則會傳回 INVALID。

getLargeLandscapeAnchoredAdaptiveBannerAdSize

public static AdSize getLargeLandscapeAnchoredAdaptiveBannerAdSize(
    Context context,
    int width
)

傳回指定寬度和 Google 調整至最佳狀態的高度，以建立大型橫幅廣告的 AdSize。傳回的大小適合用於錨定在應用程式頂端或底部的橫幅廣告。在橫向模式中，高度上限為裝置高度的 20%，且一律介於 50 到 150 個密度獨立像素之間。無論寬度 / 裝置組合為何，這項函式一律會傳回相同的高度。如果內容為空值，或無法從內容判斷裝置高度，系統會傳回 INVALID。

參數
Context context	用於判斷裝置專屬資訊，例如螢幕尺寸。Context
int width	廣告單元的所需寬度，以密度獨立像素為單位。

傳回
AdSize	AdSize 物件。如果內容為空值，或無法從內容判斷裝置高度，則會傳回 INVALID。

getLargePortraitAnchoredAdaptiveBannerAdSize

public static AdSize getLargePortraitAnchoredAdaptiveBannerAdSize(
    Context context,
    int width
)

傳回指定寬度和 Google 調整至最佳狀態的高度，以建立大型橫幅廣告的 AdSize。傳回的大小適合用於錨定在應用程式頂端或底部的橫幅廣告。高度上限為裝置直向高度的 20%，且一律介於 50 到 150 個密度獨立像素之間。無論寬度 / 裝置組合為何，這項函式一律會傳回相同的高度。

參數
Context context	用於判斷裝置專屬資訊，例如螢幕尺寸。Context
int width	廣告單元的所需寬度，以密度獨立像素為單位。

傳回
AdSize	AdSize 物件。如果內容為空值，或無法從內容判斷裝置高度，則會傳回 INVALID。

getPortraitAnchoredAdaptiveBannerAdSize

public static AdSize getPortraitAnchoredAdaptiveBannerAdSize(Context context, int width)

這個方法已淘汰。

請改用 getLargePortraitAnchoredAdaptiveBannerAdSize。

傳回指定寬度和 Google 調整至最佳狀態的高度，以建立橫幅廣告。AdSize傳回的尺寸會與 BANNER 的顯示比例相似，適合錨定在應用程式頂端或底部。高度上限為裝置直向高度的 15%，下限則為 50 像素。無論寬度 / 裝置組合為何，這項函式一律會傳回相同的高度。

傳回
AdSize	AdSize 物件。如果內容為空值，或無法從內容判斷裝置高度，則會傳回 INVALID。

getPortraitInlineAdaptiveBannerAdSize

public static AdSize getPortraitInlineAdaptiveBannerAdSize(Context context, int width)

傳回具有指定寬度的 AdSize，高度一律為 0。Google 伺服器會根據這個廣告大小，選擇直向螢幕高度以下的最佳廣告大小。如要擷取傳回的確切廣告大小，請在 onAdLoaded 回呼中呼叫 getAdSize。這種廣告大小最適合在可捲動的內容中顯示廣告。

getWidth

public int getWidth()

傳回這個 AdSize 的寬度，單位為密度獨立像素。

getWidthInPixels

public int getWidthInPixels(Context context)

以實體像素為單位，傳回這個 AdSize 的寬度。如果是自動調整大小，則會傳回 -1。

hashCode

public int hashCode()

isAutoHeight

public boolean isAutoHeight()

傳回這個 AdSize 是否為自動高度。

isFluid

public boolean isFluid()

傳回這個 AdSize 是否為流體大小。

isFullWidth

public boolean isFullWidth()

傳回這個 AdSize 是否為全寬。

toString

public String toString()