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 )` 返回一个具有指定宽度且高度始终为 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)` 返回一个 `AdSize`，其中包含指定宽度和 Google 优化的高度，用于创建大型横幅广告。
`static AdSize`	`getLargeLandscapeAnchoredAdaptiveBannerAdSize( Context context, int width )` 返回一个 `AdSize`，其中包含指定宽度和 Google 优化的高度，用于创建大型横幅广告。
`static AdSize`	`getLargePortraitAnchoredAdaptiveBannerAdSize( Context context, int width )` 返回一个 `AdSize`，其中包含指定宽度和 Google 优化的高度，用于创建大型横幅广告。
`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

移动营销协会 (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

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

WIDE_SKYSCRAPER

public static final AdSize WIDE_SKYSCRAPER

IAB 宽幅摩天大楼广告尺寸（160x600 密度无关像素）。Google 移动广告网络目前不支持此尺寸，此尺寸仅适用于中介广告网络。

公开字段

高度

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
)

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

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

getLandscapeAnchoredAdaptiveBannerAdSize

public static AdSize getLandscapeAnchoredAdaptiveBannerAdSize(Context context, int width)

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

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

getLandscapeInlineAdaptiveBannerAdSize

public static AdSize getLandscapeInlineAdaptiveBannerAdSize(Context context, int width)

返回一个 AdSize，其宽度为指定宽度，高度始终为 0。此广告尺寸允许 Google 服务器选择高度小于或等于横屏方向的屏幕高度的最佳广告尺寸。您可以在 onAdLoaded 回调中调用 getAdSize 来检索返回的广告的确切尺寸。此广告尺寸最适合在可滚动的内容中展示的广告。

getLargeAnchoredAdaptiveBannerAdSize

public static AdSize getLargeAnchoredAdaptiveBannerAdSize(Context context, int width)

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

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

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

getLargeLandscapeAnchoredAdaptiveBannerAdSize

public static AdSize getLargeLandscapeAnchoredAdaptiveBannerAdSize(
    Context context,
    int width
)

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

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

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

getLargePortraitAnchoredAdaptiveBannerAdSize

public static AdSize getLargePortraitAnchoredAdaptiveBannerAdSize(
    Context context,
    int width
)

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

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

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

getPortraitAnchoredAdaptiveBannerAdSize

public static AdSize getPortraitAnchoredAdaptiveBannerAdSize(Context context, int width)

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

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