การตั้งค่าส่วนกลาง

คลาส MobileAds มีการตั้งค่าส่วนกลางสำหรับ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google

การควบคุมระดับเสียงของโฆษณาวิดีโอ

หากแอปมีการควบคุมระดับเสียงในตัว (เช่น ระดับเสียงเพลงหรือเอฟเฟกต์เสียงที่กําหนดเอง) การเปิดเผยระดับเสียงของแอปต่อ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google จะช่วยให้โฆษณาวิดีโอเล่นตามการตั้งค่าระดับเสียงของแอปได้ ซึ่งช่วยให้แน่ใจว่าผู้ใช้จะได้รับโฆษณาวิดีโอในระดับเสียงที่คาดไว้

ระดับเสียงของอุปกรณ์ซึ่งควบคุมผ่านปุ่มปรับระดับเสียงหรือแถบเลื่อนปรับระดับเสียงในระดับระบบปฏิบัติการจะเป็นตัวกำหนดระดับเสียงสำหรับเอาต์พุตเสียงของอุปกรณ์ อย่างไรก็ตาม แอปสามารถปรับระดับเสียงตามระดับเสียงของอุปกรณ์เพื่อปรับแต่งประสบการณ์เสียงได้ สำหรับรูปแบบโฆษณาเปิดแอป แบนเนอร์ โฆษณาคั่นระหว่างหน้า โฆษณาที่มีการให้รางวัล และโฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล คุณสามารถรายงานปริมาณแอปแบบสัมพัทธ์ให้ SDK ทราบผ่านเมธอด setAppVolume() แบบคงที่ได้ ช่วงค่าปริมาณโฆษณาที่ถูกต้องมีตั้งแต่ 0.0 (ปิดเสียง) ไปจนถึง 1.0 (ระดับเสียงปัจจุบันของอุปกรณ์) ตัวอย่างวิธีรายงานปริมาณแอปที่เกี่ยวข้องให้ SDK ทราบมีดังนี้

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)

  val backgroundScope = CoroutineScope(Dispatchers.IO)
  backgroundScope.launch {
    // Initialize the Google Mobile Ads SDK on a background thread.
    MobileAds.initialize(this@MainActivity) {}
    
    // Set app volume to be half of current device volume.
    MobileAds.setAppVolume(0.5f)
  }
}

Java

@Override
protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);

  new Thread(
          () -> {
            // Initialize the Google Mobile Ads SDK 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)

Java

MobileAds.setAppMuted(true);

โดยค่าเริ่มต้น ระบบจะตั้งระดับเสียงของแอปไว้ที่ 1 (ระดับเสียงปัจจุบันของอุปกรณ์) และแอปไม่ได้ปิดเสียงอยู่

โฆษณาเนทีฟ

ดูวิธีควบคุมการตั้งค่าการปิดเสียงใน VideoOptions โฆษณาเนทีฟไม่รองรับการควบคุมระดับเสียงที่กำหนดเอง

หากแอปมีข้อกำหนดพิเศษ คุณสามารถตั้งค่าตัวเลือก SharedPreferences gad_has_consent_for_cookies 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();