إعدادات عامة

اختيار النظام الأساسي: Android (إصدار تجريبي) New-selected Android iOS Unity

يوفّر الصف 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 AdMob 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)
  }
}

جافا

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

  new Thread(
          () -> {
            // Initialize GMA Next-Gen SDK on a background thread.
            MobileAds.initialize(
                this,
                // Sample AdMob 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) بأنّه تم كتم صوت التطبيق، استخدِم الطريقة setUserMutedApp():

Kotlin

MobileAds.setUserMutedApp(true)

جافا

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()

جافا

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();