2024/04/29 14:14:15
使用摄像头律动插件
本文介绍如何在你的项目中集成和使用摄像头律动插件。
前提条件
在开始集成并使用律动插件前，请确保开发环境满足以下要求：
- 已集成 4.2.x 或 4.3.x 版本的实时互动 SDK，并确保你已在 App 中实现了基本的实时音视频功能，请参考实现音视频互动。
- Android Studio 4.1 以上版本。
- Android API 级别 16 或以上。
- Android 4.1 或以上版本的移动设备，且前置摄像头与麦克风功能正常。
集成摄像头律动插件
开始前，你需要下载摄像头律动插件并添加插件至实时互动 SDK 中。
下载插件
前往下载获取摄像头律动插件 SDK 包。
解压后，你需要根据 App 集成的实时互动 SDK 版本，从摄像头律动插件 SDK 包集成对应版本文件夹下的摄像头律动插件。例如 App 已集成 4.2.6 版本的实时互动 SDK，则需要集成 ./sdk/4.2 目录下的插件。
其中，libagora_portrait_rhythm_extension.so 即为律动插件动态库，目前支持 arm64-v8a 和 armeabi-v7a 两种架构。
添加插件至 App
根据你的目标开发架构，将 libagora_portrait_rhythm_extension.so 拷贝至实时互动 SDK 的动态库目录下，即 /rtc/sdk/<目标架构> 目录下。
注册插件
初始化 RtcEngine 后，调用 loadExtensionProvider 加载摄像头律动插件库，之后调用 registerExtension 注册摄像头律动插件。
注意
确保在调用 enableVideo 启用视频模块前加载并注册摄像头律动插件。
Java
// 加载律动动态库
mRtcEngine.loadExtensionProvider("agora_portrait_rhythm_extension");
// 注册律动插件
mRtcEngine.registerExtension("agora_video_filters_portrait_rhythm","portrait_rhythm",Constants.MediaSourceType.PRIMARY_CAMERA_SOURCE);
// 启用视频模块
mRtcEngine.enableVideo();
开启摄像头律动插件
确保在调用 startPreview 开启视频预览后，再调用 enableExtension 开关摄像头律动插件。
Java
// 开启摄像头律动
mRtcEngine.enableExtension("agora_video_filters_portrait_rhythm","portrait_rhythm", true);
设置或切换摄像头律动效果需要调用 setExtensionProperty 并传入不同的 key 和 value，实现心跳律动、人像律动、前后运镜等效果，详见 key-value 说明。
Java
// 设置为心跳律动效果
mRtcEngine.setExtensionProperty("agora_video_filters_portrait_rhythm","portrait_rhythm","mode","1");