在制作短视频时，用户会有各种各样的美化需求，比如想给视频人物更换头发颜色，怎样轻松实现呢？华为视频编辑服务（Video Editor Kit）一键染发功能，集成就可让应用拥有头发换色能力。用户利用预置的多种发色样式，点击即可拥有多变新发色，体验超自然发色效果，满足用户个性化美化需求，让视频变得更多彩、有趣。
![]()
功能介绍
-
支持图片和视频资源，一键染发能力可实时处理图片和视频素材。
-
支持多人同时染发。一键染发能力可对图片/视频内多人产生发色效果。
-
可调整作用强度，用户根据场景自由调节发色深浅。
集成代码
1 开发准备
详细准备步骤可参考华为开发者联盟官网：
https://developer.huawei.com/consumer/cn/doc/development/Media-Guides/config-agc-0000001101108580
2 编辑工程集成
2.1 设置应用的鉴权信息
可以通过api_key或者Access Token来设置应用鉴权信息。
- 通过setAccessToken方法设置Access Token，在应用启动时初始化设置一次即可，无需多次设置。
MediaApplication.getInstance().setAccessToken("your access token");
- 通过setApiKey方法设置api_key，在应用启动时初始化设置一次即可，无需多次设置。
MediaApplication.getInstance().setApiKey("your ApiKey");
2.2设置唯一标识ID，即License ID。
License ID是进行管控的有效凭证，您要保证设置License ID的唯一性。
MediaApplication.getInstance().setLicenseId("License ID");
2.2.1初始化Editor运行环境
创建编辑工程，需要首先创建Editor对象并初始化其运行环境。当离开编辑工程时，应释放Editor实例。
(1) 创建Editor对象
HuaweiVideoEditor editor = HuaweiVideoEditor.create(getApplicationContext());
(2) 指定预览窗口的布局位置
预览窗口负责视频图像画面的渲染，由视频编辑原子能力SDK内部创建SurfaceView来实现。在创建窗口之前，需要在您的App中指定预览窗口的布局位置。
<LinearLayout
android:id="@+id/video_content_layout"
android:layout_width="0dp"
android:layout_height="0dp"
android:background="@color/video_edit_main_bg_color"
android:gravity="center"
android:orientation="vertical" />
// 指定预览窗口
LinearLayout mSdkPreviewContainer = view.findViewById(R.id.video_content_layout);
// 设置预览窗口承载的布局
editor.setDisplay(mSdkPreviewContainer);
(3) 初始化运行环境，如果License鉴权失败，会抛出LicenseException。
当Editor对象创建之后，此时还没有占用实际的系统资源，需要手动选择其环境初始化的时机，此时视频编辑原子能力SDK内部会创建必须的线程和定时器等。
try {
editor.initEnvironment();
} catch (LicenseException error) {
SmartLog.e(TAG, "initEnvironment failed: " + error.getErrorMsg());
finish();
return;
}
2.2.2添加视频、图片
创建一条视频泳道，然后往泳道上添加图片或者视频素材。图片和视频素材需要通过文件路径添加到泳道上。
// 获取时间线对象
HVETimeLine timeline = editor.getTimeLine();
// 创建视频泳道
HVEVideoLane videoLane = timeline.appendVideoLane();
// 在视频泳道的末尾，添加视频资源
HVEVideoAsset videoAsset = vidoeLane.appendVideoAsset("test.mp4");
// 在视频泳道的末尾，添加图片资源
HVEImageAsset imageAsset = vidoeLane.appendImageAsset("test.jpg");
3 一键染发集成
// 一键染发AI算法初始化
asset.initHairDyeingEngine(new HVEAIInitialCallback() {
@Override
public void onProgress(int progress) {
// 初始化进度
}
@Override
public void onSuccess() {
// 初始化成功
}
@Override
public void onError(int errorCode, String errorMessage) {
// 初始化失败
}
});
// 添加一键染发特效，指定一键染发的色卡和默认强度。
asset.addHairDyeingEffect(new HVEAIProcessCallback() {
@Override
public void onProgress(int progress) {
// 一键染发处理进度。
}
@Override
public void onSuccess() {
// 一键染发处理成功
}
@Override
public void onError(int errorCode, String errorMessage) {
// 一键染发处理失败
}
}, colorPath, defaultStrength);
// 移除一键染发特效
asset.removeHairDyeingEffect();
Demo演示
![]()
- 集成开发过程中，您有任何问题都可以在线提单，将有专人解答。
了解更多详情>>
访问华为开发者联盟官网
获取开发指导文档
华为移动服务开源仓库地址：GitHub、Gitee
关注我们，第一时间了解 HMS Core 最新技术资讯~
