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

המחלקה MobileAds מספקת הגדרות גלובליות ל-GMA Next-Gen SDK.

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

אם לאפליקציה יש בקרת עוצמת קול משלה (כמו כפתורים מותאמים אישית לשליטה בעוצמת הקול של המוזיקה או האפקטים), תוכלו לאפשר למודעות לפעול בהתאם להגדרות עוצמת הקול של האפליקציה. כדי לעשות את זה, צריך לחשוף את עוצמת הקול של האפליקציה ל-GMA Next-Gen SDK. כך אפשר לוודא שכשיוצגו למשתמש מודעות וידאו, עוצמת הקול תהיה תואמת לבחירה שלו.

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

Kotlin

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

  val backgroundScope = CoroutineScope(Dispatchers.IO)
  backgroundScope.launch {
    // Initialize GMA Next-Gen SDK on a background thread.
    MobileAds.initialize(
      this@MainActivity,
      // Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713
      InitializationConfig.Builder("SAMPLE_APP_ID").build()
    ) {}
    
    // Set app volume to be half of current device volume.
    MobileAds.setUserControlledAppVolume(0.5f)
  }
}

Java

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

  new Thread(
          () -> {
            // Initialize GMA Next-Gen SDK on a background thread.
            MobileAds.initialize(
                this,
                // Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713
                new InitializationConfig.Builder("SAMPLE_APP_ID")
                    .build(),
                initializationStatus -> {
                });
            
            // Set app volume to be half of current device volume.
            MobileAds.setUserControlledAppVolume(0.5f);
          })
      .start();
}

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

Kotlin

MobileAds.setUserMutedApp(true)

Java

MobileAds.setUserMutedApp(true);

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

אם לאפליקציה יש דרישות מיוחדות, אפשר להגדיר את המאפיין האופציונלי 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();