GADMobileAds
クラスは、特定のリソースを制御するための全般設定を提供します。
Mobile Ads SDK によって収集された情報です。
動画広告の音量調節
カスタムの音楽や効果音など、独自の音量調節機能がアプリにある場合 Google Mobile Ads SDK にアプリのボリュームを開示することで、動画広告を アプリの音量設定が優先されますこれにより 期待する音量。
デバイスの音量(音量ボタンや OS レベルの音量スライダーで制御) デバイスの音声出力の音量を決定します。ただし、アプリは個別に デバイスの音量に合わせて音量レベルを調整し、音声を調整します 体験できます
アプリ起動時広告、バナー広告、インタースティシャル広告広告、リワード インタースティシャル広告、リワード インタースティシャル広告の場合
アプリの相対的なボリュームを Google Mobile Ads SDK に報告するには、
applicationVolume
プロパティの設定。有効な広告ボリューム値の範囲は、
0.0
(マナーモード)~1.0
(デバイスの現在の音量)この例は、
アプリの相対ボリュームを SDK に報告します。
Swift
func viewDidLoad() {
super.viewDidLoad()
// Set app volume to be half of the current device volume.
GADMobileAds.sharedInstance().applicationVolume = 0.5
...
}
Objective-C
- (void)viewDidLoad {
[super viewDidLoad];
// Set app volume to be half of the current device volume.
GADMobileAds.sharedInstance.applicationVolume = 0.5;
...
}
アプリ起動時広告、バナー広告、インタースティシャル広告広告、リワード インタースティシャル広告、リワード インタースティシャル広告の場合
Google Mobile Ads SDK に通知して、アプリのボリュームを
次のように applicationMuted
プロパティを設定してミュートします。
Swift
GADMobileAds.sharedInstance().applicationMuted = true
Objective-C
GADMobileAds.sharedInstance.applicationMuted = YES;
デフォルトでは、applicationVolume
は 1
(現在のデバイスの音量)に設定されています。
applicationMuted
が NO
に設定されている。
ネイティブ広告
詳しくは、
GADVideoOptions
ミュート設定の操作方法をご覧ください。ネイティブ広告の場合、
サポートしています。
オーディオ セッション
オーディオ セッションを使用すると、アプリに対するユーザーの意図をシステムに表現できます。
制御できます。オーディオ セッションに関するその他の情報については、以下をご覧ください。
Apple の Audio Session Programming
ガイドをご覧ください。
Google Mobile Ads SDK のオーディオを管理するために利用できるオプションは、
audioVideoManager
プロパティです。
アプリで音声を使用しない場合は、これらの API を使用する必要はありません。Google オーディオ セッション カテゴリは、Mobile Ads SDK によって自動的に管理されます。 音声が再生されます。アプリでオーディオを再生する場合に、 これらの API を活用すると、Google Mobile Ads SDK で音声を再生する方法とタイミングを設定できます。
[音声動画の管理]では
audioSessionIsApplicationManaged
音声の管理を責任を持って行う場合は、プロパティを YES
に設定します。
選択します。
オーディオ セッション カテゴリを管理するには、以下を実装します。
GADAudioVideoManagerDelegate
delegate
を設定します。
プロパティを使用して、広告の動画とオーディオに関する通知を受け取ります。
作成できます。次に、オーディオ セッションのカテゴリを
Apple の Audio Session Programming(音声セッション プログラミング)に基づき、
ガイドをご覧ください。
このシンプルなコードサンプルは、次のような場合に推奨されるアプローチを示しています。 上記の API を使用して音楽を再生します。
Swift
func setUp() {
GADMobileAds.sharedInstance().audioVideoManager.delegate = self
GADMobileAds.sharedInstance().audioVideoManager.audioSessionIsApplicationManaged = false
}
// MARK: - GADAudioVideoManagerDelegate
func audioVideoManagerWillPlayAudio(_ audioVideoManager: GADAudioVideoManager) {
// The Mobile Ads SDK is notifying your app that it will play audio. You
// could optionally pause music depending on your apps design.
MyAppObject.sharedInstance().pauseAllMusic()
}
func audioVideoManagerDidStopPlayingAudio(_ audioVideoManager: GADAudioVideoManager) {
// The Mobile Ads SDK is notifying your app that it has stopped playing
// audio. Depending on your design, you could resume music here.
MyAppObject.sharedInstance().resumeAllMusic()
}
Objective-C
- (void)setUp {
GADMobileAds.sharedInstance.audioVideoManager.delegate = self;
GADMobileAds.sharedInstance.audioVideoManager.audioSessionIsApplicationManaged = NO;
}
#pragma mark - GADAudioVideoManagerDelegate
- (void)audioVideoManagerWillPlayAudio:(GADAudioVideoManager *)audioVideoManager {
// The Mobile Ads SDK is notifying your app that it will play audio. You
// could optionally pause music depending on your apps design.
[MyAppObject.sharedInstance pauseAllMusic];
}
- (void)audioVideoManagerDidStopPlayingAudio:(GADAudioVideoManager *)audioVideoManager {
// The Mobile Ads SDK is notifying your app that it has stopped playing
// audio. Depending on your design, you could resume music here.
[MyAppObject.sharedInstance resumeAllMusic];
}
クラッシュ レポート
Google Mobile Ads SDK は、iOS アプリで発生した例外を検査し、 SDK に起因する場合は記録されます。これらの例外は に対応するようになりました。
クラッシュ レポートはデフォルトで有効になっています。SDK 関連の例外が不要な場合
録音する場合は、
disableSDKCrashReporting
メソッドを使用します。このメソッドを呼び出す最適なタイミングは、
アプリが起動します。
Swift
import GoogleMobileAds
@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
func application(_ application: UIApplication,
didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
GADMobileAds.disableSDKCrashReporting()
return true
}
}
Objective-C
@import GoogleMobileAds;
@implementation AppDelegate
- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
[GADMobileAds disableSDKCrashReporting];
return YES;
}
@end
Cookie の設定に対する同意
アプリに特別な要件がある場合は、オプションの
NSUserDefaults
gad_has_consent_for_cookies
。Google Mobile Ads SDK を使うと
制限付き広告(LTD)
gad_has_consent_for_cookies
設定がゼロに設定されている場合。
Swift
UserDefaults.standard.set(0, forKey: "gad_has_consent_for_cookies")
Objective-C
NSUserDefaults.standardUserDefaults().setObject(Int(0),
forKey: "gad_has_consent_for_cookies");