全般設定

MobileAds クラスは、Google Mobile Ads SDK のグローバル設定を提供します。

動画広告のボリューム調整

アプリに独自のボリューム調整（音楽や音声効果などのカスタム音量設定）機能が備わっている場合、Google Mobile Ads SDK にアプリの設定ボリュームを開示すると、動画広告でアプリ側の設定を使用できるようになります。これにより、動画広告をユーザーの想定どおりの音量で視聴してもらうことが可能になります。

デバイスの音声出力の大きさは、デバイスのボリューム（ボリューム ボタンや OS レベルのボリューム スライダーで制御）で決まりますが、アプリでは音声の聞こえ方を独自にコントロールするために、デバイスの設定に対する相対的なボリューム レベルを独自に調節できます。アプリ起動、バナー、インタースティシャル、リワード、リワード インタースティシャルの各広告フォーマットでは、静的メソッド setAppVolume() を使用して、相対的なアプリのボリュームを SDK にレポートできます。広告の音量設定値の有効範囲は、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 を設定できます。gad_has_consent_for_cookies がゼロに設定されている場合、SDK により 制限付き広告（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()

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