ApsaraVideo VOD:Basic recording

Enable preview

// Call AliyunIRecorderCameraPositionFront to enable preview for the front camera.
// Call AliyunIRecorderCameraPositionBack to enable preview for the rear camera.
[self.aliyunRecorder startPreviewWithPositon:AliyunIRecorderCameraPositionFront];

After you enable preview, you can configure the preview parameters based on your business requirements.

// Turn on the flashlight. You can turn on the flashlight when the rear camera is used.
AliyunIRecorderTorchMode torchMode = self.aliyunRecorder.cameraPosition == AliyunIRecorderCameraPositionBack ? AliyunIRecorderTorchModeOn : AliyunIRecorderTorchModeOff;
[self.aliyunRecorder switchTorchWithMode:torchMode];

// Switch between the front and rear cameras.
[self.aliyunRecorder switchCameraPosition];

// Specify the zoom factor.
self.aliyunRecorder.videoZoomFactor = 30.0;

// Specify the camera angle.
self.aliyunRecorder.cameraRotate = 270;

// Specify the video resolution.
[self.aliyunRecorder reStartPreviewWithVideoSize:CGSizeMake(720, 720)];

// After the recording is complete, call stopPreview to stop preview.

[self.aliyunRecorder stopPreview];

If you stop recording, the recorded video clips are merged into a video or the configuration information about the recorded video clips is generated. For more information about the parameters that are used in the code, see Related classes.

• finishRecording: merges the recorded video clips into one video. Call this API operation if you do not need to continue editing the generated video.
• finishRecordingForEdit: does not merge the recorded video clips. Call this API operation if you want to continue editing the generated video later. You can initialize the editor by configuring the taskPath parameter. For more information, see Initialize an editor.

// Stop recording and merge the recorded video clips into one video.
[self.aliyunRecorder finishRecording];

// Stop recording without merging the recorded video clips into one video. taskPath is generated.
NSString *taskPath = [self.aliyunRecorder finishRecordingForEdit];
AliyunEditor *editor = [[AliyunEditor alloc] initWithPath:taskPath preview:preview];
...

You can create custom filters. For more information, see Filters and transitions.

// Add a filter.
NSString *filterDir = [self.class resourcePath:@"Filter/Jiaopian"];
AliyunEffectFilter *filter = [[AliyunEffectFilter alloc] initWithFile:filterDir];
[self.aliyunRecorder applyFilter:filter];

// Remove a filter.
[self.aliyunRecorder deleteFilter];

Animated filters

// Add an animated filter.
NSString *filterDir = [self.class resourcePath:@"AnimationEffect/split_screen_3"];
AliyunEffectFilter *animationFilter =[[AliyunEffectFilter alloc] initWithFile:filterDir];
[self.aliyunRecorder applyAnimationFilter:animationFilter];

// Remove an animated filter.
[self.aliyunRecorder deleteAnimationFilter];

Built-in facial recognition

// Use the built-in facial recognition feature to add face stickers.
self.aliyunRecorder.useFaceDetect = YES;// Enable facial recognition. Faces can be automatically tracked.
self.aliyunRecorder.faceDetectCount = 3;// Specify the number of faces that can be recognized. Maximum value: 3. Minimum value: 1. If you do not need facial recognition, set the useFaceDetect parameter to NO.
self.aliyunRecorder.faceDectectSync = YES;// Allow face stickers to fit into faces in real time. Face stickers can fit well into moving faces. However, stuttering may occur on devices with poor performance. If you do not enable this feature, though the smoothness of videos can be ensured, face stickers badly fit into moving faces. 
NSString *parsterDir = [self.class resourcePath:@"Gif/hanfumei-800"];
AliyunEffectPaster *paster = [[AliyunEffectPaster alloc] initWithFile:parsterDir];
[self.aliyunRecorder applyPaster:paster];// Add a face sticker.

// Remove a face sticker.
[self.aliyunRecorder deletePaster:paster];

Custom facial recognition

// Disable the built-in facial recognition feature.
self.aliyunRecorder.useFaceDetect = NO;
// Call the facial recognition library of a third party in the callback to recognize faces. Results are returned.

- (void)recorderOutputVideoRawSampleBuffer:(CMSampleBufferRef)sampleBuffer {
    NSArray<AliyunFacePoint *> *facePoints = ...; // Use the facial recognition library of a third party to recognize faces.
    if (self.aliyunRecorder.faceNumbersCallback) {
        int num = (int)facePoints.count;
        self.aliyunRecorder.faceNumbersCallback(num);
    }
    [self.aliyunRecorder faceTrack:facePoints];
}

Setting a watermark means adding and rendering an image. You can call the applyImage operation to add and render a static sticker. For example, you can take a photo and attach a frame to the photo.

// Add a watermark.
NSString *watermarkPath = [self.class resourcePath:@"Image/watermark.png"];
AliyunEffectImage *watermark = [[AliyunEffectImage alloc] initWithFile:watermarkPath];
CGSize size = CGSizeMake(280, 200);
CGFloat centerx = 44 + size.width / 2.0;
CGFloat centery = 44 + size.height / 2.0;
watermark.frame = CGRectMake(centerx, centery, size.width, size.height); // Take note that the origin of a frame indicates the center point.
[self.aliyunRecorder applyImage:watermark];

// Remove a watermark.
[self.aliyunRecorder deleteImage:watermark];

Music

// Add music.
AliyunEffectMusic *effectMusic =[[AliyunEffectMusic alloc] initWithFile:[self.class resourcePath:@"bgm.aac"]];
effectMusic.startTime = 3.0; // The music plays from the 3-second position.
effectMusic.duration = 5.0;  // The music plays for 5 seconds. If you do not configure this parameter, the music plays for its remaining duration of up to 360 seconds.
[self.aliyunRecorder applyMusic:effectMusic];

// Remove music.
[self.aliyunRecorder applyMusic:nil];

The video recording module not only provides basic built-in retouching features, but also supports the use of retouching SDKs, such as Alibaba Cloud Queen SDK and FaceUnity. You can use the built-in retouching features to configure only the retouching level. The retouching SDKs provide abundant retouching effects, such as face retouching, face shaping, makeup, filters, and stickers.

• Built-in retouching

  // Enable built-in retouching.
  self.aliyunRecorder.beautifyStatus = YES;
  self.aliyunRecorder.beautifyValue = 80;
  
  // Disable built-in retouching.
  self.aliyunRecorder.beautifyStatus = NO;
  self.aliyunRecorder.beautifyValue = 0;

• Retouching SDKs
  To use effects provided by a retouching SDK in the short video SDK, you must first obtain the permissions on the retouching SDK and integrate the retouching SDK into the short video SDK.

  • For more information about how to integrate Alibaba Cloud Queen SDK, see Queen SDK. For more information about the sample code for configuring effects, see Sample code.
  • For more information about how to purchase, integrate, and use FaceUnity, see FaceUnity.

  The short video SDK passes the CMSampleBufferRef data that is collected by the camera to the business layer by using AliyunIRecorderDelegate. The retouching SDK that is imported into the business layer performs custom rendering of the data and then returns the rendering result CVPixelBufferRef to the short video SDK for preview and production. Take note that the retouching SDK conflicts with the GL environment of the short video SDK.

  // AliyunIRecorderDelegate
  - (CVPixelBufferRef)customRenderedPixelBufferWithRawSampleBuffer:(CMSampleBufferRef)sampleBuffer {
      if (!self.enableBeauty) {
          return CMSampleBufferGetImageBuffer(sampleBuffer);  // This is returned if you do not perform custom rendering.
      }
      
      // If you integrate Queen SDK to perform custom rendering, sample CVPixelBufferRef is returned.
      ...
  }

Photo capture

 // Take a photo and asynchronously obtain the following types of images:
 // image: the rendered image that is collected.
 // rawImage: the raw image that is collected.
[self.aliyunRecorder takePhoto:^(UIImage *image, UIImage *rawImage) {
        
}];