ApsaraVideo VOD:Basic recording

Enable preview

// Use AliyunIRecorderCameraPositionFront to start the preview with the front camera.
// Use AliyunIRecorderCameraPositionBack to start the preview with the rear camera.
[self.aliyunRecorder startPreviewWithPositon:AliyunIRecorderCameraPositionFront];

After you enable the preview, you can adjust preview parameters as needed.

// Turn the flashlight on or off. The flashlight is available only for the rear camera.
AliyunIRecorderTorchMode torchMode = self.aliyunRecorder.cameraPosition == AliyunIRecorderCameraPositionBack ? AliyunIRecorderTorchModeOn : AliyunIRecorderTorchModeOff;
[self.aliyunRecorder switchTorchWithMode:torchMode];

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

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

// Adjust the camera rotation angle.
self.aliyunRecorder.cameraRotate = 270;

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

Typically, you stop the preview after you finish recording.

[self.aliyunRecorder stopPreview];

When you stop a recording session, you can either generate a single video by merging all clips or generate only the configuration information for the clips. For more information about the code parameters, see the API reference in Related classes.

• finishRecording: Merges all video clips into a single, complete video. Use this method if no further editing is required.

• finishRecordingForEdit: Does not merge video clips. Use this method if you plan to perform further editing on the recorded video clips. You can initialize an editor instance by using the output taskPath. For more information, see Initialize an editor.

You can create custom filters. For more information about how to create filters, 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 the 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 the animated filter.
[self.aliyunRecorder deleteAnimationFilter];

Add a face sticker with built-in facial recognition

// Add a face sticker by using the built-in facial recognition.
self.aliyunRecorder.useFaceDetect = YES;// Enable facial recognition to automatically track faces.
self.aliyunRecorder.faceDetectCount = 3;// Set the maximum number of faces to detect. Valid values: 1 to 3. To disable facial recognition, set useFaceDetect to NO.
self.aliyunRecorder.faceDectectSync = YES;// Enable synchronous face tracking. This provides better sticker adherence but may cause stuttering on low-performance devices. Asynchronous tracking is smoother but less precise.
NSString *parsterDir = [self.class resourcePath:@"Gif/hanfumei-800"];
AliyunEffectPaster *paster = [[AliyunEffectPaster alloc] initWithFile:parsterDir];
[self.aliyunRecorder applyPaster:paster];// Add the face sticker.

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

Custom facial recognition

// Step 1: Disable the built-in facial recognition.
self.aliyunRecorder.useFaceDetect = NO;
// Step 2: Use a third-party facial recognition library in the callback to detect faces and return the results.

- (void)recorderOutputVideoRawSampleBuffer:(CMSampleBufferRef)sampleBuffer {
    NSArray<AliyunFacePoint *> *facePoints = ...; // Detect faces by using a third-party library.
    if (self.aliyunRecorder.faceNumbersCallback) {
        int num = (int)facePoints.count;
        self.aliyunRecorder.faceNumbersCallback(num);
    }
    [self.aliyunRecorder faceTrack:facePoints];
}

A watermark is a rendered image. The applyImage API adds static images, which you can use to create watermarks or effects like photo frames.

// 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); // Note: The origin of the frame specifies the center point.
[self.aliyunRecorder applyImage:watermark];

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

Music

// Add background music.
AliyunEffectMusic *effectMusic =[[AliyunEffectMusic alloc] initWithFile:[self.class resourcePath:@"bgm.aac"]];
effectMusic.startTime = 3.0; // Start playback from the 3-second mark of the music file.
effectMusic.duration = 5.0;  // Play for 5 seconds. If not set, the music plays for its remaining duration, up to 360 seconds.
[self.aliyunRecorder applyMusic:effectMusic];

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

The video recording module provides a basic built-in retouching feature. It also supports external retouching SDKs, such as Alibaba Cloud Queen SDK and the FaceUnity SDK. The built-in retouching feature is basic and only allows you to set a beauty level. External SDKs typically offer more advanced features, including retouching, face shaping, makeup effects, filters, and stickers.

• Built-in retouching

  // Enable
  self.aliyunRecorder.beautifyStatus = YES;
  self.aliyunRecorder.beautifyValue = 80;
  
  // Disable
  self.aliyunRecorder.beautifyStatus = NO;
  self.aliyunRecorder.beautifyValue = 0;

• External retouching SDKs

  To use effects from an external retouching SDK, you must first obtain the required permissions for the SDK and integrate it into the short video SDK.

  • For information about how to integrate Alibaba Cloud Queen SDK, see Queen SDK. For code examples of effect configuration, see Examples.

  • To purchase, integrate, and use the FaceUnity SDK, see FaceUnity.

  The short video SDK uses the AliyunIRecorderDelegate callback to pass raw video frames (CMSampleBufferRef) to your app. You can then use an external retouching SDK for custom rendering. After processing, return the data (CVPixelBufferRef) to the short video SDK for preview and final composition. Note: Ensure that the GL environments of the external retouching SDK and the short video SDK do not conflict.

  // AliyunIRecorderDelegate
  - (CVPixelBufferRef)customRenderedPixelBufferWithRawSampleBuffer:(CMSampleBufferRef)sampleBuffer {
      if (!self.enableBeauty) {
          return CMSampleBufferGetImageBuffer(sampleBuffer);  // If custom rendering is not enabled, return the raw buffer directly.
      }
      
      // Perform custom rendering. You can integrate a retouching SDK here and return the processed CVPixelBufferRef.
      ...
  }

Photo capture

 // Asynchronously capture a photo.
 // image: The final, rendered image after processing.
 // rawImage: The original, unprocessed image.
[self.aliyunRecorder takePhoto:^(UIImage *image, UIImage *rawImage) {
        
}];