Android

dependencies{
    ...
    implementation 'com.tencent.mediacloud:TencentEffect_S1-04:SDK版本号'
}

  //TEMenuActivity.java
  String resPath = new File(getFilesDir(), AppConfig.getInstance().getBeautyFileDirName()).getAbsolutePath();
  TEBeautyKit.setResPath(resPath);

//TEMenuActivity.java
private void copyRes() {
    if (!isNeedCopyRes()) {
        return;
    }
    new Thread(() -> {
        TEBeautyKit.copyRes(getApplicationContext());
    }).start();
}

//TECameraBaseActivity.java
TEBeautyKit.create(this.getApplicationContext(), beautyKit -> {
    mBeautyKit = beautyKit;
    initBeautyView(beautyKit);
});

public void initBeautyView(TEBeautyKit beautyKit){
    TEUIConfig.getInstance().setTEPanelViewRes("beauty_panel/S1_07/beauty.json", "beauty_panel/S1_07/beauty_body.json",
            "beauty_panel/S1_07/lut.json", "beauty_panel/S1_07/motions.json",
            "beauty_panel/S1_07/makeup.json", "beauty_panel/S1_07/segmentation.json");
    mTEPanelView = new TEPanelView(this);
    mTEPanelView.setTEPanelViewCallback(this);
    mTEPanelView.setupWithTEBeautyKit(beautyKit);
    mTEPanelView.showView(this);
    this.mPanelLayout.addView(mTEPanelView, new LinearLayout.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.WRAP_CONTENT));
}

//TECameraBaseActivity.java
@Override
public int onCustomProcessTexture(int textureId, int textureWidth, int textureHeight) {
    return mBeautyKit.process(textureId, textureWidth, textureHeight);
}

String json = mBeautyKit.exportInUseSDKParam();
if (json != null) {
    getSharedPreferences("demo_settings", Context.MODE_PRIVATE).edit().
      putString("current_beauty_params", json).commit();
}

//异步创建TEBeautyKit对象
public static void create(@NonNull Context context, @NonNull OnInitListener initListener)

//isEnableHighPerformance 是否开启高性能模式，
//高性能模式开启后，美颜占用的系统CPU/GPU资源更少，可减少手机的发热和卡顿现象，更适合低端机长时间使用。
//但请注意：开启高性能模式后，以下美颜项将不可用：
//1.眼部：眼宽、眼高、祛眼袋 
//2.眉毛：角度、距离、高度、长度、粗细、眉峰
//3.嘴部：微笑唇
//4.面部：瘦脸（自然，女神，英俊），收下颌，祛皱、祛法令纹。建议用“脸型”实现综合大眼瘦脸效果
public static void create(@NonNull Context context, boolean isEnableHighPerformance, @NonNull OnInitListener initListener)

//TEBeautyKit的构造方法，用于同步创建TEBeautyKit对象
public TEBeautyKit(Context context)

/**
 * @param context                 应用上下文
 * @param isEnableHighPerformance 是否开启高性能模式
 */
public TEBeautyKit(Context context, boolean isEnableHighPerformance)  

/**
 * 设置静音
 *
 * @param isMute true 表示静音
 */
public void setMute(boolean isMute)

/**
 * 如果是对图片进行美颜处理，需要调用此方法设置数据源的类型，分别为相机数据源和图片数据源：
 * 相机数据源：XmagicApi.PROCESS_TYPE_CAMERA_STREAM  图片数据源：XmagicApi.PROCESS_TYPE_PICTURE_DATA。
 * @param type 默认是视频流类型
 */
public void setBeautyStreamType(int type)

/**
 * 设置某个特性的开或关
 *
 * @param featureName 取值见 XmagicConstant.FeatureName
 * @param enable      true表示开启，false表示关闭
 */
public void setFeatureEnableDisable(String featureName, boolean enable)

/**
 * 对图片进行美颜处理
 *
 * @param bitmap
 * @param needReset
 * @return
 */
public Bitmap process(Bitmap bitmap, boolean needReset) 

/**
 * 处理 视频/摄像头 每一帧数据
 *
 * @param textureId 纹理id，此纹理需要的是纹理类型为GL_TEXTURE_2D，纹理像素格式为RGBA
 * @param width     纹理宽度
 * @param height    纹理高度
 * @return 处理后的纹理ID
 */
public int process(int textureId, int width, int height) 

/**
 * 更新美颜属性
 *
 * @param paramList
 */
public void setEffectList(List<TEUIProperty.TESDKParam> paramList) 

/**
 * 更新美颜属性
 *
 * @param teParam
 */
public void setEffect(TEUIProperty.TESDKParam teParam)

/**
 * 开启或关闭增强模式
 *
 * @param enableEnhancedMode true 表示开启增强模式  false 表示关闭增强模式
 * @return 返回true表示状态发生改变了，false 表示状态没有改变
 */
public boolean enableEnhancedMode(boolean enableEnhancedMode)

/**
 * 获取当前生效的美颜属性列表字符串。
 * 客户可以将导出的字符串进行本地保存，在下次创建TEPanelView对象后调用setLastParamList方法进行设置。
 * @return
 */
public String exportInUseSDKParam() 

/**
 * 用于恢复贴纸中的声音
 * 恢复陀螺仪传感器
 */
public void onResume() 

/**
 * 用于暂停贴纸中的声音
 * 暂停陀螺仪传感器
 */
public void onPause() 

/**
 * 销毁美颜
 * 注意：必须在gl线程调用此方法
 */
public void onDestroy() 

/**
 * 设置事件监听，用于监听 手机方向事件，用于adapter
 * @param listener 事件监听回调
 */
public void setEventListener(EventListener listener)

/**
 * 设置setAIDataListener 回调
 *
 * @param aiDataListener
 */
public void setAIDataListener(XmagicApi.XmagicAIDataListener aiDataListener)

/**
 * 设置动效提示语回调函数，用于将提示语展示到前端页面上。
 *
 * @param tipsListener
 */
public void setTipsListener(XmagicApi.XmagicTipsListener tipsListener)

/**
 * 截取当前纹理上的画面
 *
 * @param callback
 */
public void exportCurrentTexture(XmagicApi.ExportTextureCallback callback)

/**
 * 设置纹理逆时针旋转的度数。
 * 主要作用：用于SDK内部对纹理进行旋转，旋转对应角度之后，让人头朝上，这样SDK内部就可以识别人脸
 * 默认情况下SDK内部会使用sensor传感器获取需要旋转的角度
 *
 * @param orientation 取值只有0、90、180、270
 */
public void setImageOrientation(TEImageOrientation orientation)

/**
 * 检测当前设备是否支持此素材
 *
 * @param motionResPath 素材文件的路径
 * @return
 */
public boolean isDeviceSupport(String motionResPath)

/**
 * 获取美颜特效的开关状态
 *
 * @return EffectState
 */
public EffectState getEffectState()

/**
 * 设置是否开启美颜
 *
 * @param effectState ENABLED, 表示开启  DISABLED 表示关闭
 */
public void setEffectState(EffectState effectState) 

/**
 * 设置增强模式的策略实现类，如果不设置，则使用默认的实现
 *
 * @param teParamEnhancingStrategy 增强模式处理类
 */
public void setParamEnhancingStrategy(TEParamEnhancingStrategy teParamEnhancingStrategy) 



//静态方法如下

/**
 * 设置美颜资源存放的路径
 *
 * @param resPath
 */
public static void setResPath(String resPath)

/**
 * 从 apk 的 assets 解压资源文件到指定路径, 需要先设置路径: {@link #setResPath(String)} <br>
 * 首次安装 App, 或 App 升级后调用一次即可.
 * copy xmagic resource from assets to local path
 */
public static boolean copyRes(Context context)

/**
 * 进行美颜授权检验
 * 注意：在使用此方法时，如果不设置回调接口，将不进行鉴权（只会从网络下载鉴权信息），
 * 所以可以参考demo  在application中调用时不设置回调，但是在使用TEBeautyKit对象之前再次调用此方法（设置回调接口）鉴权
 * @param context                应用上下文
 * @param licenseKey             在平台申请的licenseKey
 * @param licenseUrl             在平台申请的licenseUrl
 * @param teLicenseCheckListener 鉴权回调接口
 */
public static void setTELicense(Context context, String licenseUrl, String licenseKey, TELicenseCheck.TELicenseCheckListener teLicenseCheckListener)

/**
 * 用于设置美颜上次效果的数据，目的是将美颜面板还原到上次的状态，
 * 注意：此方法需要在 {@link #showView(TEPanelViewCallback tePanelViewCallback)}} 方法之前使用
 *
 * @param lastParamList 美颜数据,可以通过 {@link TEBeautyKit#exportInUseSDKParam()} ()}}方法获取，然后存储，在下次启动美颜的时候传入此字符串即可
 */
void setLastParamList(String lastParamList);

/**
 * 展示美颜面板
 * @param tePanelViewCallback 面板事件回调接口
 */
void showView(TEPanelViewCallback tePanelViewCallback);


/**
 * 绑定TEBeautyKit对象，当用户点击item的时候，面板会直接调用TEBeautyKit的方法进行属性设置
 * @param beautyKit TEBeautyKit对象
 */
void setupWithTEBeautyKit(TEBeautyKit beautyKit);

/**
 * 设置选中 自定义分割或者绿幕的item ，因为绿幕或者自定义分割按钮在点击之后是跳转到相册，
 * 只有用户选择了图片或者视频之后才会选中，如果在这个过程中用户取消了操作就不能选中对应的item
 *
 * @param uiProperty
 */
void checkPanelViewItem(TEUIProperty uiProperty);

/**
 * 设置当前面板的UI配置
 * @param uiConfig
 */
void updateUIConfig(TEUIConfig uiConfig);