Die Klasse GADMobileAds
bietet globale Einstellungen zur Steuerung bestimmter
Daten, die mit dem Mobile Ads SDK erfasst werden.
Lautstärkeregelung für Videoanzeigen
Wenn Ihre App eigene Lautstärkeregler hat, z. B. eigene Musik- oder Soundeffekte Durch die Offenlegung des App-Volumens für das Google Mobile Ads SDK werden Videoanzeigen ermöglicht. um die App-Lautstärkeeinstellungen zu übernehmen. So erhalten Nutzer Videoanzeigen mit der erwartete Audiolautstärke.
über die Lautstärketasten oder den Lautstärkeregler des Betriebssystems legt die Lautstärke der Audioausgabe des Geräts fest. Apps können jedoch unabhängig voneinander Lautstärke relativ zur Gerätelautstärke anpassen, um den Ton anzupassen Nutzererfahrung.
Für App-Start-Anzeigen, Banner, Interstitial-Anzeigen, Anzeigen mit Prämie und Interstitial-Anzeigen mit Prämie
Formate verwenden, können Sie das relative App-Volumen an das Google Mobile Ads SDK melden,
und legen das Attribut applicationVolume
fest. Gültige Werte für das Anzeigenvolumen reichen von
0.0
(laut) bis 1.0
(aktuelle Gerätelautstärke). Hier ist ein Beispiel, wie Sie
dem SDK das relative App-Volumen melden:
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;
...
}
Für App-Start-Anzeigen, Banner, Interstitial-Anzeigen, Anzeigen mit Prämie und Interstitial-Anzeigen mit Prämie
können Sie dem Google Mobile Ads SDK mitteilen, dass das App-Volumen
wird durch Festlegen der Eigenschaft applicationMuted
ignoriert:
Swift
GADMobileAds.sharedInstance().applicationMuted = true
Objective-C
GADMobileAds.sharedInstance.applicationMuted = YES;
Standardmäßig ist applicationVolume
auf 1
eingestellt (die aktuelle Gerätelautstärke).
und applicationMuted
ist auf NO
eingestellt.
Native Anzeigen
Weitere Informationen finden Sie unter
GADVideoOptions
. Bei nativen Anzeigen gibt es
Unterstützung für eine benutzerdefinierte Lautstärkeregelung.
Audiositzungen
Mit Audiositzungen können Sie dem System Ihre Absichten für die App
Audioverhalten. Weitere Informationen zu Audiositzungen finden Sie hier:
Apples Audio Session Programming
Leitfaden.
Für die Verwaltung von Audioanzeigen des Google Mobile Ads SDK sind folgende Optionen verfügbar:
die
audioVideoManager
Property.
Wenn Sie in Ihrer App kein Audio verwenden, sind diese APIs auch nicht erforderlich. Die Google Über das Mobile Ads SDK wird die Kategorie der Audiositzung automatisch verwaltet, spielt Audio ab. Wenn Sie Audioinhalte in Ihrer App wiedergeben und mehr Kontrolle über wie und wann mit dem Google Mobile Ads SDK Audio wiedergegeben wird, können Sie diese APIs verwenden.
Im Audio-Video-Manager kannst du die
audioSessionIsApplicationManaged
die Property auf YES
, wenn du die Verantwortung für die Audioverwaltung übernehmen möchtest.
die Sitzungskategorie selbst.
Wenn Sie die Kategorie der Audiositzung verwalten möchten, können Sie
GADAudioVideoManagerDelegate
und lege delegate
fest.
im Audio-Video-Manager, um über Video- und Audioanzeigen informiert zu werden
Wiedergabe-Ereignisse. Ändern Sie dann die Audiositzungskategorie in die
Kategorie entsprechend der Apple Audio Session Programming
Leitfaden.
Das folgende vereinfachte Codebeispiel zeigt die empfohlene Vorgehensweise, wenn Ihre App spielt Musik mit den oben genannten APIs ab:
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];
}
Absturzberichte
Das Google Mobile Ads SDK prüft Ausnahmen in einer iOS-App und wenn sie durch das SDK verursacht wurden. Diese Ausnahmen werden dann für zukünftige SDK-Versionen.
Absturzberichte sind standardmäßig aktiviert. Wenn Sie keine SDK-bezogenen Ausnahmen wünschen
aufgezeichnet werden soll, können Sie diese Funktion deaktivieren, indem Sie die
disableSDKCrashReporting
-Methode. Der beste Zeitpunkt für den Aufruf dieser Methode ist,
die App gestartet wird:
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
Einwilligung zur Verwendung von Cookies
Wenn Ihre App besondere Anforderungen hat, können Sie die optionale Einstellung
NSUserDefaults
gad_has_consent_for_cookies
. Mit dem Google Mobile Ads SDK
Eingeschränkte Anzeigenausrichtung
Die Einstellung gad_has_consent_for_cookies
ist auf null gesetzt.
Swift
UserDefaults.standard.set(0, forKey: "gad_has_consent_for_cookies")
Objective-C
NSUserDefaults.standardUserDefaults().setObject(Int(0),
forKey: "gad_has_consent_for_cookies");