คลาส 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)
}
}
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 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)
Java
MobileAds.setUserMutedApp(true);
ระดับเสียงของแอปจะตั้งเป็น 1 (ระดับเสียงปัจจุบันของอุปกรณ์) โดยค่าเริ่มต้น และแอปจะไม่ปิดเสียง
ความยินยอมในการใช้คุกกี้
หากแอปมีข้อกำหนดพิเศษ คุณสามารถตั้งค่า gad_has_consent_for_cookies ซึ่งเป็นตัวเลือกเสริมได้
SharedPreferences SDK จะเปิดใช้โฆษณาแบบจำกัด (LTD) เมื่อตั้งค่ากำหนด gad_has_consent_for_cookies เป็น 0
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();