Language:
From App Bundle
VideoEditor SDK supports loading audio files from the app bundle.
In order to load audio clips from our bundle, we pass the bundle URL for our resource to the AudioClip
constructor along with an identifier.
AudioClip
objects, additionally, hold metadata such as a thumbnailURL
and the duration
of the clip.
Note that the AudioClip
class is not optimized to handle remote resources, see next section on how to handle loading audio clips from remote resource.
We then need to add the audio clips to an AudioClipCategory
object which holds the metadata of the category such as a preview image and a title.
Finally we can configure the assetCatalog
by assigning an array of the audio clip categories we want to include to the audioClips
property.
File:
import UIKitimport VideoEditorSDKclass AddAudioOverlaysFromAppBundleSwift: Example, VideoEditViewControllerDelegate {override func invokeExample() {// Create a `Video` from a URL to a video in the app bundle.let video = Video(url: Bundle.main.url(forResource: "Skater", withExtension: "mp4")!)// Identifiers of audio clips in the app bundle.let elsewhereAudioClipIdentifiers = ["elsewhere","trapped_in_the_upside_down"]let otherAudioClipIdentifiers = ["dance_harder","far_from_home"]// Create new audio clip categories with custom audio clips from// the app bundle.let elsewhereClips = elsewhereAudioClipIdentifiers.map { AudioClip(identifier: $0, audioURL: Bundle.main.url(forResource: $0, withExtension: ".mp3")!) }let otherClips = otherAudioClipIdentifiers.map { AudioClip(identifier: $0, audioURL: Bundle.main.url(forResource: $0, withExtension: ".mp3")!) }let elsewhereAudioClipCategory = AudioClipCategory(title: "Elsewhere", imageURL: nil, audioClips: elsewhereClips)let otherAudioClipCategory = AudioClipCategory(title: "Other", imageURL: nil, audioClips: otherClips)// Create a `Configuration` object.let configuration = Configuration { builder in// In this example we are using the default assets for the asset catalog as a base.// However, you can also create an empty catalog as well which only contains your// custom assets.let assetCatalog = AssetCatalog.defaultItems// Add the custom audio clips to the asset catalog.assetCatalog.audioClips = [elsewhereAudioClipCategory, otherAudioClipCategory]// Use the new asset catalog for the configuration.builder.assetCatalog = assetCatalog}// Create and present the video editor. Make this class the delegate of it to handle export and cancelation.let videoEditViewController = VideoEditViewController(videoAsset: video, configuration: configuration)videoEditViewController.delegate = selfvideoEditViewController.modalPresentationStyle = .fullScreenpresentingViewController?.present(videoEditViewController, animated: true, completion: nil)}// MARK: - VideoEditViewControllerDelegatefunc videoEditViewControllerShouldStart(_ videoEditViewController: VideoEditViewController, task: VideoEditorTask) -> Bool {// Implementing this method is optional. You can perform additional validation and interrupt the process by returning `false`.true}func videoEditViewControllerDidFinish(_ videoEditViewController: VideoEditViewController, result: VideoEditorResult) {// The user exported a new video successfully and the newly generated video is located at `result.output.url`. Dismissing the editor.presentingViewController?.dismiss(animated: true, completion: nil)}func videoEditViewControllerDidFail(_ videoEditViewController: VideoEditViewController, error: VideoEditorError) {// There was an error generating the video.print(error.localizedDescription)// Dismissing the editor.presentingViewController?.dismiss(animated: true, completion: nil)}func videoEditViewControllerDidCancel(_ videoEditViewController: VideoEditViewController) {// The user tapped on the cancel button within the editor. Dismissing the editor.presentingViewController?.dismiss(animated: true, completion: nil)}}