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 )` 返回一个具有指定宽度且高度始终为 0 的 `AdSize`。
`Int`	`getHeightInPixels(context: Context!)` 返回此 `AdSize` 的高度（以实际像素为单位）。
`java-static AdSize!`	`getInlineAdaptiveBannerAdSize(width: Int, maxHeight: Int)` 返回一个具有指定宽度且高度始终为 0 的 `AdSize`。
`java-static AdSize!`	`getLandscapeAnchoredAdaptiveBannerAdSize(context: Context!, width: Int)` 此函数已弃用。请改用 `getLargeLandscapeAnchoredAdaptiveBannerAdSize`。
`java-static AdSize!`	`getLandscapeInlineAdaptiveBannerAdSize(context: Context!, width: Int)` 返回一个具有指定宽度且高度始终为 0 的 `AdSize`。
`java-static AdSize!`	`getLargeAnchoredAdaptiveBannerAdSize(context: Context!, width: Int)` 返回一个 `AdSize`，其中包含指定宽度和 Google 优化的高度，用于创建大型横幅广告。
`java-static AdSize!`	`getLargeLandscapeAnchoredAdaptiveBannerAdSize( context: Context!, width: Int )` 返回一个 `AdSize`，其中包含指定宽度和 Google 优化的高度，用于创建大型横幅广告。
`java-static AdSize!`	`getLargePortraitAnchoredAdaptiveBannerAdSize( context: Context!, width: Int )` 返回一个 `AdSize`，其中包含指定宽度和 Google 优化的高度，用于创建大型横幅广告。
`java-static AdSize!`	`getPortraitAnchoredAdaptiveBannerAdSize(context: Context!, width: Int)` 此函数已弃用。请改用 `getLargePortraitAnchoredAdaptiveBannerAdSize`。
`java-static AdSize!`	`getPortraitInlineAdaptiveBannerAdSize(context: Context!, width: Int)` 返回一个具有指定宽度且高度始终为 0 的 `AdSize`。
`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!

一种动态调整尺寸的横幅广告，宽度为全宽度，高度为自动高度。

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!

返回一个 AdSize，其中包含指定宽度和 Google 优化的高度，用于创建横幅广告。返回的尺寸将具有与 AdSize 类似的宽高比，适合锚定在应用顶部或底部附近。高度永远不会超过设备当前屏幕方向下高度的 15%，也永远不会小于 50 像素。此函数始终会针对任何宽度 / 设备组合返回相同的高度。如果上下文为 null 或无法从上下文中确定设备高度，则返回 INVALID。

返回
`AdSize!`	`AdSize` 对象。如果上下文为 null 或无法从上下文中确定设备高度，则返回 `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，但建议将 maxHeight 设置为 50 dp 或更高值。

getLandscapeAnchoredAdaptiveBannerAdSize

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

返回一个 AdSize，其中包含指定宽度和 Google 优化的高度，用于创建横幅广告。返回的尺寸的宽高比与 BANNER 类似，适合锚定在应用顶部或底部附近。在横屏模式下，高度始终不会超过设备高度的 15%，也始终不小于 50 像素。此函数始终会针对任何宽度 / 设备组合返回相同的高度。如果上下文为 null 或无法从上下文中确定设备高度，则返回 INVALID。

返回
`AdSize!`	`AdSize` 对象。如果上下文为 null 或无法从上下文中确定设备高度，则返回 `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!

返回一个 AdSize，其中包含指定宽度和 Google 优化的高度，用于创建大型横幅广告。返回的尺寸适合锚定在应用顶部或底部附近。高度始终不会超过设备当前屏幕方向下高度的 20%，且始终介于 50-150 密度无关像素之间。此函数始终会针对任何宽度 / 设备组合返回相同的高度。如果上下文为 null 或无法从上下文中确定设备高度，则返回 INVALID。

参数
`context: Context!`	用于确定设备特定信息（例如屏幕尺寸）的 `Context`。
`width: Int`	广告单元的所需宽度（以密度无关像素为单位）。

返回
`AdSize!`	`AdSize` 对象。如果上下文为 null 或无法从上下文中确定设备高度，则返回 `INVALID`。

getLargeLandscapeAnchoredAdaptiveBannerAdSize

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

返回一个 AdSize，其中包含指定宽度和 Google 优化的高度，用于创建大型横幅广告。返回的尺寸适合在锚定于应用顶部或底部的横幅广告中使用。在横屏模式下，高度始终不会超过设备高度的 20%，并且始终介于 50-150 密度无关像素之间。此函数始终会针对任何宽度 / 设备组合返回相同的高度。如果上下文为 null 或无法从上下文中确定设备高度，则返回 INVALID。

参数
`context: Context!`	用于确定设备特定信息（例如屏幕尺寸）的 `Context`。
`width: Int`	广告单元的所需宽度（以密度无关像素为单位）。

返回
`AdSize!`	`AdSize` 对象。如果上下文为 null 或无法从上下文中确定设备高度，则返回 `INVALID`。

getLargePortraitAnchoredAdaptiveBannerAdSize

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

返回一个 AdSize，其中包含指定宽度和 Google 优化的高度，用于创建大型横幅广告。返回的尺寸适合用于锚定在应用顶部或底部的横幅广告。高度始终不会超过设备竖屏高度的 20%，且始终介于 50-150 密度无关像素之间。此函数始终会针对任何宽度 / 设备组合返回相同的高度。

参数
`context: Context!`	用于确定设备特定信息（例如屏幕尺寸）的 `Context`。
`width: Int`	广告单元的所需宽度（以密度无关像素为单位）。

返回
`AdSize!`	`AdSize` 对象。如果上下文为 null 或无法从上下文中确定设备高度，则返回 `INVALID`。

getPortraitAnchoredAdaptiveBannerAdSize

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

返回一个 AdSize，其中包含指定宽度和 Google 优化的高度，用于创建横幅广告。返回的尺寸的宽高比与 BANNER 类似，适合锚定在应用顶部或底部附近。高度永远不会超过设备纵向高度的 15%，也永远不会小于 50 像素。此函数始终会针对任何宽度 / 设备组合返回相同的高度。

返回
`AdSize!`	`AdSize` 对象。如果上下文为 null 或无法从上下文中确定设备高度，则返回 `INVALID`。

getPortraitInlineAdaptiveBannerAdSize

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

返回一个具有指定宽度且高度始终为 0 的 AdSize。此广告尺寸允许 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

width

val width: Int