答：建议按以下步骤排查下

• 请确认特效句柄初始化、授权是否成功

• 检查素材包与license是否配套，测试版和正式版不可混用

• 如果初始化成功，请检查设置的美颜素材路径对应的文件是否存在，注意指定素材需要到bundle下的子文件夹

  • 检测素材路径是否正确设置

答：建议按以下步骤排查下

• 请确认特效句柄初始化是否成功

• 如果初始化成功，请检查设置的形变素材路径对应的文件是否存在，注意指定素材需要到bundle下的子文件夹

• 瘦脸大眼算法依赖人脸检测模型，请检查人脸检测模型是否存在，并且在特效句柄初始化的时候，我们需要传入modelDir，这个目录下的目录结构和文件名称必须和Demo中我们resource.zip中的model目录一致。
  

• 如果设置的路径正确，请确保init接口传入的纹理的宽高正确

• 如果输入纹理的宽高正确，请检查process时传入的角度是否正确

public boolean process(
 	int srcTextureId, 
 	int dstTextureId, 
 	int width, int height,
 	BytedEffectConstants.Rotation rotation,
 	double timestamp)

因为Android相机默认输出的图像存在90度或270度逆时针旋转，同时需要兼顾手机自身的旋转角度，我们建议参考我们Demo中的做法，首先将相机输出的图像转正（转正是指使图像中的人脸为正，并且后置摄像头时候不存在左右镜像），然后使用手机的重力传感器方向作为我们算法检测的输入方向。

答：建议按以下步骤排查下

• 请确认特效句柄初始化是否成功
• 如果初始化成功，请检查设置的贴纸素材路径对应的文件是否存在
• 检查人脸检测模型和人手、人体检测模型文件是否存在，并且在特效句柄初始化的时候，我们需要传入modelDir，这个目录下的目录结构和文件名称必须和resource.zip保持一致。
• 确保授权文件有效并且和贴纸素材是匹配的，如果把我们的Demo中的测试素材和正式版授权文件组合使用，将出现贴纸不能正常工作的情况，可以检查EffectSDK标记的日志确认。

答：该问题和问题2可能原因相同，都是没有检测到人脸导致的，可以先按照问题3的排查步骤排查。

答：如果使用GPUImage框架，在processtexture之后增加如下两行代码

glEnableVertexAttribArray(0);
glEnableVertexAttribArray(1);

如果确认不是上述问题引起，可以按如下步骤排查

• 是否有正确的EAGL运行环境
• 输入纹理是否正确，通过xcode抓帧工具看纹理可以分析
• 输入纹理确认正确后，输出纹理是否有效果，这个也可以通过xcode抓帧工具看纹理可以分析
• 输出纹理的处理，这个可以将问题转换为UIimage，然后显示可以看到

答：GlSurfaceView是Android官方提供的封装了gl上下文的渲染方案，我们建议使用GlSurfaceView完成渲染。

答：ios相机默认输出的图像编码格式是BGRA，请注意通道的编码顺序。

答：这种情况有可能是输入图像和参数不正确，导致底层的人脸、手势等检测算法没能检测出人脸、人手，会出现瘦脸、大眼或者面具没有生效的情况，建议打印输入图像，检查输入参数。

答：直播场景中，为了符合人的视觉效果，主播侧和观众侧看到的图像是存在镜像关系的，如果使用带文字的贴纸，始终会有一端看到的文字有镜像的，解决的办法是不要在直播中使用带文字的贴纸。

答：请检查输入图像及输入角度，确保输入图经过该角度的顺时针旋转之后人脸是正的。

答：使用的Xcode版本过低，我们建议Xcode版本不低于11，请更新升级Xcode版本。该报错具体原因可查看：Undefine symbols __isPlatformVersionAtLeast

答：EffectSDK ERROR: Parser: cJson parse fail 出现这个报错一般是素材与license绑定的BundleID/ApplicationID不匹配（每套素材都会与其授权绑定，需配套使用），请检查使用的素材与授权是否配套。

答：出现上述日志，表示设置的素材路径可能不正确，SDK内部没有正确读到素材的配置文件，请检查素材路径是否正确。

V4.4.3版本之前

-keep class com.bytedance.labcv.effectsdk.** {*;}
-keep class com.bef.effectsdk.** {*;} 
-keep class com.bytedance.labcv.licenselibrary.** {*;}
-keep class com.amazing.** {*;}

V4.4.3版本及之后

-keep class com.effectsar.labcv.effectsdk.** {*;}
-keep class com.bef.effectsdk.** {*;} 
-keep class com.effectsar.labcv.licenselibrary.** {*;}
-keep class com.amazing.** {*;}

答：这种情况通常出现在iOS端。 可以查看BEEffectManager中的setUse3buffer或者use3buffer，如果出现不跟随的情况，需要在initTask()中将它的值置为false，关闭3buffer

答：这种现象往往和timeStamp有关，如果是序列帧特效，process方法中传入的timeStamp必须设置为如下的系统时间。 安卓端：传入的timeStamp可以设置为System.nanoTime()； iOS端：传入的timeStamp可以设置为[NSDate date].timeIntervalSince1970。