Memutar latar belakang di iklan audio
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Panduan ini ditujukan bagi penayang iOS yang tertarik menambahkan pemutaran iklan audio latar belakang ke penerapan IMA SDK mereka. Tindakan ini memungkinkan aplikasi meminta iklan di latar belakang. Hal ini juga memungkinkan aplikasi untuk memasuki latar belakang dan terus memutar iklan sampai selesai.
Sebaiknya jangan putar iklan video di latar belakang.
Prasyarat
- Aplikasi iOS yang menerapkan IMA SDK.
- IMA SDK V3 Beta v13 atau yang lebih baru.
Pengantar yang bermanfaat
Jika Anda masih perlu menerapkan IMA SDK di aplikasi Anda, lihat Panduan Memulai kami.
Menambahkan pemutaran iklan latar belakang ke aplikasi
Menambahkan pemutaran iklan di latar belakang melakukan langkah-langkah berikut:
- Aktifkan mode latar belakang Audio dan Airplay. Di Xcode 6, pilih target, lalu di bagian Kemampuan > Mode Latar Belakang, aktifkan "Audio dan Airplay".
- Aktifkan
AVAudioSession, dan tetapkan kategorinya dengan AVAudioSessionCategory yang dapat memutar audio latar belakang, seperti AVAudioSessionCategoryPlayback.
- (void)viewDidLoad {
[super viewDidLoad];
NSError *error;
[[AVAudioSession sharedInstance] setActive:YES error:&error];
if (error != nil) {
NSLog(@"Error: %@", error.localizedDescription);
}
[[AVAudioSession sharedInstance] setCategory:AVAudioSessionCategoryPlayback error:&error];
if (error != nil) {
NSLog(@"Error: %@", error.localizedDescription);
}
}
- Buat
IMAAdsLoader dengan meneruskan objek IMASettings dengan enableBackgroundPlayback yang ditetapkan ke YES.
IMASettings *settings = [[IMASettings alloc] init];
settings.enableBackgroundPlayback = YES;
IMAAdsLoader *adsLoader = [[IMAAdsLoader alloc] initWithSettings:settings];
Penting
Untuk membuat permintaan iklan latar belakang, konten Anda harus diputar. Tindakan ini mungkin memerlukan panggilan manual pada pemutar konten saat aplikasi memasuki latar belakang sebelum memanggil [IMAAdsLoader requestAds:].
Menetapkan latar belakang aplikasi iOS akan otomatis menjeda pemutaran iklan. Jika aplikasi berada di latar belakang saat memutar iklan, Anda harus memanggil [IMAAdsManager resume] untuk melanjutkan pemutaran.
FAQ
- Apa yang terjadi jika saya tidak mengaktifkan kemampuan mode latar belakang Audio dan Airplay di aplikasi saya?
- Jika Anda tidak memilih mode ini, audio yang diputar oleh aplikasi akan berhenti saat aplikasi berpindah ke latar belakang. Aplikasi juga tidak dapat meluncurkan audio apa pun saat berada di latar belakang.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-31 UTC.
[null,null,["Terakhir diperbarui pada 2025-08-31 UTC."],[[["\u003cp\u003eThis guide helps iOS publishers add background audio ad playback to their IMA SDK implementation.\u003c/p\u003e\n"],["\u003cp\u003eRequires iOS application with IMA SDK V3 Beta v13 or greater.\u003c/p\u003e\n"],["\u003cp\u003eEnable "Audio and Airplay" background mode in Xcode and activate \u003ccode\u003eAVAudioSession\u003c/code\u003e for background audio playback.\u003c/p\u003e\n"],["\u003cp\u003eCreate an \u003ccode\u003eIMAAdsLoader\u003c/code\u003e with \u003ccode\u003eenableBackgroundPlayback\u003c/code\u003e set to \u003ccode\u003eYES\u003c/code\u003e in \u003ccode\u003eIMASettings\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eBackgrounding pauses ad playback; resume with \u003ccode\u003e[IMAAdsManager resume]\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Play background in audio ads\n\nThis guide is intended for iOS publishers interested in adding background **audio** ad playback to their IMA SDK implementation. This allows the app to request ads in the background. It also allow the app to enter the background and continue to play an ad to completion.\n\nWe do not recommend playing video ads in the background.\n\nPrerequisites\n-------------\n\n\u003cbr /\u003e\n\n- iOS application with the IMA SDK implemented.\n- IMA SDK V3 Beta v13 or greater.\n\n\u003cbr /\u003e\n\nHelpful primers\n---------------\n\nIf you still need to implement the IMA SDK in your app, check out our [Get Started guide](/interactive-media-ads/docs/sdks/ios/client-side).\n\nAdding background ad playback to your app\n-----------------------------------------\n\nAdding background ad playback takes the following steps:\n\n1. Enable the **Audio and Airplay** background mode. In Xcode 6, select a target, then under **Capabilities \\\u003e Background Modes**, enable \"Audio and Airplay\".\n2. Activate the `AVAudioSession`, and set its category with an `AVAudioSessionCategory` that can play background audio, such as `AVAudioSessionCategoryPlayback`. \n\n```objective-c\n- (void)viewDidLoad {\n [super viewDidLoad];\n\n NSError *error;\n [[AVAudioSession sharedInstance] setActive:YES error:&error];\n if (error != nil) {\n NSLog(@\"Error: %@\", error.localizedDescription);\n }\n\n [[AVAudioSession sharedInstance] setCategory:AVAudioSessionCategoryPlayback error:&error];\n if (error != nil) {\n NSLog(@\"Error: %@\", error.localizedDescription);\n }\n}\n```\n3. Create an `IMAAdsLoader`, passing in an `IMASettings` object with `enableBackgroundPlayback` set to `YES`. \n\n```objective-c\n IMASettings *settings = [[IMASettings alloc] init];\n settings.enableBackgroundPlayback = YES;\n IMAAdsLoader *adsLoader = [[IMAAdsLoader alloc] initWithSettings:settings];\n```\n\nImportant\n---------\n\nTo make background ad requests, your content must be playing. This may require manually calling play on the content player when the app enters the background before calling `[IMAAdsLoader requestAds:]`.\n\nBackgrounding an iOS app automatically pauses ad playback. If your app is backgrounded while playing an ad, you need to call `[IMAAdsManager resume]` to resume playback.\n\nFAQ\n---\n\nWhat happens if I don't enable the Audio and Airplay background mode capability in my app?\n: If you don't select this mode, any audio being played by the app stops when the app moves to the background. The app is also not able to launch any audio while backgrounded."]]
