إعدادات عامة

توفّر فئة 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)
  }
}

جافا

@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 بأنّه تم كتم صوت التطبيق، استخدِم الطريقة 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();