tencent cloud

腾讯特效 SDK

动态与公告
产品动态
关于腾讯特效 SDK V3.5 版本更新公告
关于腾讯特效 SDK V3.0 版本相关接口及素材变更公告
产品简介
产品概述
产品功能
基本概念
产品优势
应用场景
购买指南
价格总览
购买流程
欠费退费说明
新手指引
Demo 体验
免费测试
License 指引
移动端 License 新增与续期
PC 端 License 新增与续期
Web端 License 新增与续期
常见问题
SDK 下载
功能说明
SDK 下载
版本历史
SDK 集成指引(无 UI)
通用集成腾讯特效
原子能力集成指引
SDK 集成指引(含 UI)
通用集成腾讯特效
直播 SDK 集成腾讯特效
TRTC SDK 集成腾讯特效
短视频 SDK 集成腾讯特效
Avatar 虚拟人集成指引
API 文档
iOS
Android
Flutter
Web
功能实践
SDK 包瘦身
SDK 集成问题排查
性能调优
效果调优
素材使用
美颜参数说明
美颜场景推荐参数
短视频企业版迁移指引
第三方推流接入美颜(Flutter)
小程序美颜特效实践
素材制作工具使用
Web 美颜特效
产品概述
快速上手
SDK 接入
API 文档
控制台指南
Demo 体验
内置素材总览
实践教程
常见问题
常见问题
通用类相关
技术类相关
License 相关
旧版文档
美颜场景推荐参数
美颜参数表
一分钟集成 TRTC
一分钟集成直播
TE SDK 政策
隐私协议
数据处理和安全协议
联系我们

Android

PDF
聚焦模式
字号
最后更新时间: 2023-06-01 09:52:59

功能说明

输入一张包含人脸的照片,输出人物面部特征信息,包括眼睛、眉毛、发型、肤色、性别、年龄等。该接口需要联网,SDK会把照片上传到Server端进行解析。

集成指引

首先需要集成腾讯特效SDK,具体请参见 独立集成腾讯特效

接口说明

XMagicApi.java
public void getFaceFeatureFromPhoto(Bitmap bitmap, FaceFeatureListener listener);
参数 bitmap:请尽量让人脸位于画面中间,建议画面中只包含一个人脸,如果有多个人脸,SDK会随机选择一个。建议照片的短边大于等于500px,尺寸过小会影响识别效果。
参数 FaceFeatureListener,返回识别的结果
public interface FaceFeatureListener {
void onError(int errCode, String msg);
void onFinish(FaceDetailAttributesInfo faceInfo);
}
onError 回调:解析失败时会回调此接口,错误码如下。
public static final int ERROR_NO_AUTH = 1;//没有权限
public static final int ERROR_RES_INVALID = 5;//传入的Avatar素材路径无效
public static final int ERROR_PHOTO_INVALID = 10;//读取照片失败
public static final int ERROR_NETWORK_REQUEST_FAILED = 20;//网络请求失败
public static final int ERROR_DATA_PARSE_FAILED = 30;//网络返回数据解析失败
public static final int ERROR_ANALYZE_FAILED = 40;//人脸分析失败
public static final int ERROR_AVATAR_SOURCE_DATA_EMPTY = 50;//加载Avatar源数据失败
onFinish 回调:解析成功时回调此接口,FaceDetailAttributesInfo 说明如下。
public static class FaceDetailAttributesInfo {
public int age; //[0,100]
public int emotion; //0:自然,1:高兴,2:惊讶,3:生气,4:悲伤,5:厌恶,6:害怕
public Eye eye; // 眼睛信息
public Eyebrow eyebrow; // 眉毛信息
public int gender; // 性别信息。-1:没识别,0:男性,1:女性。
public Hair hair; // 发型信息
public Hat hat; // 帽子信息
public int mask; // 是否有口罩 -1:没识别,0:无,1有。
public int moustache; // 胡子信息。-1:没识别,0:无胡子,1:有胡子。
public int nose; // 鼻子信息。-1:没识别,0:朝天鼻,1:鹰钩鼻,2:普通,3:圆鼻头。
public int shape; // 脸型信息。 -1:没识别,0:方脸,1:三角脸,2:鹅蛋脸,3:心形脸,4:圆脸。
public int skin; // 肤色信息。 -1:没识别,0:黄色皮肤,1:棕色皮肤,2:黑色皮肤,3:白色皮肤。
public int smile; //微笑程度,[0,100]。
}
public static class Eye {
public int eyelidType; // 识别是否双眼皮。-1:没识别,0:无,1:有。
public int eyeSize; // 眼睛大小。-1:没识别,0:小眼睛,1:普通眼睛,2:大眼睛。
public int glass; // 识别是否佩戴眼镜。-1:没识别,0:无眼镜,1:普通眼镜,2:墨镜
public int eyeOpen; // 识别眼睛的睁开、闭合状态。-1:没识别,0:睁开,1:闭眼
}
public static class Eyebrow {
public int eyebrowLength; //眉毛长短。0:短眉毛,1:长眉毛。
public int eyebrowDensity; //眉毛浓密。 0:淡眉,1:浓眉。
public int eyebrowCurve; // 眉毛弯曲。0:不弯,1:弯眉。
}
public static class Hair {
public int length; //头发长度信息。 0:光头,1:短发,2:中发,3:长发,4:绑发。
public int bang; //刘海信息。 0:无刘海,1:有刘海。
public int color; //头发颜色信息。0:黑色,1:金色,2:棕色,3:灰白色。
}
public static class Hat {
public int style; //帽子佩戴状态信息。0:不戴帽子,1:普通帽子,2:头盔,3:保安帽。
public int color; //帽子颜色.0:不戴帽子,1:红色系,2:黄色系,3:蓝色系,4:黑色系,5:灰白色系,6:混色系子。
}


帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈