将下载好的 HTEffect.framework 库文件和 HTEffect.bundle 资源包放入您的项目文件夹中
在 Xcode > General 中添加动态库，确保嵌套设置中 Embed 属性设置为 Embed&Sign
在 Xcode > Build Settings 中搜索 bitcode ，将 Enable Bitcode 设置为 No
在 Xcode > Info 中添加 App Transport Security Settings > Allow Arbitrary Loads 并设置为 YES

3. 引用

在需要使用 SDK API 的项目文件中，添加模块引用

#import <HTEffect/HTEffectInterface.h>

(可选)HTUI可根据项目需求选用，将 HTUI 文件夹放入您的项目文件夹中，在需要使用 SDK API 的项目文件中，添加引用

#import "HTUIManager.h"

4. 使用

初始化

在您的 App 调用 HTEffect 相关功能之前（建议在 [AppDelegate application:didFinishLaunchingWithOptions:] 中）进行以下设置

/**
* 在线鉴权初始化方法
*/
[[HTEffect shareInstance] initHTEffect:@"YOUR_APP_ID" withDelegate:self];

/**
* 离线鉴权初始化方法
*/
// [[HTEffect shareInstance] initHTEffect:@"YOUR_APP_ID"];

(可选)如果您需要使用 HTUI，您可以在 viewDidLoad 方法中加入以下代码

[[HTUIManager shareManager] loadToWindowDelegate:self];
[self.view addSubview:[HTUIManager shareManager].defaultButton];

渲染

定义一个 BOOL 变量 isRenderInit 用来标志渲染器的初始化状态，根据获取到的视频格式，采用对应的方法进行渲染

/**
* 视频帧
*/
CVPixelBufferLockBaseAddress(pixelBuffer, 0);
unsigned char *buffer = (unsigned char *) CVPixelBufferGetBaseAddressOfPlane(pixelBuffer, 0);

if (!_isRenderInit) {
    [[HTEffect shareInstance] releaseBufferRenderer];
    _isRenderInit = [[HTEffect shareInstance] initBufferRenderer:format width:width height:height rotation:rotation isMirror:isMirror maxFaces:maxFaces];
}
[[HTEffect shareInstance] processBuffer:buffer];

CVPixelBufferUnlockBaseAddress(pixelBuffer, 0);

/**
* 纹理
*/
// if (!_isRenderInit) {
//     [[HTEffect shareInstance] releaseTextureRenderer];
//     _isRenderInit = [[HTEffect shareInstance] initTextureRenderer:width height:height rotation:rotation isMirror:isMirror maxFaces:maxFaces];
// }
// [[HTEffect shareInstance] processTexture:textureId];

销毁

结束渲染时，需根据视频格式，调用对应的释放方法，通常在 dealloc 方法中编写

/**
* 销毁纹理渲染资源
*/
[[HTEffect shareInstance] releaseTextureRenderer];

/**
* 销毁buffer渲染资源
*/
// [[HTEffect shareInstance] releaseBufferRenderer];

Android

1. 导入工程

将 HTEffect.aar 文件复制到 app 模块中的 libs 文件夹下，并在 app 模块的 build.gradle 文件的 dependencies 中，增加以下依赖

dependencies {
 implementation files('libs/HTEffect.aar')
}

将 jniLibs 文件夹中，对应 ABI 的 libHTEffect.so 文件复制到对应目录中
将 assets 资源文件复制到项目的对应目录中

2. 使用 HTUI (可选)

依赖我们的 htui 工程，使用我们提供的开源 UI 库，将 htui 文件夹复制到工程根目录下，在工程根目录的 settings.gradle 文件中，增加以下代码

include(":htui")

在 app 模块的 build.gradle 文件的 dependencies 中，增加以下代码

implementation project(':htui')

3. 集成开发

初始化

HTEffect 初始化函数程序中调用一次即可生效，建议您在 Application 创建时调用；如果渲染功能使用较少，也可以在使用时调用，接口如下

// 在线鉴权初始化方法
HTEffect.shareInstance().initHTEffect(context, "YOUR_APP_ID", new InitCallback() {
        @Override public void onInitSuccess() {}
        @Override public void onInitFailure() {}
});
// 离线鉴权初始化方法
//HTEffect.shareInstance().initHTEffect(context,"YOUR_APP_ID");

添加 HTUI (可选)

设置使用 htui 的 Activity 继承或间接继承 FragmentActivity，例如

public class CameraActivity extends FragmentActivity {
    //...
}

如果需要使用 htui，请调用 addContentView 实现界面的添加，代码如下

addContentView(
    new HTPanelLayout(this).init(getSupportFragmentManager()),
    new FrameLayout.LayoutParams(
        ViewGroup.LayoutParams.MATCH_PARENT,
        ViewGroup.LayoutParams.MATCH_PARENT)
);

渲染

定义布尔变量 isRenderInit 用来标志渲染方法是否初始化完成，然后根据得到的视频帧格式的不同，使用对应的方法进行渲染

/**
 * GL_TEXTURE_EXTERNAL_OES 纹理格式
*/
if (!isRenderInit) {
    isRenderInit = HTEffect.shareInstance().initTextureOESRenderer(width, height, rotation, isMirror, maxFaces);
}
int textureId = HTEffect.shareInstance().processTextureOES(textureOES);

/**
 * GL_TEXTURE_2D 纹理格式
*/
if (!isRenderInit) {
    isRenderInit = HTEffect.shareInstance().initTextureRenderer(width, height, rotation, isMirror, maxFaces);
}
int textureId = HTEffect.shareInstance().processTexture(texture2D);

/**
 * byte[] 视频帧
*/
if (!isRenderInit) {
    isRenderInit = HTEffect.shareInstance().initBufferRenderer(format,width, height, rotation, isMirror, maxFaces);
}
HTEffect.shareInstance().processBuffer(buffer);

销毁

结束渲染时，为防止内存泄漏的发生，需根据视频帧格式的不同，调用对应的 destroy 方法释放资源，通常在视频帧回调接口的销毁处，或者在 Activity、Fragment 的生命周期结束处，同时将定义的布尔变量 isRenderInit 设置为 false

/**
 * 使用其中一个
 */
HTEffect.shareInstance().releaseTextureOESRenderer();
HTEffect.shareInstance().releaseTextureRenderer();
HTEffect.shareInstance().releaseBufferRenderer();

/*
* 将 bool 置为 false
*/
isRenderInit = false;

示例代码

示例下载

联系与反馈

虹图AI开放平台是基于虹图自研的AI能力，打造的围绕音视频等应用场景的AI技术开放平台。提供人像人体特效、人体行为分析、内容审核、人脸实名认证、图像特效等视觉AI技术，加速AI为中小企业业务赋能。自成立至2022年底，虹图已经累计赋能直播、社交、教育、游戏电竞、IoT、XR、元宇宙等10余个行业赛道，服务平台近1500家，终端使用数量超过1.2亿台。

虹图探索了AI结合场景和生态的方法，围绕“AI产品+场景+生态合作”的方案模式，以音视频应用为切入场景，打造服务音视频应用全生命周期的AI产品矩阵，加以组合生态合作伙伴产品，实现平台的“开放”意义，为用户的业务需求提供整体解决方案，与用户实现价值共生。

HTEffect 3.2.1

HTEffect 3.2.1

HTEffect 3.2.1

虹图人像人体 SDK

简介

特色

效果展示

快速集成

iOS

1. 前提条件

2. 安装

3. 引用

4. 使用

Android

1. 导入工程

2. 使用 HTUI (可选)

3. 集成开发

示例代码

最近更新

联系与反馈

1. 官网地址: www.texeljoy.com

2. 商务合作: 400-178-9918

3. 邮箱地址: [email protected]

4. 公众号