تنظیمات کلی

انتخاب پلاتفرم: Android iOS Unity Android (قدیمی)

کلاس MobileAds تنظیمات سراسری برای GMA Next-Gen SDK ارائه می‌دهد.

کنترل میزان صدای آگهی ویدیویی

اگر برنامه شما کنترل‌های میزان صدای خود را دارد (مانند میزان صدای موسیقی سفارشی یا جلوه صوتی)، آشکار کردن میزان صدای برنامه به GMA Next-Gen SDK به آگهی‌های ویدیویی امکان می‌دهد تنظیمات میزان صدای برنامه را رعایت کنند. این کار تضمین می‌کند که کاربران آگهی‌های ویدیویی را با حجم صدای موردانتظار دریافت کنند.

میزان صدای دستگاه که ازطریق دکمه‌های صدا یا لغزنده صدای سطح سیستم‌عامل کنترل می‌شود، میزان صدای خروجی صوتی دستگاه را تعیین می‌کند. بااین‌حال، برنامه‌ها می‌توانند به‌طور مستقل سطوح صدا را نسبت به صدای دستگاه تنظیم کنند تا تجربه صوتی را سفارشی کنند. برای قالب‌های آگهی باز کردن برنامه، برنمایی، بینابینی، پاداش‌دار، و بینابینی پاداش‌دار، می‌توانید حجم نسبی برنامه را ازطریق روش ایستا setUserControlledAppVolume() به «کیت توسعه نرم‌افزار» گزارش کنید. مقادیر معتبر حجم آگهی از 0.0 (بی‌صدا) تا 1.0 (حجم فعلی دستگاه) متغیر است. در اینجا مثالی از نحوه گزارش حجم نسبی برنامه به کیت توسعه نرم‌افزار آورده شده است:

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

برای اطلاع دادن به کیت توسعه نرم‌افزار که صدای برنامه بی‌صدا شده است، از روش setUserMutedApp() استفاده کنید:

Kotlin

MobileAds.setUserMutedApp(true)

جاوا

MobileAds.setUserMutedApp(true);

به‌طور پیش‌فرض، صدای برنامه روی 1 (صدای فعلی دستگاه) تنظیم می‌شود و برنامه بی‌صدا نمی‌شود.

اگر برنامه شما الزامات ویژه‌ای دارد، می‌توانید SharedPreferences gad_has_consent_for_cookies اختیاری را تنظیم کنید. وقتی اولویت gad_has_consent_for_cookies روی صفر تنظیم شود، کیت توسعه نرم‌افزار آگهی‌های محدود (LTD) را فعال می‌کند.

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