AdSize

Kotlin |Java

class AdSize

---

橫幅廣告的大小。

摘要

常數
const Int	AUTO_HEIGHT = -2 這個常數會根據裝置目前方向的高度，調整廣告高度。
const AdSize!	BANNER 行動行銷協會 (MMA) 橫幅廣告大小 (320x50 與密度無關的像素)。
const AdSize!	FLUID 動態調整大小的橫幅，寬度與父項相符，載入完成後會展開/收縮高度，配合廣告內容。
const AdSize!	FULL_BANNER 美國互動廣告協會 (IAB) 完整橫幅廣告大小 (468x60 密度獨立像素)。
const Int	FULL_WIDTH = -1 這個常數會使廣告寬度與目前螢幕方向的裝置寬度相符。
const AdSize!	INVALID 無效的 AdSize，會導致廣告請求立即失敗。
const AdSize!	LARGE_BANNER 大型橫幅廣告尺寸 (320x100 與密度無關的像素)。
const AdSize!	LEADERBOARD 互動廣告協會 (IAB) 超級橫幅廣告大小 (728x90 密度獨立像素)。
const AdSize!	MEDIUM_RECTANGLE 美國互動廣告協會 (IAB) 中矩形廣告大小 (300x250 密度無關像素)。
const AdSize!	SMART_BANNER 這個屬性已淘汰。 請改用 getLargeAnchoredAdaptiveBannerAdSize。
const AdSize!	WIDE_SKYSCRAPER IAB 寬幅摩天大廣告尺寸 (160x600 密度獨立像素)。

公用建構函式
AdSize(width: Int, height: Int) 建立新的 AdSize。

公開函式
Boolean	equals(other: Any?) 比較這個 AdSize 與指定物件，並指出兩者是否相等。
java-static AdSize!	getCurrentOrientationAnchoredAdaptiveBannerAdSize(     context: Context!,     width: Int ) 這個函式已淘汰。 請改用 getLargeAnchoredAdaptiveBannerAdSize。
java-static AdSize!	getCurrentOrientationInlineAdaptiveBannerAdSize(     context: Context!,     width: Int ) 傳回具有指定寬度的 AdSize，高度一律為 0。
Int	getHeightInPixels(context: Context!) 傳回這個 AdSize 的高度 (以實體像素為單位)。
java-static AdSize!	getInlineAdaptiveBannerAdSize(width: Int, maxHeight: Int) 傳回具有指定寬度的 AdSize，高度一律為 0。
java-static AdSize!	getLandscapeAnchoredAdaptiveBannerAdSize(context: Context!, width: Int) 這個函式已淘汰。 請改用 getLargeLandscapeAnchoredAdaptiveBannerAdSize。
java-static AdSize!	getLandscapeInlineAdaptiveBannerAdSize(context: Context!, width: Int) 傳回具有指定寬度的 AdSize，高度一律為 0。
java-static AdSize!	getLargeAnchoredAdaptiveBannerAdSize(context: Context!, width: Int) 傳回指定寬度和 Google 調整至最佳狀態的高度，以建立大型橫幅廣告。AdSize
java-static AdSize!	getLargeLandscapeAnchoredAdaptiveBannerAdSize(     context: Context!,     width: Int ) 傳回指定寬度和 Google 調整至最佳狀態的高度，以建立大型橫幅廣告。AdSize
java-static AdSize!	getLargePortraitAnchoredAdaptiveBannerAdSize(     context: Context!,     width: Int ) 傳回指定寬度和 Google 調整至最佳狀態的高度，以建立大型橫幅廣告。AdSize
java-static AdSize!	getPortraitAnchoredAdaptiveBannerAdSize(context: Context!, width: Int) 這個函式已淘汰。 請改用 getLargePortraitAnchoredAdaptiveBannerAdSize。
java-static AdSize!	getPortraitInlineAdaptiveBannerAdSize(context: Context!, width: Int) 傳回具有指定寬度的 AdSize，高度一律為 0。
Int	getWidthInPixels(context: Context!) 傳回這個 AdSize 的寬度 (以實體像素為單位)。
Int	hashCode()
Boolean	isAutoHeight() 傳回這個 AdSize 是否為自動高度。
Boolean	isFluid() 傳回這個 AdSize 是否為流體大小。
Boolean	isFullWidth() 傳回這個 AdSize 是否為全寬。
String!	toString()

公開屬性
Int	height
Int	width

常數

AUTO_HEIGHT

const val AUTO_HEIGHT = -2: Int

這個常數會根據裝置在目前螢幕方向的高度，調整廣告高度。AUTO_HEIGHT 廣告會在 AdView 初始化期間決定高度，之後就不會再變更。

頻道橫幅

const val BANNER: AdSize!

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

FLUID

const val FLUID: AdSize!

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

FULL_BANNER

const val FULL_BANNER: AdSize!

美國互動廣告協會 (IAB) 完整橫幅廣告大小 (468x60 密度獨立像素)。

FULL_WIDTH

const val FULL_WIDTH = -1: Int

這個常數會使廣告寬度與目前螢幕方向的裝置寬度相符。FULL_WIDTH 廣告會在 AdView 初始化期間決定寬度，之後就不會再變更。

無效

const val INVALID: AdSize!

無效的 AdSize，會導致廣告請求立即失敗。

LARGE_BANNER

const val LARGE_BANNER: AdSize!

大型橫幅廣告尺寸 (320x100 與密度無關的像素)。

排行榜

const val LEADERBOARD: AdSize!

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

MEDIUM_RECTANGLE

const val MEDIUM_RECTANGLE: AdSize!

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

SMART_BANNER

const val SMART_BANNER: AdSize!

這個屬性已淘汰。

請改用 getLargeAnchoredAdaptiveBannerAdSize。

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

WIDE_SKYSCRAPER

const val WIDE_SKYSCRAPER: AdSize!

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

公用建構函式

AdSize

AdSize(width: Int, height: Int)

建立新的 AdSize。

參數
width: Int	廣告的寬度，以密度獨立像素為單位。
height: Int	廣告的高度 (以密度獨立像素為單位)。

擲回
java.lang.IllegalArgumentException	寬度或高度為負數。

公開函式

等於

fun equals(other: Any?): Boolean

比較這個 AdSize 與指定物件，並指出兩者是否相等。

getCurrentOrientationAnchoredAdaptiveBannerAdSize

java-static fun getCurrentOrientationAnchoredAdaptiveBannerAdSize(
    context: Context!,
    width: Int
): AdSize!

這個函式已淘汰。

請改用 getLargeAnchoredAdaptiveBannerAdSize。

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

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

getCurrentOrientationInlineAdaptiveBannerAdSize

java-static fun getCurrentOrientationInlineAdaptiveBannerAdSize(
    context: Context!,
    width: Int
): AdSize!

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

getHeightInPixels

fun getHeightInPixels(context: Context!): Int

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

getInlineAdaptiveBannerAdSize

java-static fun getInlineAdaptiveBannerAdSize(width: Int, maxHeight: Int): AdSize!

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

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

getLandscapeAnchoredAdaptiveBannerAdSize

java-static fun getLandscapeAnchoredAdaptiveBannerAdSize(context: Context!, width: Int): AdSize!

這個函式已淘汰。

請改用 getLargeLandscapeAnchoredAdaptiveBannerAdSize。

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

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

getLandscapeInlineAdaptiveBannerAdSize

java-static fun getLandscapeInlineAdaptiveBannerAdSize(context: Context!, width: Int): AdSize!

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

getLargeAnchoredAdaptiveBannerAdSize

java-static fun getLargeAnchoredAdaptiveBannerAdSize(context: Context!, width: Int): AdSize!

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

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

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

getLargeLandscapeAnchoredAdaptiveBannerAdSize

java-static fun getLargeLandscapeAnchoredAdaptiveBannerAdSize(
    context: Context!,
    width: Int
): AdSize!

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

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

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

getLargePortraitAnchoredAdaptiveBannerAdSize

java-static fun getLargePortraitAnchoredAdaptiveBannerAdSize(
    context: Context!,
    width: Int
): AdSize!

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

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

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

getPortraitAnchoredAdaptiveBannerAdSize

java-static fun getPortraitAnchoredAdaptiveBannerAdSize(context: Context!, width: Int): AdSize!

這個函式已淘汰。

請改用 getLargePortraitAnchoredAdaptiveBannerAdSize。

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

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

getPortraitInlineAdaptiveBannerAdSize

java-static fun getPortraitInlineAdaptiveBannerAdSize(context: Context!, width: Int): AdSize!

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

getWidthInPixels

fun getWidthInPixels(context: Context!): Int

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

hashCode

fun hashCode(): Int

isAutoHeight

fun isAutoHeight(): Boolean

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

isFluid

fun isFluid(): Boolean

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

isFullWidth

fun isFullWidth(): Boolean

傳回這個 AdSize 是否為全寬。

toString

fun toString(): String!

公開屬性

高度

val height: Int

寬度

val width: Int