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