如需讨论我们的产品并提供反馈，请加入 Google 广告和效果衡量社区服务器中的官方 Ad Manager Discord 频道。

此页面由 Cloud Translation API 翻译。

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` 此字段已弃用。请改用 `getCurrentOrientationAnchoredAdaptiveBannerAdSize`。
`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 )` 返回具有指定宽度和 Google 优化高度的 `AdSize`，以创建横幅广告。
`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)` 返回具有指定宽度和 Google 优化高度的 `AdSize`，以创建横幅广告。
`static AdSize`	`getLandscapeInlineAdaptiveBannerAdSize(Context context, int width)` 返回具有给定宽度且高度始终为 0 的 `AdSize`。
`static AdSize`	`getPortraitAnchoredAdaptiveBannerAdSize(Context context, int width)` 返回具有指定宽度和 Google 优化高度的 `AdSize`，以创建横幅广告。
`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 广告在初始化期间确定其宽度，之后便不会再发生变化。

无效

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
)

返回具有指定宽度和 Google 优化高度的 AdSize，以创建横幅广告。返回的大小的宽高比与 AdSize 类似，适合锚定在应用顶部或底部附近。高度绝不会超过设备当前屏幕方向高度的 15%，也不会低于 50px。对于任何宽度 / 设备组合，此函数始终返回相同的高度。如果上下文为 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 的实际像素高度。对于自适应尺寸，它会返回 -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)

返回具有指定宽度和 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 来检索返回的广告的确切大小。此广告尺寸最适合在可滚动内容中展示的广告。

getPortraitAnchoredAdaptiveBannerAdSize

public static AdSize getPortraitAnchoredAdaptiveBannerAdSize(Context context, int width)

返回具有指定宽度和 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 的实际像素宽度。对于自适应尺寸，它会返回 -1。

hashCode

public int hashCode()

isAutoHeight

public boolean isAutoHeight()

返回此 AdSize 是否为自动高度。

isFluid

public boolean isFluid()

返回此 AdSize 是否为流体大小。

isFullWidth

public boolean isFullWidth()

返回此 AdSize 是否为全角。

toString

public String toString()