MobileAds
クラスは、Google Mobile Ads SDK のグローバル設定を提供します。
動画広告の音量調整
アプリに独自の音量調節(音楽や効果音のカスタム音量設定など)が備わっている場合、アプリの音量設定を Google Mobile Ads SDK に開示することで、動画広告でアプリ側の音量設定を尊重できるようになります。これにより、動画広告をユーザーの想定どおりの音量で視聴してもらうことができます。
デバイスの音声出力の音量は、デバイスの音量(ボリューム ボタンや OS レベルのボリューム スライダーで制御)で決まります。ただし、音声の聞こえ方を独自にコントロールするために、アプリはデバイスの音量に対する相対的な音量レベルを独自に調整できます。アプリ起動時、バナー広告、インタースティシャル広告、リワード広告、リワード インタースティシャル広告の広告フォーマットでは、静的 setAppVolume()
メソッドを使用してアプリの相対的なボリュームを SDK に報告できます。広告の音量の有効な値は、0.0
(無音)から 1.0
(デバイスの現在の音量)までです。アプリ側の相対音量を SDK に報告する方法の例を次に示します。
Java
@Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_my); MobileAds.initialize(this); // Set app volume to be half of current device volume. MobileAds.setAppVolume(0.5f); ... }
Kotlin
override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) MobileAds.initialize(this) // Set app volume to be half of current device volume. MobileAds.setAppVolume(0.5f) ... }
アプリ音量がミュートされたことを SDK に通知するには、setAppMuted()
メソッドを使用します。
Java
MobileAds.setAppMuted(true);
Kotlin
MobileAds.setAppMuted(true)
デフォルトでは、アプリの音量は 1
(デバイスの現在の音量)に設定され、アプリはミュートされていません。
ネイティブ広告
ミュート設定を制御する手順については、VideoOptions
をご覧ください。現在のところ、カスタムの音量調整はネイティブ広告ではサポートされていません。
Cookie に関する同意
アプリに特別な要件がある場合は、オプションの SharedPreferences
gad_has_consent_for_cookies
を設定できます。gad_has_consent_for_cookies
設定がゼロに設定されている場合、SDK により
制限付き広告(LTD)
が有効になります。
Java
Context activity = getActivity(); SharedPreferences sharedPreferences = PreferenceManager.getDefaultSharedPreferences(activity); sharedPreferences.edit().putInt("gad_has_consent_for_cookies", 0).apply();
Kotlin
val sharedPrefs = PreferenceManager.getDefaultSharedPreferences(context) sharedPrefs.edit().putInt("gad_has_consent_for_cookies", 0).apply()