AdSize

Kotlin |Java

public final class AdSize

---

Kích thước của quảng cáo biểu ngữ.

Tóm tắt

Hằng số
static final int	AUTO_HEIGHT = -2 Hằng số sẽ làm cho chiều cao của quảng cáo được điều chỉnh theo tỷ lệ dựa trên chiều cao của thiết bị theo hướng hiện tại.
static final AdSize	BANNER Kích thước quảng cáo biểu ngữ theo Hiệp hội tiếp thị di động (MMA) (320x50 pixel không phụ thuộc vào mật độ).
static final AdSize	FLUID Biểu ngữ có kích thước linh động khớp với chiều rộng của thành phần mẹ và mở rộng/thu hẹp chiều cao để khớp với nội dung của quảng cáo sau khi tải xong.
static final AdSize	FULL_BANNER Kích thước quảng cáo biểu ngữ đầy đủ theo Cục Quảng cáo tương tác (IAB) (468x60 pixel không phụ thuộc vào mật độ).
static final int	FULL_WIDTH = -1 Hằng số sẽ khiến chiều rộng của quảng cáo khớp với chiều rộng của thiết bị theo hướng hiện tại.
static final AdSize	INVALID AdSize không hợp lệ sẽ khiến yêu cầu quảng cáo không thành công ngay lập tức.
static final AdSize	LARGE_BANNER Kích thước quảng cáo biểu ngữ lớn (320x100 pixel không phụ thuộc vào mật độ).
static final AdSize	LEADERBOARD Kích thước quảng cáo hình chữ nhật dài theo Cục Quảng cáo tương tác (IAB) (728x90 pixel không phụ thuộc vào mật độ).
static final AdSize	MEDIUM_RECTANGLE Kích thước quảng cáo dạng hình chữ nhật trung bình theo Cục Quảng cáo tương tác (IAB) (300x250 pixel không phụ thuộc vào mật độ).
static final AdSize	SMART_BANNER Trường này không còn được dùng nữa. Thay vào đó, hãy sử dụng getCurrentOrientationAnchoredAdaptiveBannerAdSize.
static final AdSize	WIDE_SKYSCRAPER Kích thước quảng cáo hình chữ nhật đứng rộng theo IAB (160x600 pixel không phụ thuộc vào mật độ).

Trường công khai
final int	height
final int	width

Hàm khởi tạo công khai
AdSize(int width, int height) Tạo AdSize mới.

Phương thức công khai
boolean	equals(@Nullable Object other) So sánh AdSize này với đối tượng được chỉ định và cho biết liệu chúng có bằng nhau hay không.
static AdSize	getCurrentOrientationAnchoredAdaptiveBannerAdSize(     Context context,     int width ) Trả về một AdSize có chiều rộng nhất định và chiều cao do Google tối ưu hoá để tạo quảng cáo biểu ngữ.
static AdSize	getCurrentOrientationInlineAdaptiveBannerAdSize(     Context context,     int width ) Trả về một AdSize có chiều rộng và chiều cao nhất định luôn bằng 0.
int	getHeight() Trả về chiều cao của AdSize này tính bằng pixel không phụ thuộc vào mật độ.
int	getHeightInPixels(Context context) Trả về chiều cao của AdSize này tính bằng pixel thực.
static AdSize	getInlineAdaptiveBannerAdSize(int width, int maxHeight) Trả về một AdSize có chiều rộng và chiều cao nhất định luôn bằng 0.
static AdSize	getLandscapeAnchoredAdaptiveBannerAdSize(Context context, int width) Trả về một AdSize có chiều rộng nhất định và chiều cao do Google tối ưu hoá để tạo quảng cáo biểu ngữ.
static AdSize	getLandscapeInlineAdaptiveBannerAdSize(Context context, int width) Trả về một AdSize có chiều rộng và chiều cao nhất định luôn bằng 0.
static AdSize	getPortraitAnchoredAdaptiveBannerAdSize(Context context, int width) Trả về một AdSize có chiều rộng nhất định và chiều cao do Google tối ưu hoá để tạo quảng cáo biểu ngữ.
static AdSize	getPortraitInlineAdaptiveBannerAdSize(Context context, int width) Trả về một AdSize có chiều rộng và chiều cao nhất định luôn bằng 0.
int	getWidth() Trả về chiều rộng của AdSize này tính bằng pixel không phụ thuộc vào mật độ.
int	getWidthInPixels(Context context) Trả về chiều rộng của AdSize này tính bằng pixel thực.
int	hashCode()
boolean	isAutoHeight() Trả về liệu AdSize này có tự động điều chỉnh chiều cao hay không.
boolean	isFluid() Trả về kết quả cho biết AdSize này có kích thước linh hoạt hay không.
boolean	isFullWidth() Trả về giá trị cho biết AdSize này có phải là toàn chiều rộng hay không.
String	toString()

Hằng số

AUTO_HEIGHT

public static final int AUTO_HEIGHT = -2

Hằng số sẽ làm cho chiều cao của quảng cáo được điều chỉnh theo tỷ lệ dựa trên chiều cao của thiết bị theo hướng hiện tại. Quảng cáo AUTO_HEIGHT xác định chiều cao trong quá trình khởi tạo AdView và không bao giờ thay đổi sau đó.

BIỂU NGỮ

public static final AdSize BANNER

Kích thước quảng cáo biểu ngữ theo Hiệp hội tiếp thị di động (MMA) (320x50 pixel không phụ thuộc vào mật độ).

FLUID

public static final AdSize FLUID

Biểu ngữ có kích thước linh động khớp với chiều rộng của thành phần mẹ và mở rộng/thu hẹp chiều cao để khớp với nội dung của quảng cáo sau khi tải xong.

FULL_BANNER

public static final AdSize FULL_BANNER

Kích thước quảng cáo biểu ngữ đầy đủ theo Cục Quảng cáo tương tác (IAB) (468x60 pixel không phụ thuộc vào mật độ).

FULL_WIDTH

public static final int FULL_WIDTH = -1

Hằng số sẽ khiến chiều rộng của quảng cáo khớp với chiều rộng của thiết bị theo hướng hiện tại. Quảng cáo FULL_WIDTH xác định chiều rộng trong quá trình khởi tạo và không bao giờ thay đổi sau đó.

KHÔNG HỢP LỆ

public static final AdSize INVALID

AdSize không hợp lệ sẽ khiến yêu cầu quảng cáo không thành công ngay lập tức.

LARGE_BANNER

public static final AdSize LARGE_BANNER

Kích thước quảng cáo biểu ngữ lớn (320x100 pixel không phụ thuộc vào mật độ).

BẢNG XẾP HẠNG

public static final AdSize LEADERBOARD

Kích thước quảng cáo hình chữ nhật dài theo Cục Quảng cáo tương tác (IAB) (728x90 pixel không phụ thuộc vào mật độ).

MEDIUM_RECTANGLE

public static final AdSize MEDIUM_RECTANGLE

Kích thước quảng cáo dạng hình chữ nhật trung bình theo Cục Quảng cáo tương tác (IAB) (300x250 pixel không phụ thuộc vào mật độ).

SMART_BANNER

public static final AdSize SMART_BANNER

Trường này không còn được dùng nữa.

Thay vào đó, hãy sử dụng getCurrentOrientationAnchoredAdaptiveBannerAdSize.

Biểu ngữ có kích thước linh động, toàn chiều rộng và tự động chiều cao.

WIDE_SKYSCRAPER

public static final AdSize WIDE_SKYSCRAPER

Kích thước quảng cáo hình chữ nhật đứng rộng theo IAB (160x600 pixel không phụ thuộc vào mật độ). Kích thước này hiện không được mạng Google Ads trên thiết bị di động hỗ trợ; kích thước này chỉ dành cho các mạng quảng cáo dàn xếp.

Trường công khai

độ cao

public final int height

chiều rộng

public final int width

Hàm khởi tạo công khai

AdSize

public AdSize(int width, int height)

Tạo AdSize mới.

Thông số
int width	Chiều rộng của quảng cáo tính bằng pixel không phụ thuộc vào mật độ.
int height	Chiều cao của quảng cáo tính bằng pixel không phụ thuộc vào mật độ.

Gửi
java.lang.IllegalArgumentException	Nếu chiều rộng hoặc chiều cao là âm.

Phương thức công khai

bằng

public boolean equals(@Nullable Object other)

So sánh AdSize này với đối tượng được chỉ định và cho biết liệu chúng có bằng nhau hay không.

getCurrentOrientationAnchoredAdaptiveBannerAdSize

public static AdSize getCurrentOrientationAnchoredAdaptiveBannerAdSize(
    Context context,
    int width
)

Trả về một AdSize có chiều rộng nhất định và chiều cao do Google tối ưu hoá để tạo quảng cáo biểu ngữ. Kích thước được trả về sẽ có tỷ lệ khung hình tương tự như AdSize, phù hợp để neo gần đầu hoặc cuối ứng dụng. Chiều cao sẽ không bao giờ lớn hơn 15% chiều cao hướng hiện tại của thiết bị và không bao giờ nhỏ hơn 50px. Hàm này luôn trả về cùng một chiều cao cho mọi tổ hợp chiều rộng / thiết bị. Nếu ngữ cảnh là giá trị rỗng hoặc không xác định được chiều cao của thiết bị từ ngữ cảnh, thì INVALID sẽ được trả về.

Giá trị trả về
AdSize	Một đối tượng AdSize. Trả về INVALID nếu ngữ cảnh là giá trị rỗng hoặc không xác định được chiều cao của thiết bị từ ngữ cảnh.

getCurrentOrientationInlineAdaptiveBannerAdSize

public static AdSize getCurrentOrientationInlineAdaptiveBannerAdSize(
    Context context,
    int width
)

Trả về một AdSize có chiều rộng và chiều cao nhất định luôn bằng 0. Kích thước quảng cáo này cho phép máy chủ của Google chọn kích thước quảng cáo tối ưu có chiều cao nhỏ hơn hoặc bằng chiều cao của màn hình theo hướng đã yêu cầu. Bạn có thể truy xuất kích thước chính xác của quảng cáo được trả về bằng cách gọi getAdSize bên trong lệnh gọi lại onAdLoaded. Kích thước quảng cáo này phù hợp nhất với những quảng cáo dự định hiển thị bên trong nội dung có thể cuộn.

getHeight

public int getHeight()

Trả về chiều cao của AdSize này tính bằng pixel không phụ thuộc vào mật độ.

getHeightInPixels

public int getHeightInPixels(Context context)

Trả về chiều cao của AdSize này tính bằng pixel thực. Đối với kích thước linh hoạt, hàm này trả về -1.

getInlineAdaptiveBannerAdSize

public static AdSize getInlineAdaptiveBannerAdSize(int width, int maxHeight)

Trả về một AdSize có chiều rộng và chiều cao nhất định luôn bằng 0. Kích thước quảng cáo này cho phép máy chủ của Google chọn kích thước quảng cáo tối ưu có chiều cao nhỏ hơn hoặc bằng chiều cao tối đa được cung cấp trong thông số maxHeight. Bạn có thể truy xuất kích thước chính xác của quảng cáo được trả về bằng cách gọi getAdSize bên trong lệnh gọi lại onAdLoaded. Kích thước quảng cáo này phù hợp nhất với những quảng cáo dự định hiển thị bên trong nội dung có thể cuộn.

Thông số
int maxHeight	Chiều cao tối đa của quảng cáo đã tải. Phải có chiều cao tối thiểu là 32 dp, nhưng bạn nên sử dụng chiều cao tối đa là 50 dp trở lên.

getLandscapeAnchoredAdaptiveBannerAdSize

public static AdSize getLandscapeAnchoredAdaptiveBannerAdSize(Context context, int width)

Trả về một AdSize có chiều rộng nhất định và chiều cao do Google tối ưu hoá để tạo quảng cáo biểu ngữ. Kích thước được trả về sẽ có tỷ lệ khung hình tương tự như BANNER, phù hợp để neo gần đầu hoặc cuối ứng dụng. Chiều cao sẽ không bao giờ lớn hơn 15% chiều cao của thiết bị ở chế độ ngang và không bao giờ nhỏ hơn 50px. Hàm này luôn trả về cùng một chiều cao cho mọi tổ hợp chiều rộng / thiết bị. Nếu ngữ cảnh là giá trị rỗng hoặc không xác định được chiều cao của thiết bị từ ngữ cảnh, thì INVALID sẽ được trả về.

Giá trị trả về
AdSize	Một đối tượng AdSize. Trả về INVALID nếu ngữ cảnh là giá trị rỗng hoặc không xác định được chiều cao thiết bị từ ngữ cảnh.

getLandscapeInlineAdaptiveBannerAdSize

public static AdSize getLandscapeInlineAdaptiveBannerAdSize(Context context, int width)

Trả về một AdSize có chiều rộng và chiều cao nhất định luôn bằng 0. Kích thước quảng cáo này cho phép máy chủ của Google chọn kích thước quảng cáo tối ưu có chiều cao nhỏ hơn hoặc bằng chiều cao của màn hình theo hướng ngang. Bạn có thể truy xuất kích thước chính xác của quảng cáo được trả về bằng cách gọi getAdSize bên trong lệnh gọi lại onAdLoaded. Kích thước quảng cáo này phù hợp nhất với những quảng cáo dự định hiển thị bên trong nội dung có thể cuộn.

getPortraitAnchoredAdaptiveBannerAdSize

public static AdSize getPortraitAnchoredAdaptiveBannerAdSize(Context context, int width)

Trả về một AdSize có chiều rộng nhất định và chiều cao do Google tối ưu hoá để tạo quảng cáo biểu ngữ. Kích thước được trả về sẽ có tỷ lệ khung hình tương tự như BANNER, phù hợp để neo gần đầu hoặc cuối ứng dụng. Chiều cao sẽ không bao giờ lớn hơn 15% chiều cao dọc của thiết bị và không bao giờ nhỏ hơn 50px. Hàm này luôn trả về cùng một chiều cao cho mọi tổ hợp chiều rộng / thiết bị.

Giá trị trả về
AdSize	Một đối tượng AdSize. Trả về INVALID nếu ngữ cảnh là giá trị rỗng hoặc không xác định được chiều cao thiết bị từ ngữ cảnh.

getPortraitInlineAdaptiveBannerAdSize

public static AdSize getPortraitInlineAdaptiveBannerAdSize(Context context, int width)

Trả về một AdSize có chiều rộng và chiều cao nhất định luôn bằng 0. Kích thước quảng cáo này cho phép máy chủ của Google chọn kích thước quảng cáo tối ưu nhỏ hơn hoặc bằng chiều cao của màn hình theo hướng dọc. Bạn có thể truy xuất kích thước chính xác của quảng cáo được trả về bằng cách gọi getAdSize bên trong lệnh gọi lại onAdLoaded. Kích thước quảng cáo này phù hợp nhất với những quảng cáo dự định hiển thị bên trong nội dung có thể cuộn.

getWidth

public int getWidth()

Trả về chiều rộng của AdSize này tính bằng pixel không phụ thuộc vào mật độ.

getWidthInPixels

public int getWidthInPixels(Context context)

Trả về chiều rộng của AdSize này tính bằng pixel thực. Đối với kích thước linh hoạt, hàm này trả về -1.

hashCode

public int hashCode()

isAutoHeight

public boolean isAutoHeight()

Trả về liệu AdSize này có tự động điều chỉnh chiều cao hay không.

isFluid

public boolean isFluid()

Trả về kết quả cho biết AdSize này có kích thước linh hoạt hay không.

isFullWidth

public boolean isFullWidth()

Trả về liệu AdSize này có toàn chiều rộng hay không.

toString

public String toString()