Skip to main content

You are viewing Agora Docs forBetaproducts and features. Switch to Docs

Android
iOS
macOS
Web
Windows
Electron
Flutter
React Native
React JS
Unity
Unreal Engine
Unreal (Blueprint)

Camera Movement

The Camera Movement extension enhances user experience by providing rhythmic and immersive interactions through dynamic camera movements.

Applicable scenarios

Camera Movement can be flexibly used in the following scenarios:

  • Live entertainment broadcasts: Highlight the host's unique style and expressions with various camera rhythm modes.
  • Meetings and education: Use portrait lock mode to keep the focus on the key presenter with intelligent tracking and lens adjustments, enhancing professionalism and interactivity.

Understand the tech

The Camera Movement extension includes the following functions:

FunctionDescription
Portrait lock modeUtilizes the face recognition technology to track and lock onto the portrait subject in real time, keeping them centered in the frame and preventing deviations that could impact the interactive experience.
Heartbeat modeAn intelligent algorithm simulates the rhythm of a human heartbeat and integrates it into the video, making scene transitions more dynamic.
Portrait light and shadow modeDisplays a virtual image behind the host to create unique light and shadow effects, making the host's performance more striking.
Up and down rhythmProvides more freedom and flexibility for camera movements through different rhythmic modes, presenting diverse perspectives and offering a wider interactive space.
Left and right rhythmProvides more freedom and flexibility for camera movements through different rhythmic modes, presenting diverse perspectives and offering a wider interactive space.
Back and forth rhythmProvides more freedom and flexibility for camera movements through different rhythmic modes, presenting diverse perspectives and offering a wider interactive space.

The effects of some functions are as follows:

Prerequisites

To follow this procedure, you must have:

  • Integrated the v4.2.x or v4.3.x of the Video SDK and implemented basic real-time audio and video functions in your app. See SDK quickstart.
    info
    • When integrating through Maven Central, specify io.agora.rtc:full-sdk:x.y.z and replace x.y.z with the specific SDK version number.
    • The MetaKit extension uses the Face Capture extension ( libagora_face_capture_extension.so) and the Virtual Background extension (libagora_segmentation_extension.so). You can delete unnecessary extensions as needed to reduce the size of the app.
  • Android Studio v4.1 or above.

  • Android API level 16 or above.

  • An Android device running Android 4.1 or above with a functional front-facing camera and microphone.

Project setup

Before you start, download the Camera Movement extension and add it to the Video SDK.

Download the extension

  1. Download and unzip the Camera Movement package.

  2. Integrate the extension from the corresponding version folder according to the Video SDK version used in your app. For example, if your app uses version 4.2.6, integrate the extension from the ./sdk/4.2 directory.

    The libagora_portrait_rhythm_extension.so is the dynamic library of the extension, currently supporting the arm64-v8a and armeabi-v7a architectures.

Add extension to your app

According to your target development architecture, copy libagora_portrait_rhythm_extension.so to the dynamic library directory of the Video SDK located at /rtc/sdk/<target architecture>.

Implement the logic

This section explains how to integrate the Camera Movement extension into your project.

Register the extension

After initializing RtcEngine, call loadExtensionProvider to load the Camera Movement library, and then call registerExtension to register the extension.

Note

Load and register Camera Movement before calling enableVideo to enable the video module.


_6
// Load the dynamic library
_6
mRtcEngine.loadExtensionProvider("agora_portrait_rhythm_extension");
_6
// Register the extension
_6
mRtcEngine.registerExtension("agora_video_filters_portrait_rhythm", "portrait_rhythm", Constants.MediaSourceType.PRIMARY_CAMERA_SOURCE);
_6
// Enable the video module
_6
mRtcEngine.enableVideo();

Enable Camera Movement

Call startPreview to start the video preview, then call enableExtension to turn on or off the Camera Movement extension.


_2
// Turn on Camera Movement
_2
mRtcEngine.enableExtension("agora_video_filters_portrait_rhythm", "portrait_rhythm", true);

Set or switch camera movement effects

To set or switch the camera movement effect, call setExtensionProperty (Android) and pass in key and value to achieve effects such as heartbeat rhythm, portrait rhythm, and front and back camera movement. For details, see the key-value description.


_2
// Set to heartbeat rhythm effect
_2
mRtcEngine.setExtensionProperty("agora_video_filters_portrait_rhythm", "portrait_rhythm", "mode", "1");

Reference

This section contains content that completes the information in this page, or points you to documentation that explains other aspects to this product.

Key-value description

Refer to the table below and pass the corresponding key and value when calling setExtensionProperty to achieve the desired Camera Movement effect.

EffectKeyValueDescription
Heartbeatmode1The focus quickly increases and decreases, mimicking the rhythm of a heartbeat.
Portrait motionmode2The focal length slowly increases and then decreases, shaking at its smallest point with a shadow overlay.
Front-to-back camera movementmode3The focal length slowly increases and then decreases with a smooth but uneven zoom rate.
Up and down camera movementmode4The camera moves up and then down.
Left and right camera movementmode5The camera moves left first and then right.
Portrait lock Lmode6Locks the center of the face at a fixed point (2/5 of the upper middle part of the screen).
Portrait lock Pmode7Locks the center of the face on the central axis of the screen.
vundefined