ApsaraVideo VOD:Duet recording

Supported editions

Terms

This section describes the terms that help you better understand the duet recording feature. For more information, see Duet recording, Track, and Track layout.

Related classes

Configure duet recording

The procedure to configure duet recording is similar to that to configure video recording. The main differences lie in the input and output parameters and preview settings that you need to configure.

Configure duet recording parameters

Configure duet recording parameters as the initialization parameters of the duet recording instance. For more information about the parameters that are used in the code, see Related classes.

Configure duet recording parameters

AliyunMixMediaInfoParam *mixMediaInfo = [[AliyunMixMediaInfoParam alloc] init];
mixMediaInfo.outputSizeView = previewView;
mixMediaInfo.mixVideoInfo.filePath = mixVideoFile; // The path of the sample video.

Configure layout parameters

// Configure the view that is used to display the sample video. The view is displayed at the bottom in full screen.
CGFloat mixWidth = previewView.bounds.size.width;
CGFloat mixHeight = previewView.bounds.size.height;
mixMediaInfo.mixVideoInfo.frame = CGRectMake(0, 0, mixWidth, mixHeight);
mixMediaInfo.mixVideoInfo.layerLevel = 1;

// Configure the view that is used to display the video captured by the camera. The view is displayed at the 9:16 aspect ratio in portrait mode. The recording resolution is 360p. The view is displayed in the lower-right corner of the window and on the top of the sample video.
CGFloat recordRatio = 9.0 / 16.0;
mixMediaInfo.recordVideoInfo.resolution = CGSizeMake(360, 360 / recordRatio); 
CGFloat recordHeight = previewView.bounds.size.height * 0.5;
CGFloat recordWidth = recordHeight * recordRatio;
mixMediaInfo.recordVideoInfo.frame = CGRectMake(previewView.bounds.size.width - recordWidth - 4.0, previewView.bounds.size.height - recordHeight - 4, recordWidth, recordHeight);
mixMediaInfo.recordVideoInfo.layerLevel = 2;

// Configure the border of the sample video. This setting is optional.
mixMediaInfo.mixVideoInfo.borderInfo.color = UIColor.blueColor;
mixMediaInfo.mixVideoInfo.borderInfo.width = 2;
mixMediaInfo.mixVideoInfo.borderInfo.cornerRadius = 6.0;

// Configure the border of the video captured by the camera. This setting is optional.
mixMediaInfo.recordVideoInfo.borderInfo.color = UIColor.blueColor;
mixMediaInfo.recordVideoInfo.borderInfo.width = 1;
mixMediaInfo.recordVideoInfo.borderInfo.cornerRadius = 6.0;

Create a duet recording object

AliyunMixRecorder *_recorder = [[AliyunMixRecorder alloc] initWithMediaInfo:mixMediaInfo outputSize:CGSizeMake(720, 720)];
_recorder.outputType = AliyunIRecorderVideoOutputPixelFormatType420f;
_recorder.useFaceDetect = YES;
_recorder.faceDetectCount = 2;
_recorder.faceDectectSync = NO;
_recorder.frontCaptureSessionPreset = AVCaptureSessionPreset1280x720;
_recorder.GOP = 250;
_recorder.videoQuality = AliyunVideoQualityHight;
_recorder.recordFps = 30;
_recorder.outputPath = [taskPath stringByAppendingPathComponent:@"output.mp4"];
_recorder.cameraRotate = 0;
_recorder.beautifyStatus = YES;
_recorder.frontCameraSupportVideoZoomFactor = YES;

self.aliyunMixRecorder = _recorder;

// We recommend that you set the duration of the sample video as the duration of the duet. If the duration is reached, a recorderDidStopWithMaxDuration callback is triggered.
AVURLAsset *asset = [AVURLAsset assetWithURL:[NSURL fileURLWithPath:[self resourcePath:mixVideoPath]]];
[self.aliyunMixRecorder setRecordMaxDuration:asset.aliyunVideoDuration];
[self.aliyunMixRecorder setRecordMinDuration:1.0];

// Set the background color for the duet.
[self.aliyunMixRecorder setBackgroundColor:0xFF0100];

// Set the background image for the duet.
NSString *imgPath = [self.class resourcePath:@"pig.jpeg"];
[self.aliyunMixRecorder setBackgroundImageFilePath:imgPath imageDisplayMode:AliyunMixVideoBackgroundImageModeScaleAspectFit];

Configure the output audio

// Configure the hardware echo removal effect. We recommend that you use the Hardware mode.
self.aliyunMixRecorder.recorderAECType = AliyunIRecorderAECTypeHardware;

// Configure a duet to use the recorded audio track.
[self.aliyunMixRecorder setMixAudioSource:MixAudioSourceTypeBoth];
[self.aliyunMixRecorder setMixAudioOriginalWeight:50 recordWeight:50];

Configure callbacks

You can configure callbacks to obtain the processing progress, and status of audio and video in a timely manner. For more information about the parameters that are used in the code, see Related classes.

- (void)recorderDeviceAuthorization:(AliyunIRecorderDeviceAuthor)status {
    dispatch_async(dispatch_get_main_queue(), ^{
        if (status == AliyunIRecorderDeviceAuthorAudioDenied) {
            [DeviceAuthorization openSetting:@"You are not authorized to use the microphone."];
        } else if (status == AliyunIRecorderDeviceAuthorVideoDenied) {
            [DeviceAuthorization openSetting:@"You are not authorized to use the camera."];
        }
    });
}

// The recording progress.
- (void)recorderVideoDuration:(CGFloat)duration {
    NSLog(@"Mix Record Video Duration: %f", duration);
}

// Stop recording.
- (void)recorderDidStopRecording {
    NSLog(@"Mix Record Stop Recording");
}

// The recording stops when the maximum recording duration is reached.
- (void)recorderDidStopWithMaxDuration {
    NSLog(@"Mix Record Stop Recording With Max Duration");
    [self.aliyunMixRecorder finishRecording]; // The recording is complete.
}

// The recording is complete.
- (void)recorderDidFinishRecording {
    NSLog(@"Mix Record Did Finish Recording");
}

// The merge for duet recording is complete.
- (void)mixRecorderComposerDidComplete {
    NSLog(@"Mix Record Complete");
    [[MBProgressHUD HUDForView:self.view] hideAnimated:YES];
}

// An error occurred during the merge.
- (void)mixRecorderComposerDidError:(int)errorCode {
    NSLog(@"Mix Record Error");
    [[MBProgressHUD HUDForView:self.view] hideAnimated:YES];
}

// Merge starts for duet recording.
- (void)mixRecorderComposerDidStart {
    NSLog(@"Mix Record Start");
    MBProgressHUD *hud = [MBProgressHUD showHUDAddedTo:self.view animated:YES];
    hud.mode = MBProgressHUDModeDeterminate;
    hud.removeFromSuperViewOnHide = YES;
    hud.label.text = @"Merging...";
}

// The merge is complete.
- (void)mixRecorderComposerOnProgress:(CGFloat)progress {
    NSLog(@"Mix Record Progress: %f", progress);
    MBProgressHUD *hub = [MBProgressHUD HUDForView:self.view];
    hub.progress = progress / self.aliyunMixRecorder.recordDuration;
}

Configure preview

For more information about the parameters that are used in the code, see Related classes.

// Enable the preview.
[self.aliyunMixRecorder startPreviewWithPositon:AliyunIRecorderCameraPositionFront];

// Stop the preview. Call stopPreview after the recording is complete.
[self.aliyunMixRecorder stopPreview];

Start recording

startRecording and stopRecording must be called in pairs. You can call them once or multiple times, and one or more temporary video clips are generated. For more information about the parameters that are used in the code, see Related classes.

// Start recording a video clip.
[self.aliyunMixRecorder startRecording];  

// Stop recording a video clip.
[self.aliyunMixRecorder stopRecording];

Stop recording

After the recording is complete, you can call finishRecording to merge the sample video and the video captured by the camera. For more information about the parameters that are used in the code, see Related classes.

// Stop recording, and merge the sample video and the video captured by the camera.
[self.aliyunMixRecorder finishRecording];

Other settings

Duet recording also supports recording effects such as retouching, filters, and background music. You can use the AliyunMixRecorder class to configure recording effects and features such as photo taking. The configuration method is similar to the configuration method that is used for basic recording. For more information, see Basic recording.