Android

1. Android release 包报错找不到某些方法,如何解决?

如果您在打 release 包时,启用了编译优化(把 minifyEnabled 设置为 true),会裁掉一些未在 java 层调用的代码,而这些代码有可能会被 native 层调用,从而引起 no xxx method 的异常。
如果您启用了这样的编译优化,那就要添加这些 keep 规则,防止 xmagic 的代码被裁掉:
-keep class com.tencent.xmagic.** { *;}
-keep class org.light.** { *;}
-keep class org.libpag.** { *;}
-keep class org.extra.** { *;}
-keep class com.gyailib.**{ *;}
-keep class com.tencent.cloud.iai.lib.** { *;}
-keep class com.tencent.beacon.** { *;}
-keep class com.tencent.qimei.** { *;}
-keep class androidx.exifinterface.** { *;}

2. Android SDK 集成到宿主工程报 gson 库冲突,如何解决?

在宿主工程 build.gradle 文件中添加如下代码:
Android{
configurations {
all*.exclude group: 'com.google.code.gson'
}
}

3. Android targetSdkVersion 为31或更高时,so 库没有加载成功?或者无法使用 GAN 类型特效(例如童话脸、童年泡泡糖等)?

Android targetSdkVersion 为31或更高版本时需要在 app 模块下找到 AndroidManifest.xml 文件,在 application 标签内加入如下标签:
<uses-native-library
android:name="libOpenCL.so"
android:required="false" />
//true 表示libOpenCL是当前app必需的。如果没有此库,系统将不允许app安装
//false 表示libOpenCL不是当前app必需的。无论有没有此库,都可以正常安装app。如果设备有此库,腾讯特效SDK里的GAN类型特效能正常生效(例如童话脸、国漫脸)。如果设备没有此库,GAN类型不会生效,但也不影响SDK内其他功能的使用。
//关于uses-native-library的说明,请参考Android 官网介绍:https://developer.android.com/guide/topics/manifest/uses-native-library-element
具体请参见 开发指引

4. 使用美颜时传递的纹理是横向纹理,如何解决?

可以使用 demo 中工具类TextureConverter.java 的convert 方法对纹理进行旋转,转换为竖屏,然后再传递给美颜 SDK。
/**
* 此方法用于对rgba纹理进行旋转和镜像处理。处理过程为:先顺时针旋转rotation度(可取值0,90,180,270),再进行左右翻转(flipHorizontal)和 上下翻转(flipVertical)。
* 使用场景:某些推流SDK返回的纹理是横屏纹理或者画面中人物朝向不对,而腾讯特效SDK要求纹理中的人物是正向的,所以可以通过此方法对纹理进行转换。
*
* @param srcID rgba纹理
* @param width 纹理宽度
* @param height 纹理高度
* @param rotation 需要进行旋转的角度。
* @return 旋转后的纹理,注意:如果旋转90或者270度,那么宽度需要进行交换。
*/
public int convert(int srcID, int width, int height, @RotationDegreesValue int rotation, boolean flipVertical, boolean flipHorizontal)

5. 使用美颜时传递的纹理是 oes 纹理,如何解决?

可以使用 demo 中工具类TextureConverter.java 的oes2Rgba 方法对纹理进行转换,转换为 RGBA 纹理,然后再传递给美颜 SDK。
/**
* 此方法用于将oes纹理转换为rgba纹理
*
* @param srcID oes 纹理
* @param width 纹理宽度
* @param height 纹理高度
* @return rgba纹理ID
*/
public int oes2Rgba(int srcID, int width, int height)

6. 如果想使用别的版本的 pag 如何解决?V3.5.0及以上支持

客户集成美颜 SDK 时:
如果是通过 Maven 集成,通过 implementation TencentEffect 就能引入 pag。如果您不想用 TencentEffect 依赖的 pag,可以通过 exclude 排除,然后在自己 app 的 build.gradle 中引入您需要的 pag 版本:
implementation ('com.tencent.mediacloud:TencentEffect_S1-04:版本号'){
exclude group: "com.tencent.tav", module: "libpag"
}
如果是下载美颜 SDK 的 aar 手动集成,在项目中依赖 TencentEffect.aar,这个 aar 是不带 pag 的,您还需要在 app 的 build.gradle 加一句 implementation pag 引入 pag 才能用:
implementation 'com.tencent.tav:libpag:4.3.33-noffavc'
如果您想动态下载 pag 的 so,请从 pag 官网 找到您需要的版本,下载 aar,将 .aar 重命名为 .zip,解压,剔除其中的 so,再把剩余文件压缩为 .zip,然后重命名为 .aar,最后引入这个不包含 so 的 pag aar,pag 的 so 则联网动态下载。