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

הכיתה MobileAds מספקת הגדרות גלובליות ל-Google Mobile Ads SDK.

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

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

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

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)

  val backgroundScope = CoroutineScope(Dispatchers.IO)
  backgroundScope.launch {
    // Initialize the Google Mobile Ads SDK on a background thread.
    MobileAds.initialize(this@MainActivity) {}
    
    // Set app volume to be half of current device volume.
    MobileAds.setAppVolume(0.5f)
  }
}

Java

@Override
protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);

  new Thread(
          () -> {
            // Initialize the Google Mobile Ads SDK on a background thread.
            MobileAds.initialize(this, initializationStatus -> {});
            
            // Set app volume to be half of current device volume.
            MobileAds.setAppVolume(0.5f);
          })
      .start();
}

כדי להודיע ל-SDK שעוצמת הקול של האפליקציה הושתקה, משתמשים ב-method‏ setAppMuted():

Kotlin

MobileAds.setAppMuted(true)

Java

MobileAds.setAppMuted(true);

כברירת מחדל, עוצמת הקול באפליקציה מוגדרת ל-1 (עוצמת הקול הנוכחית במכשיר) והאפליקציה לא מושתקת.

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

במאמר VideoOptions מוסבר איך לשלוט בהגדרות ההשתקה. אין תמיכה בבקרת עוצמת קול בהתאמה אישית במודעות נתמכות.

אם יש לאפליקציה דרישות מיוחדות, אפשר להגדיר את הפרמטר האופציונלי SharedPreferences gad_has_consent_for_cookies. ה-SDK יפעיל את התכונה מודעות מוגבלות (LTD) כשההעדפה gad_has_consent_for_cookies תוגדר לאפס.

Kotlin

val sharedPrefs = PreferenceManager.getDefaultSharedPreferences(context)
// Set the value to 0 to enable limited ads.
sharedPrefs.edit().putInt("gad_has_consent_for_cookies", 0).apply()

Java

Context activity = getActivity();
SharedPreferences sharedPreferences =
  PreferenceManager.getDefaultSharedPreferences(activity);
// Set the value to 0 to enable limited ads.
sharedPreferences.edit().putInt("gad_has_consent_for_cookies", 0).apply();