إعدادات عمومية

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

يوفّر الصف MobileAds إعدادات عامة للجيل التالي من حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة.

التحكّم في مستوى صوت إعلان الفيديو

إذا كان تطبيقك يتضمّن عناصر تحكّم خاصة به في مستوى الصوت (مثل مستويات مخصّصة للموسيقى أو المؤثرات الصوتية)، فإنّ الإفصاح عن مستوى الصوت في التطبيق لحزمة "الجيل التالي من SDK لإعلانات Google على الأجهزة الجوّالة" يسمح لإعلانات الفيديو بمراعاة إعدادات مستوى الصوت في التطبيق. يضمن ذلك عرض إعلانات الفيديو للمستخدمين بمستوى الصوت المتوقّع.

يحدّد مستوى صوت الجهاز، الذي يتم التحكّم فيه من خلال أزرار مستوى الصوت أو شريط تمرير مستوى الصوت على مستوى نظام التشغيل، مستوى صوت إخراج الصوت من الجهاز. ومع ذلك، يمكن للتطبيقات ضبط مستويات الصوت بشكل مستقل بما يتناسب مع مستوى صوت الجهاز لتخصيص تجربة الصوت. بالنسبة إلى أشكال الإعلانات على شاشة فتح التطبيق وإعلانات البانر والإعلانات البينية والإعلانات التي تضم مكافأة والإعلانات البينية التي تضم مكافأة، يمكنك إرسال مستوى صوت التطبيق النسبي إلى حزمة تطوير البرامج (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)
  }
}

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

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