Android

阿里云RTC SDK在1.17.9及以上版本中提供了基础美颜功能，包含了美白和磨皮两种功能。您可以在直播、视频通话、视频会议等场景中，通过美颜功能提高使用体验。

阿里云RTC SDK在1.14.0及以上版本中提供了支持第三方美颜功能，通常第三方美颜SDK接受以下两种类型的数据回调处理：

• YUV裸数据用于做人脸识别。
• openGL纹理数据用于最终做美颜效果的处理。

为了避免集成SDK后，自己能看到美颜效果，对方却看不到美颜效果。在接入前，我们需要在SDK的实例extra字段中添加开关，设置user_specified_video_preprocess为TRUE。

1. SDK的instance构造函数里面，扩展字段添加jsonObject.addProperty("user_specified_video_preprocess", "TRUE")，并且将jsonObject转化成string后传入到AliRtcEngine.getInstance的第二个字段extra里面。
2. 在调用本地预览开启接口startPreview之后，调用RegisterTexturePreObserver订阅openGL纹理数据。
   说明 通常是对本地用户进行美颜，callid填写为双引号（""）字符串即可。
3. 如果需要对接YUV数据人脸识别功能，在调用本地预览开启接口startPreview之后，再调用RegisterPreprocessVideoObserver订阅采集前处理YUV数据（通常是对采集图像做人脸识别）。
4. 如果需要对接YUV数据人脸识别功能，在AliDetectObserver的onData回调中做第三方算法的人脸识别操作，返回的long为人脸识别之后的该图像的人脸结构体指针。
5. 在传入observer函数回调onTextureCreate中第三方算法的初始化工作，其中context为openGL的上下文。
6. 在传入observer函数回调onTexture做第三方算法的每一帧美颜处理工作，如果不需要美颜或者第三方算法处理不成功，请将输入的textureId返回给该函数。如果美颜处理成功，则返回第三方算法处理过的textureId。
7. 在传入observer函数回调onTextureDestroy做第三方算法的销毁工作。

RTC SDK YUV裸数据人脸识别接入接口，人脸识别接入时，需要订阅采集之后的前处理buffer数据，所以在startPreview之后需要调用RegisterPreprocessVideoObserver接口获取采集前处理数据并处理。

///@brief register preprocess observer 
///@param observer 回调接口
void RegisterPreprocessVideoObserver(AliDetectObserver observer);

订阅成功后，将会回调AliDetectObserver的onData参数。

///@brief 采集前处理回调接口
///@param dataFrameY Y分量指针
///@param dataFrameU U分量指针
///@param dataFrameV V分量指针，NV12和NV21该指针为null
///@param format， 图像数据格式，Android输出的YUV数据格式为NV21
///@param width， 图像宽度
///@param height， 图像高度
///@param strideY， 图像Y分量stride
///@param strideU， 图像U分量stride
///@param strideV， 图像V分量stride
///@param rotate， 图像旋转角度
///@param extraData，附加字段（非定制化可忽略）
///@return 人脸识别结构体指针（第三方定义结构体），SDK只做传递 （该返回值传递人脸数据）
long onData(long dataFrameY, long dataFrameU, long dataFrameV, AliRTCImageFormat format, int width, int height, int strideY, int strideU, int strideV, int rotate, long extraData);