AVAssetExportSession - Exporting a Trimmed Audio Asset
Q:
When creating .m4a output files, how do I configure an AVAssetExportSession object to trim audio assets and also perform a fade in?
A: When creating .m4a output files, how do I configure an AVAssetExportSession object to trim audio assets and also perform a fade in?
An AVAssetExportSession object is used to transcode the contents of an AVAsset source and has a number of configurable properties allowing the export operation to be customized. Output is described by a specified export preset, for example AVAssetExportPresetAppleM4A which will produce audio-only .m4a files.
Specifying the duration of the asset being exported may be done with the timeRange property. This property is a CMTimeRange describing start time and duration.
Another useful property is audioMix. By specifying a configured AVAudioMix object for the audioMix export property, you can perform custom audio processing on audio tracks during export.
Listing 1 demonstrates the basic configuration of an AVAssetExportSession object required to export an audio asset trimmed to 20 seconds with a 10 second fade in. The trim being set up in the code snippet takes place at the 30 second mark of the asset and therefore the track duration should be at least 50 seconds.
For more information regarding the AV Foundation APIs see the AV Foundation Programming Guide.
Listing 1 Exporting a trimmed audio asset with a fade in.
- (BOOL)exportAsset:(AVAsset *)avAsset toFilePath:(NSString *)filePath {
// we need the audio asset to be at least 50 seconds long for this snippet
CMTime assetTime = [avAsset duration];
Float64 duration = CMTimeGetSeconds(assetTime);
if (duration < 50.0) return NO;
// get the first audio track
NSArray *tracks = [avAsset tracksWithMediaType:AVMediaTypeAudio];
if ([tracks count] == 0) return NO;
AVAssetTrack *track = [tracks objectAtIndex:0];
// create the export session
// no need for a retain here, the session will be retained by the
// completion handler since it is referenced there
AVAssetExportSession *exportSession = [AVAssetExportSession
exportSessionWithAsset:avAsset
presetName:AVAssetExportPresetAppleM4A];
if (nil == exportSession) return NO;
// create trim time range - 20 seconds starting from 30 seconds into the asset
CMTime startTime = CMTimeMake(30, 1);
CMTime stopTime = CMTimeMake(50, 1);
CMTimeRange exportTimeRange = CMTimeRangeFromTimeToTime(startTime, stopTime);
// create fade in time range - 10 seconds starting at the beginning of trimmed asset
CMTime startFadeInTime = startTime;
CMTime endFadeInTime = CMTimeMake(40, 1);
CMTimeRange fadeInTimeRange = CMTimeRangeFromTimeToTime(startFadeInTime,
endFadeInTime);
// setup audio mix
AVMutableAudioMix *exportAudioMix = [AVMutableAudioMix audioMix];
AVMutableAudioMixInputParameters *exportAudioMixInputParameters =
[AVMutableAudioMixInputParameters audioMixInputParametersWithTrack:track];
[exportAudioMixInputParameters setVolumeRampFromStartVolume:0.0 toEndVolume:1.0
timeRange:fadeInTimeRange];
exportAudioMix.inputParameters = [NSArray
arrayWithObject:exportAudioMixInputParameters];
// configure export session output with all our parameters
exportSession.outputURL = [NSURL fileURLWithPath:filePath]; // output path
exportSession.outputFileType = AVFileTypeAppleM4A; // output file type
exportSession.timeRange = exportTimeRange; // trim time range
exportSession.audioMix = exportAudioMix; // fade in audio mix
// perform the export
[exportSession exportAsynchronouslyWithCompletionHandler:^{
if (AVAssetExportSessionStatusCompleted == exportSession.status) {
NSLog(@"AVAssetExportSessionStatusCompleted");
} else if (AVAssetExportSessionStatusFailed == exportSession.status) {
// a failure may happen because of an event out of your control
// for example, an interruption like a phone call comming in
// make sure and handle this case appropriately
NSLog(@"AVAssetExportSessionStatusFailed");
} else {
NSLog(@"Export Session Status: %d", exportSession.status);
}
}];
return YES;
} |
Document Revision History
| Date | Notes |
|---|---|
| 2011-01-11 | New document that demonstrates how to configure an export session to trim an audio asset and add a fade in. |
Copyright © 2011 Apple Inc. All Rights Reserved. Terms of Use | Privacy Policy | Updated: 2011-01-11