کلاس MobileAds تنظیمات سراسری برای Google Mobile Ads SDK (Legacy) ارائه میدهد.
کنترل میزان صدای آگهی ویدیویی
اگر برنامهتان کنترلهای میزان صدای خودش را دارد (مانند میزان صدای موسیقی یا جلوه صوتی سفارشی)، شفافسازی میزان صدای برنامه برای Google Mobile Ads SDK (Legacy) به آگهیهای ویدیویی امکان میدهد تنظیمات میزان صدای برنامه را رعایت کنند. این کار تضمین میکند که کاربران آگهیهای ویدیویی را با میزان صدای موردانتظار دریافت کنند.
میزان صدای دستگاه که ازطریق دکمههای صدا یا لغزنده میزان صدا در سطح سیستمعامل کنترل میشود،
میزان صدای خروجی صوتی دستگاه را تعیین میکند. بااینحال، برنامهها میتوانند بهطور مستقل
سطوح صدا را نسبت به صدای دستگاه تنظیم کنند تا تجربه صوتی را
سفارشیسازی کنند. برای قالبهای آگهی بینابینی پاداشی، پاداشی، بینابینی، برنما، و باز کردن برنامه، میتوانید میزان صدای نسبی برنامه را ازطریق روش ثابت setAppVolume() به کیت توسعه نرمافزار گزارش کنید. محدوده مقادیر معتبر برای میزان صدای آگهی از
0.0 (بیصدا) تا 1.0 (میزان صدای فعلی دستگاه) است. در اینجا مثالی از نحوه گزارش کردن میزان صدای نسبی برنامه به SDK آورده شده است:
Kotlin
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
val backgroundScope = CoroutineScope(Dispatchers.IO)
backgroundScope.launch {
// Initialize Google Mobile Ads SDK (Legacy) on a background thread.
MobileAds.initialize(this@MainActivity) {}
// Set app volume to be half of current device volume.
MobileAds.setAppVolume(0.5f)
}
}
جاوا
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
new Thread(
() -> {
// Initialize Google Mobile Ads SDK (Legacy) on a background thread.
MobileAds.initialize(this, initializationStatus -> {});
// Set app volume to be half of current device volume.
MobileAds.setAppVolume(0.5f);
})
.start();
}
برای اطلاع دادن به کیت توسعه نرمافزار (SDK) درباره بیصدا شدن صدای برنامه، از روش
setAppMuted() استفاده کنید:
Kotlin
MobileAds.setAppMuted(true)
جاوا
MobileAds.setAppMuted(true);
بهطور پیشفرض، میزان صدای برنامه روی 1 (میزان صدای فعلی دستگاه) تنظیم شده است و
برنامه بیصدا نیست.
آگهیهای بومی
برای دستورالعملهای مربوط به نحوه کنترل تنظیمات بیصدا کردن،
VideoOptions
را ببینید. کنترل میزان صدای سفارشی برای آگهیهای بومی پشتیبانی نمیشود.
موافقت با کوکیها
اگر برنامهتان الزامات خاصی دارد، میتوانید
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();