ApsaraVideo VOD:Basic recording

Initialize the class

// Create a recording instance.
AliyunIRecorder recorder = AliyunRecorderCreator.getRecorderInstance(context);// The context parameter indicates the context of the current screen.

// Destroy the recording instance.
// Destroy the recording instance if you no longer need to use the SDK, or before you exit the program. Do not destroy the recording instance during usage.
recorder.destroy();

Configure recording parameters

// Specify the quality of the recorded video.
recorder.setVideoQuality(quality);

// Specify the bitrate of the recorded video.
recorder.setVideoBitrate(int bitrate);// Unit: Kbit/s.

// Configure output parameters for the recorded video.
recorder.setMediaInfo(mediaInfo);// For more information about the parameters, see MediaInfo in the SDK references.

// Specify the output path of the recorded video.
recorder.setOutputPath(string path);

// Specify the output group of pictures (GOP) of the recorded video.
recorder.setGop(int gop);// Unit: frames.

Start recording

// Start recording.
recorder.startRecording();

Record a video clip

// Start recording.
recorder.startRecording();

// Stop recording. A video clip is generated.
recorder.stopRecording();

recorder.startRecording();
// Cancel recording. The current video clip is not saved.
recorder.cancelRecording();

// Continue to record the next video clip.
recorder.startRecording();
recorder.stopRecording();

Configure camera settings

// Obtain the number of cameras.
AliyunIRrecorder.getCameraCount();

// Specify the camera type.
AliyunIRecorder.setCamera(cameraType);

// Specify whether to mute the audio during recording.
AliyunIRecorder.setMute(boolean isMute);

// Specify the angle of the sensor.
// This setting is very important. We recommend that you read the SDK references. 
AliyunIRecorder.setRotation(int rotation);

// Specify the angle at which a video is recorded.
// This setting is very important. We recommend that you read the SDK references. 
AliyunIRecorder.setRecordRotation(int rotation);

// Configure the camera parameters during preview, including the flash mode, focus mode, zoom factor, and exposure level. You can also configure the preview parameters separately by using the following methods.
AliyunIRecorder.setCameraParam(CameraParam cameraParam);

// Switch between the front and rear cameras.
AliyunIRecorder.switchCamera();

// Specify the flash mode.
AliyunIRecorder.setLight(flashType);

// Specify the zoom factor. 
AliyunIRecorder.setZoom(float rate);

// Specify the exposure level. 
AliyunIRecorder.setExposureCompensationRatio(float value);

// Specify the focus mode. 
AliyunIRecorder.setFocusMode(int mode);

// Configure manual focus. 
AliyunIRecorder.setFocus(float xRatio, float yRatio);

Manage video clips

// Obtain the clip manager.
AliyunIClipManager manager = AliyunIRecorder.getClipManager();

// Specify the maximum recording duration, which is the maximum duration of all video clips instead of a single video clip.
manager.setMaxDuration(int maxDurationMs);

// Specify the minimum recording duration, which is the minimum duration of all video clips instead of a single video clip.
manager.setMinDuration(int minDurationMs);

// Delete the last video clip.
manager.deletePart();

// Delete the specified video clip.
manager.deletePart(int index);

// Delete all video clips.
manager.deleteAllPart();

// Obtain the total duration of video clips.
manager.getDuration();

// Obtain the total number of video clips.
manager.getPartCount();

// Obtain the paths of video clips.
manager.getVideoPathList();

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

// Apply a filter.
AliyunIRecorder.applyFilter(EffectFilter effectFilter);// If the path is set to null, the filter is removed.

// Remove a filter.
AliyunIRecorder.applyFilter(new EffectFilter(null));

Animated filters

// Apply an animated filter.
AliyunIRecorder.applyAnimationFilter(EffectFilter effectFilter);

// Remove an animated filter.
AliyunIRecorder.removeAnimationFilter(EffectFilter effctFilter);

Background music

// Configure the background music.
AliyunIRecorder.setMusic(String path,long startTime,long duration);

// Remove the background music.
AliyunIRecorder.setMusic(null, 0, 0);

Speed ramping

// Configure speed ramping for recording.
AliyunIRecorder.setRate(float rate);

Static stickers and static watermarks

// Add a static watermark or a static sticker.
AliyunIRecorder.addImage(EffectImage effctImage);

// Remove a static watermark or a static sticker.
AliyunIRecorder.removeImage(EffectImage effctImage);

// Update the position of a static watermark or a static sticker.
AliyunIRecorder.setEffectView(float xRatio,float yRatio,float widthRatio,float heightRatio,EffectBase effectBase);

You can create custom animated stickers. For more information, see Animations.

// Add an animated sticker.
AliyunIRecorder.addPaster(EffectPaster effectPaster,float sx,float sy,float sw,float sh,float rotation,boolean flip);

// Remove an animated sticker.
AliyunIRecorder.removePaster(EffectPaster effectPaster);

// Update the position of an animated sticker.
AliyunIRecorder.setEffectView(float xRatio,float yRatio,float widthRatio,float heightRatio,EffectBase effectBase);

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 or disable retouching.
  AliyunIRecorder.setBeautyStatus(boolean on);
  
  // Configure the retouching level.
  AliyunIRecorder.setBeautyLevel(int level);

• 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 camera texture ID and the camera raw frame data are required for retouching SDKs to implement retouching effects. The following code provides an example on how to obtain the camera texture ID and the camera raw frame data.

  • Obtain the camera texture ID

    AliyunIRecorder.setOnTextureIdCallback(new OnTextureIdCallBack() {
                @Override
                public int onTextureIdBack(int textureId, int textureWidth, int textureHeight, float[] matrix) {
                    if (mBeautyInterface != null) {
                        return mBeautyInterface.onTextureIdBack(textureId, textureWidth, textureHeight, matrix, mControlView.getCameraType().getType());
                    }
                    return textureId;
                }
    
                @Override
                public int onScaledIdBack(int scaledId, int textureWidth, int textureHeight, float[] matrix) {
    
                    return scaledId;
                }
    
                @Override
                public void onTextureDestroyed() {
                    // For a version of the short video SDK earlier than V3.7.8, you can destroy gl resources for third-party custom rendering by using GLSurfaceView.queueEvent in GLSurfaceView. For the short video SDK V3.7.8 and later, we recommend that you destroy gl resources in this callback.
                    if (mBeautyInterface != null) {
                        mBeautyInterface.release();
                        mBeautyInterface = null;
                    }
                }
            });

  • Obtain the camera raw frame data

    AliyunIRecorder.setOnFrameCallback(new OnFrameCallBack() {
                @Override
                public void onFrameBack(byte[] bytes, int width, int height, Camera.CameraInfo info) {
                    // The data type of the callback raw data is NV21. The obtained raw data is used by FaceUnity.
                    if (mBeautyInterface != null) {
                        mBeautyInterface.onFrameBack(bytes, width, height, info);
                    }
                }
    
                @Override
                public Camera.Size onChoosePreviewSize(List<Camera.Size> supportedPreviewSizes,
                                                       Camera.Size preferredPreviewSizeForVideo) {
                    return null;
                }
    
                @Override
                public void openFailed() {
                    
                }
            });

You can take a photo with effects enabled or by using the default camera settings. The default camera settings do not support effects. After a photo is taken, the data is returned by using RecordCallback.onPictureBack(Bitmap) or RecordCallback.onPictureDataBack(byte[]).

// Take a photo with effects enabled.
AliyunIRecorder.takePhoto(boolean needBitmap);

// Take a photo by using the default camera settings. The default camera settings do not support effects.
AliyunIRecorder.takePicture(boolean needBitmap);

// Specify the size of a photo. This method is supported only if you take a photo by using the default camera settings.
AliyunIRecorder.setPictureSize(Camera.Size size);

If you want to use facial recognition, you must access the built-in facial recognition model of your application. You can download the Facial recognition model demo for reference.

// Specify whether to enable facial recognition.
AliyunIRecorder.needFaceTrackInternal(boolean need);

// Specify the path of the facial recognition model file.
AliyunIRecorder.setFaceTrackInternalModelPath(String path);

// Specify the angle at which facial recognition is performed.
// This setting is very important. We recommend that you read the SDK references. 
AliyunIRecorder.setFaceDetectRotation(int rotation);

// Specify the number of faces that can be recognized.
// Specify the maximum number of faces that can be recognized at the same time. Maximum value: 3.
AliyunIRecorder.setFaceTrackInternalMaxFaceCount(int maxFaceCount);

// Add an animated face sticker.
AliyunIRecorder.addPaster(EffectPaster effectPaster);