AdSize

Kotlin |Java

class AdSize

הגודל של מודעת באנר.

סיכום

קבועים
`const Int`	`AUTO_HEIGHT = -2` קבוע שיגרום להתאמת הגובה של המודעה בהתאם לגובה המכשיר בכיוון הנוכחי.
`const AdSize!`	`BANNER` גודל מודעת באנר של Mobile Marketing Association‏ (MMA) (320x50 פיקסלים שאינם תלויים בצפיפות).
`const AdSize!`	`FLUID` מודעת באנר בגודל דינמי שתואם לרוחב של רכיב האב, ומתרחבת או מתכווצת בגובה כדי להתאים לתוכן המודעה אחרי שהטעינה מסתיימת.
`const AdSize!`	`FULL_BANNER` גודל מודעת באנר מלאה של הרשות לפרסום אינטראקטיבי (IAB) (468x60 פיקסלים שאינם תלויים בצפיפות).
`const Int`	`FULL_WIDTH = -1` קבוע שיגרום לרוחב המודעה להיות זהה לרוחב המכשיר באוריינטציה הנוכחית.
`const AdSize!`	`INVALID` גודל מודעה לא תקין שיגרום לכך שהבקשה להצגת מודעה תיכשל באופן מיידי.
`const AdSize!`	`LARGE_BANNER` גודל מודעת באנר גדולה (320x100 פיקסלים שלא תלויים בדחיסות).
`const AdSize!`	`LEADERBOARD` גודל מודעה מסוג Leaderboard של הרשות לפרסום אינטראקטיבי (IAB) ‏ (728x90 פיקסלים שלא תלויים בדחיסות).
`const AdSize!`	`MEDIUM_RECTANGLE` גודל מודעה בפורמט מלבן בינוני של הרשות לפרסום אינטראקטיבי (IAB) (300x250 פיקסלים שאינם תלויים בצפיפות).
`const AdSize!`	`SMART_BANNER` המאפיין הזה יצא משימוש. במקום זאת, אתם צריכים להשתמש ב-`getLargeAnchoredAdaptiveBannerAdSize`.
`const AdSize!`	`WIDE_SKYSCRAPER` גודל מודעה מסוג מלבן עומד רחב של IAB‏ (160x600 פיקסלים שלא תלויים בדחיסות).

‫constructors ציבוריים
`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)` מחזירה `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)` הפונקציה מחזירה `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!

גודל מודעת באנר של Mobile Marketing Association‏ (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!

גודל מודעה לא תקין שיגרום לכך שהבקשה להצגת מודעה תיכשל באופן מיידי.

LARGE_BANNER

const val LARGE_BANNER: AdSize!

גודל מודעת באנר גדולה (320x100 פיקסלים שלא תלויים בדחיסות).

טבלת המובילים

const val LEADERBOARD: AdSize!

גודל מודעה מסוג Leaderboard של הרשות לפרסום אינטראקטיבי (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 Mobile Ads לא תומכת כרגע בגודל הזה. הוא מיועד רק לרשתות מודעות של תהליך בחירת הרשת.

‫constructors ציבוריים

AdSize

AdSize(width: Int, height: Int)

יוצרת AdSize חדש.

פרמטרים
`width: Int`	רוחב המודעה בפיקסלים שלא תלויים בדחיסות.
`height: Int`	גובה המודעה בפיקסלים בלתי תלויים בדחיסות.

מקפיצה את הודעות השגיאה (Throws)
`java.lang.IllegalArgumentException`	אם הרוחב או הגובה שליליים.

פונקציות ציבוריות

שווה ל-

fun equals(other: Any?): Boolean

משווה את AdSize לאובייקט שצוין ומציין אם הם שווים.

getCurrentOrientationAnchoredAdaptiveBannerAdSize

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

מחזירה אובייקט AdSize עם הרוחב שצוין וגובה שעבר אופטימיזציה על ידי Google, כדי ליצור מודעת באנר. הגודל שיוחזר יהיה עם יחס גובה-רוחב דומה ל-AdSize, שמתאים לעיגון ליד החלק העליון או התחתון של האפליקציה. הגובה אף פעם לא יהיה גדול מ-15% מגובה הכיוון הנוכחי של המכשיר, ולא קטן מ-50px. הפונקציה הזו תמיד מחזירה את אותו גובה לכל שילוב של רוחב ומכשיר. אם ההקשר הוא null או שלא ניתן לקבוע את גובה המכשיר מההקשר, מוחזר הערך INVALID.

החזרות
`AdSize!`	אובייקט `AdSize`. הפונקציה מחזירה `INVALID` אם ההקשר הוא null או אם אי אפשר לקבוע את גובה המכשיר מההקשר.

getCurrentOrientationInlineAdaptiveBannerAdSize

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

הפונקציה מחזירה AdSize עם הרוחב שצוין וגובה שתמיד יהיה 0. גודל המודעה הזה מאפשר לשרתי Google לבחור גודל מודעה אופטימלי עם גובה שקטן או שווה לגובה המסך בכיוון המבוקש. אפשר לאחזר את הגודל המדויק של המודעה שהוחזרה על ידי קריאה ל-getAdSize בתוך הקריאה החוזרת onAdLoaded. גודל המודעה הזה מתאים במיוחד למודעות שמוצגות בתוך תוכן שאפשר לגלול בו.

getHeightInPixels

fun getHeightInPixels(context: Context!): Int

מחזירה את הגובה של AdSize בפיקסלים פיזיים. אם הגודל הוא גמיש, הפונקציה מחזירה -1.

getInlineAdaptiveBannerAdSize

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

הפונקציה מחזירה AdSize עם הרוחב שצוין וגובה שתמיד יהיה 0. גודל המודעה הזה מאפשר לשרתי Google לבחור גודל מודעה אופטימלי עם גובה שקטן או שווה לגובה המקסימלי שמופיע בפרמטר maxHeight. אפשר לאחזר את הגודל המדויק של המודעה שהוחזרה על ידי קריאה ל-getAdSize בתוך הקריאה החוזרת onAdLoaded. גודל המודעה הזה מתאים במיוחד למודעות שמוצגות בתוך תוכן שאפשר לגלול בו.

פרמטרים
`maxHeight: Int`	הגובה המקסימלי של מודעה שנטענה. הגובה המקסימלי צריך להיות לפחות 32dp, אבל מומלץ להגדיר אותו ל-50dp ומעלה.

getLandscapeAnchoredAdaptiveBannerAdSize

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

מחזירה אובייקט AdSize עם הרוחב שצוין וגובה שעבר אופטימיזציה על ידי Google, כדי ליצור מודעת באנר. יחס הגובה-רוחב של הגודל שיוחזר יהיה דומה ל-BANNER, והוא מתאים לעיגון ליד החלק העליון או התחתון של האפליקציה. הגובה לא יהיה גדול מ-15% מגובה המכשיר במצב לרוחב, ולא קטן מ-50px. הפונקציה הזו תמיד מחזירה את אותו גובה לכל שילוב של רוחב ומכשיר. אם ההקשר הוא null או שלא ניתן לקבוע את גובה המכשיר מההקשר, מוחזר הערך INVALID.

החזרות
`AdSize!`	אובייקט `AdSize`. הפונקציה מחזירה `INVALID` אם ההקשר הוא null או אם אי אפשר לקבוע את גובה המכשיר מההקשר.

getLandscapeInlineAdaptiveBannerAdSize

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

הפונקציה מחזירה AdSize עם הרוחב שצוין וגובה שתמיד יהיה 0. גודל המודעה הזה מאפשר לשרתי Google לבחור גודל מודעה אופטימלי עם גובה שקטן או שווה לגובה המסך בכיוון לרוחב. אפשר לאחזר את הגודל המדויק של המודעה שהוחזרה על ידי קריאה ל-getAdSize בתוך הקריאה החוזרת onAdLoaded. גודל המודעה הזה מתאים במיוחד למודעות שמוצגות בתוך תוכן שאפשר לגלול בו.

getLargeAnchoredAdaptiveBannerAdSize

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

מחזירה AdSize עם הרוחב שצוין וגובה שעבר אופטימיזציה על ידי Google כדי ליצור מודעת באנר גדולה. הגודל שמוחזר מתאים לעיגון ליד החלק העליון או התחתון של האפליקציה. הגובה אף פעם לא גדול מ-20% מגובה הכיוון הנוכחי של המכשיר, והוא תמיד בין 50 ל-150 פיקסלים עצמאיים מצפיפות. הפונקציה הזו תמיד מחזירה את אותו גובה לכל שילוב של רוחב ומכשיר. אם ההקשר הוא null או שלא ניתן לקבוע את גובה המכשיר מההקשר, מוחזר הערך INVALID.

פרמטרים
`context: Context!`	המאפיין `Context` משמש לקביעת מידע ספציפי למכשיר, כמו מידות המסך.
`width: Int`	הרוחב הרצוי של יחידת המודעות בפיקסלים בלתי תלויים בדחיסות.

החזרות
`AdSize!`	אובייקט `AdSize`. הפונקציה מחזירה `INVALID` אם ההקשר הוא null או אם אי אפשר לקבוע את גובה המכשיר מההקשר.

getLargeLandscapeAnchoredAdaptiveBannerAdSize

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

מחזירה AdSize עם הרוחב שצוין וגובה שעבר אופטימיזציה על ידי Google כדי ליצור מודעת באנר גדולה. הגודל שמוחזר מתאים לשימוש במודעת באנר שמעוגנת ליד החלק העליון או התחתון של האפליקציה. הגובה אף פעם לא גדול מ-20% מגובה המכשיר במצב לרוחב, ותמיד נע בין 50 ל-150 פיקסלים שאינם תלויים בצפיפות. הפונקציה הזו תמיד מחזירה את אותו גובה לכל שילוב של רוחב ומכשיר. אם ההקשר הוא null או שלא ניתן לקבוע את גובה המכשיר מההקשר, מוחזר הערך INVALID.

פרמטרים
`context: Context!`	המאפיין `Context` משמש לקביעת מידע ספציפי למכשיר, כמו מידות המסך.
`width: Int`	הרוחב הרצוי של יחידת המודעות בפיקסלים בלתי תלויים בדחיסות.

החזרות
`AdSize!`	אובייקט `AdSize`. הפונקציה מחזירה `INVALID` אם ההקשר הוא null או אם אי אפשר לקבוע את גובה המכשיר מההקשר.

getLargePortraitAnchoredAdaptiveBannerAdSize

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

מחזירה AdSize עם הרוחב שצוין וגובה שעבר אופטימיזציה על ידי Google כדי ליצור מודעת באנר גדולה. הגודל שמוחזר מתאים לשימוש במודעת באנר שמעוגנת ליד החלק העליון או התחתון של האפליקציה. הגובה אף פעם לא גדול מ-20% מגובה המכשיר במצב לאורך, והוא תמיד בין 50 ל-150 פיקסלים שאינם תלויים בצפיפות. הפונקציה הזו תמיד מחזירה את אותו גובה לכל שילוב של רוחב ומכשיר.

פרמטרים
`context: Context!`	המאפיין `Context` משמש לקביעת מידע ספציפי למכשיר, כמו מידות המסך.
`width: Int`	הרוחב הרצוי של יחידת המודעות בפיקסלים בלתי תלויים בדחיסות.

החזרות
`AdSize!`	אובייקט `AdSize`. הפונקציה מחזירה `INVALID` אם ההקשר הוא null או אם אי אפשר לקבוע את גובה המכשיר מההקשר.

getPortraitAnchoredAdaptiveBannerAdSize

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

מחזירה אובייקט AdSize עם הרוחב שצוין וגובה שעבר אופטימיזציה על ידי Google, כדי ליצור מודעת באנר. הגודל שיוחזר יהיה ביחס גובה-רוחב דומה ל-BANNER, שמתאים לעיגון ליד החלק העליון או התחתון של האפליקציה. הגובה לא יהיה גדול מ-15% מגובה המכשיר במצב אנכי, ולא קטן מ-50px. הפונקציה הזו תמיד מחזירה את אותו גובה לכל שילוב של רוחב ומכשיר.

החזרות
`AdSize!`	אובייקט `AdSize`. הפונקציה מחזירה `INVALID` אם ההקשר הוא null או אם אי אפשר לקבוע את גובה המכשיר מההקשר.

getPortraitInlineAdaptiveBannerAdSize

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

הפונקציה מחזירה AdSize עם הרוחב שצוין וגובה שתמיד יהיה 0. גודל המודעה הזה מאפשר לשרתי Google לבחור גודל אופטימלי של מודעה שלא גדול מגובה המסך בכיוון לאורך. אפשר לאחזר את הגודל המדויק של המודעה שהוחזרה על ידי קריאה ל-getAdSize בתוך הקריאה החוזרת onAdLoaded. גודל המודעה הזה מתאים במיוחד למודעות שמוצגות בתוך תוכן שאפשר לגלול בו.

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