הגדרות גלובליות

בכיתה GADMobileAds יש הגדרות גלובליות לצורך בקרה על מידע מסוים שנאסף על ידי Mobile Ads SDK.

שליטה בעוצמת הקול של מודעות וידאו

אם לאפליקציה יש פקדי עוצמת קול משלה, כמו לחצנים מותאמים אישית לשליטה בעוצמת הקול של המוזיקה או האפקטים, חשיפת עוצמת הקול של האפליקציה ל-Google Mobile Ads SDK תאפשר למודעות וידאו לפעול בהתאם להגדרות עוצמת הקול של האפליקציה. כך המערכת מבטיחה שכשיוצגו למשתמשים מודעות וידאו, עוצמת הקול תהיה תואמת לבחירה שלהם.

עוצמת הקול במכשיר, שאותה שולטים בה באמצעות לחצני עוצמת הקול או פס ההזזה של עוצמת הקול ברמת מערכת ההפעלה, קובעת את עוצמת הקול של פלט האודיו במכשיר. עם זאת, אפליקציות יכולות לשנות באופן עצמאי את רמות עוצמת הקול ביחס לעוצמת הקול במכשיר כדי להתאים אישית את חוויית האודיו.

בפורמטים של מודעות בפתיחת אפליקציה, מודעות באנר, מודעות מעברון, מודעות מתגמלות ומודעות מעברון מתגמלות, אפשר לדווח על נפח האפליקציה היחסי ל-Google Mobile Ads SDK על ידי הגדרת המאפיין applicationVolume. הערכים התקינים של עוצמת הקול של מודעות נעים בין 0.0 (שקט) ל-1.0 (עוצמת הקול הנוכחית במכשיר). דוגמה לדיווח על נפח האפליקציה היחסי ל-SDK:

Swift

func viewDidLoad() {
  super.viewDidLoad()
  // Set app volume to be half of the current device volume.
  GADMobileAds.sharedInstance().applicationVolume = 0.5
  ...
}

Objective-C

- (void)viewDidLoad {
  [super viewDidLoad];
  // Set app volume to be half of the current device volume.
  GADMobileAds.sharedInstance.applicationVolume = 0.5;
  ...
}

בפורמטים של מודעות 'פתיחת אפליקציה', 'באנר', 'מעברון', 'מודעה מתגמלת' ו'מודעה מתגמלת במעברון', אפשר להגדיר את המאפיין applicationMuted כדי להודיע ל-Google Mobile Ads SDK שעוצמת הקול באפליקציה הושתקה:

Swift

GADMobileAds.sharedInstance().applicationMuted = true

Objective-C

GADMobileAds.sharedInstance.applicationMuted = YES;

כברירת מחדל, הערך של applicationVolume מוגדר כ-1 (עוצמת הקול הנוכחית במכשיר) ו-applicationMuted מוגדר כ-NO.

מודעות מותאמות

להוראות לניהול ההגדרות של ההשתקה, ראו GADVideoOptions. במודעות מותאמות אין תמיכה בבקרת עוצמת קול בהתאמה אישית.

סשנים של אודיו

סשנים של אודיו מאפשרים לכם להביע למערכת את הכוונות שלכם לגבי התנהגות האודיו של האפליקציה. מידע נוסף על סשנים של אודיו זמין במדריך לתכנות של סשנים של אודיו של Apple. האפשרויות הזמינות לניהול האודיו של Google Mobile Ads SDK הן דרך המאפיין audioVideoManager.

אם אתם לא משתמשים באודיו באפליקציה, אתם לא צריכים להשתמש בממשקי ה-API האלה. מערכת Google Mobile Ads SDK מנהלת באופן אוטומטי את הקטגוריה של סשן האודיו כשהיא מפעילה אודיו. אם אתם מפעילים אודיו באפליקציה ואתם רוצים לשלוט בצורה הדוקה יותר באופן שבו Google Mobile Ads SDK מפעיל אודיו ומתי הוא מפעיל אותו, תוכלו להשתמש בממשקי ה-API האלה.

במערכת לניהול הווידאו והאודיו, אפשר להגדיר את המאפיין audioSessionIsApplicationManaged לערך YES אם רוצים לנהל בעצמכם את הקטגוריה של סשן האודיו.

אם רוצים לנהל את הקטגוריה של סשן האודיו, אפשר להטמיע את GADAudioVideoManagerDelegate ולהגדיר את המאפיין delegate במנהל הווידאו והאודיו כדי לקבל התראות על אירועי הפעלה של מודעות וידאו ואודיו. לאחר מכן, צריך לשנות את הקטגוריה של סשן האודיו לקטגוריה הרלוונטית בהתאם למדריך של Apple לתכנות סשנים של אודיו.

לפניכם דוגמה פשוטה לקוד שמראה את הגישה המומלצת אם האפליקציה שלכם מנגנת מוזיקה, באמצעות ממשקי ה-API שלמעלה:

Swift

func setUp() {
  GADMobileAds.sharedInstance().audioVideoManager.delegate = self
  GADMobileAds.sharedInstance().audioVideoManager.audioSessionIsApplicationManaged = false
}

// MARK: - GADAudioVideoManagerDelegate
func audioVideoManagerWillPlayAudio(_ audioVideoManager: GADAudioVideoManager) {
  // The Mobile Ads SDK is notifying your app that it will play audio. You
  // could optionally pause music depending on your apps design.
  MyAppObject.sharedInstance().pauseAllMusic()
}

func audioVideoManagerDidStopPlayingAudio(_ audioVideoManager: GADAudioVideoManager) {
  // The Mobile Ads SDK is notifying your app that it has stopped playing
  // audio. Depending on your design, you could resume music here.
  MyAppObject.sharedInstance().resumeAllMusic()
}

Objective-C

- (void)setUp {
  GADMobileAds.sharedInstance.audioVideoManager.delegate = self;
  GADMobileAds.sharedInstance.audioVideoManager.audioSessionIsApplicationManaged = NO;
}

#pragma mark - GADAudioVideoManagerDelegate

- (void)audioVideoManagerWillPlayAudio:(GADAudioVideoManager *)audioVideoManager {
  // The Mobile Ads SDK is notifying your app that it will play audio. You
  // could optionally pause music depending on your apps design.
  [MyAppObject.sharedInstance pauseAllMusic];
}

- (void)audioVideoManagerDidStopPlayingAudio:(GADAudioVideoManager *)audioVideoManager {
    // The Mobile Ads SDK is notifying your app that it has stopped playing
    // audio. Depending on your design, you could resume music here.
  [MyAppObject.sharedInstance resumeAllMusic];
}

דיווח על קריסה

‏Google Mobile Ads SDK בודק חריגות שמתרחשות באפליקציה ל-iOS ומתעדות אותן אם הן נגרמו על ידי ה-SDK. לאחר מכן, החריגים האלה מטופלים בגרסאות עתידיות של SDK.

דיווח על קריסות מופעל כברירת מחדל. אם אתם לא רוצים שהמערכת תתעד חריגות שקשורות ל-SDK, תוכלו להשבית את התכונה הזו באמצעות קריאה ל-method‏ disableSDKCrashReporting. הזמן הטוב ביותר להפעיל את השיטה הזו הוא כשהאפליקציה מופעלת:

Swift

import GoogleMobileAds

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

  func application(_ application: UIApplication,
      didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {

    GADMobileAds.disableSDKCrashReporting()
    return true
  }
}

Objective-C

@import GoogleMobileAds;

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

  [GADMobileAds disableSDKCrashReporting];
  return YES;
}

@end

אם יש לאפליקציה דרישות מיוחדות, אפשר להגדיר את הפרמטר האופציונלי NSUserDefaults gad_has_consent_for_cookies. ‏Google Mobile Ads SDK מאפשר להציג מודעות מוגבלות (LTD) אם ההעדפה gad_has_consent_for_cookies מוגדרת לאפס.

Swift

UserDefaults.standard.set(0, forKey: "gad_has_consent_for_cookies")

Objective-C

NSUserDefaults.standardUserDefaults().setObject(Int(0),
    forKey: "gad_has_consent_for_cookies");