本文主要介绍短视频SDK在Android端的使用问题。

SDK集成

安卓指令集的兼容情况如何？

如果项目只接入armeabi，则需要将SDK包中的armeabi_v7a文件内的so文件拷贝到项目的armeabi文件夹内。

集成SDK后，Debug版本可以正常运行，但是Release版本启动就崩溃，该怎么解决？

问题现象：集成SDK后，Debug版本可以正常运行，但是Release版本启动就崩溃。

可能原因：混淆配置错误

解决方案：
  1. 先检查崩溃的log是否是报JNI找不到对应的Java类。
    • 如果是的话，一般来说就是混淆导致的，因为JNI调用Java类用的是反射，所以如果混淆把SDK内部与JNI有关的类混淆了，则JNI加载时将无法找到对应的Java类，就会加载失败。
    • 如果不是，则可以填写宜搭信息申请，获取阿里云技术支持。
  2. 把Demo中的混淆配置拷贝到开发者工程的混淆配置中。

如何添加硬编黑名单，硬解白名单？

  • 添加硬编码黑名单
    /**
* 添加硬编码黑名单，model和versions的顺序必须对应起来
* 黑名单内的机型将使用软编，黑名单外的机型都使用硬编
* @param models 机型Model信息列表{@link Build#MODEL}
* @param versions 系统版本号列表{@link Build.VERSION#SDK_INT}，如果不需要适配版本号，填写0即可
*/NativeAdaptiveUtil.encoderAdaptiveList(String[] models,int[] versions);
  • 添加硬解码白名单
    /**
* 添加硬解码器白名单，model和versions的顺序必须对应起来
* 如果开启硬解码了，则白名单中的机型将使用硬解码，白名单外的机型将使用软解码
* @param models 机型Model信息列表{@link Build#MODEL}
* @param versions 系统版本号列表{@link Build.VERSION#SDK_INT}，如果不需要适配版本号，填写0即可
* @see #setHWDecoderEnable(boolean)
*/
NativeAdaptiveUtil.decoderAdaptiveList(String[] models, int[] versions);

Android基础版本提示java.lang.NoSuchFieldError: No field height of type I in class Lcom/aliyun/snap/snap_core/R$id; or its superclasses (declaration of ‘com.aliyun.snap.snap_core.R$id’ appears in /data/app/com.rablive.jwrablive-2/base.apk:classes2.dex)，该如何解决？

问题现象：Android基础版本提示java.lang.NoSuchFieldError: No field height of type I in class Lcom/aliyun/snap/snap_core/R$id; or its superclasses (declaration of ‘com.aliyun.snap.snap_core.R$id’ appears in /data/app/com.rablive.jwrablive-2/base.apk:classes2.dex)。

可能原因：出现这个错误是因为在开发者的工程中存在和AAR（SDK）一样的xml，于是导致冲突。

解决方案：找到出现冲突的xml，开发者自行加前缀。目前发现容易冲突的xml包括：activity_setting.xml和activity_video_play.xml。

Android基础版提示java.lang.NoSuchFieldError: No static field notification_template_lines of type I in class Lcom/aliyun/snap/snap_core/R$layout; or its superclasses (declaration of ‘com.aliyun.snap.snap_core.R$layout’ appears/data/app/com.Aliyun.AliyunVideoSDK.VodSaaSDemo_android-1/base.apk) ，该如何解决？

目前主要原因是基础版SDK的UI不开源，所以内部是引用了support包的，但是打成AAR时是没有将support包打入的，这就导致ID不对应的情况。目前需要您将support版本包对应，如下：
//重要：如果工程中引入第三方库也引入了support包，也必须要保证第三方的包版本对应，建议以源码引入第三方库
compile 'com.android.support:appcompat-v7:24.2.1'
compile 'com.android.support:design:24.2.1'
但是有时第三方库带support包修改起来比较麻烦，且可能有些第三方包并不是源码引入的，此时建议在Application里面的gradle文件中配置。
configurations.all {
    resolutionStrategy {
        force 'com.android.support:appcompat-v7:24.2.1'
        force 'com.android.support:design:24.2.1'
    }
}

Demo使用时提示Please invoke the FileDownloader#init in Application#onCreate first，该怎么解决？

需要在Application OnCreate中调用DownloaderManager.getInstance().init(Context context);。

SDK内部是否有获取视频封面的接口？

Android短视频SDK目前专业版提供了AliyunIThumbnailFetcher接口，可以获取非关键帧的图片，其他版本建议使用系统函数取帧。

视频录制

录制如何添加普通动图？

添加普通动图需要使用AliyunIRecorder#addPaster(EffectPaster effectPaster,float sx,float sy,float sw,float sh,float rotation,boolean flip)接口，并且在EffectPaster对象中填入信息，EffectPaster的isTrack一定要设置为false，否则贴图将作为人脸贴图处理，跟随人脸变化，如果没有人脸，贴图会不显示。另外该接口必须在RecordCallback#OnInitReady()回调之后调用，否则将不会显示贴图。

如何设置录制角度？

目前设置录制角度有setRotation和setRecordRotation两个接口，setRotation接口是一个自适应接口，只要nin把手机角度传感器返回的角度值传给这个接口，就可以得到正确的录制角度和人脸角度。setRecordRotation接口是自定义的视频角度接口，可以根据您的需求定制任意角度值。

如何实现横屏录制？

  • 您如果需要默认横屏只需要将界面UI元素旋转引导横屏拍摄视频，不需要设置界面横屏，让界面固定竖屏即可。
    android:screenOrientation="portrait"
  • 横屏拍摄的视频录制完成合成的视频是会带旋转角度的，旋转角度以录制的第一段为准。
  • 如果是专业版，在编辑之后调用合成接口合成的视频将会输出一个不带角度的视频。比如原始视频为360/640，角度：270变为640 /*360，由于基础版和标准版只有录制功能，如果横屏拍摄会得到一个带旋转角度的视频，这个视频是以拍摄时第一段的角度为准的。专业版录制时的行为同基础版和标准版，合成完成后视频不带角度，转换为一个角度为0，宽高变换的视频。
关键接口函数：
/**
* 设置视频旋转角度值
* @param rotation
*/
void setRotation(int rotation);

接口调用条件：设置旋转角度需要在初始化完成之后设置，且需要保证录制第一段之前调用。

调用操作步骤：让界面固定竖屏，然后设置旋转角度即可。
  1. 设置界面竖屏，让界面的UI元素旋转，引导您拍摄横屏的视频。
  2. 同普通录制的初始化。
  3. 在调用开始录制前调用，注意旋转角度需要您自己获取，可以参考Demo使用OrientationDetector来获取方向。
    mRecorder.setRotation(int rotation);
  4. 继续录制步骤，注意每次调用startRecording前都需要设置旋转角度以此来确定每段视频的旋转角度。

拍摄添加背景音乐，完成后调用finishRecordForEditor，音乐没有合成进去，是什么原因？

添加背景音乐后，必须调用finishRecording接口，才会把音乐合成进去，否则不会合成进去，造成进到编辑界面无音乐的结果。finishRecording和finishRecordForEditor之间的区别如下：
  • finishRecording有两个作用，一是录制多段的时候，调用该接口可以将多段拼接成一个mp4，也就是录制指定的输出文件，二是添加了背景音乐后，调用该接口会把背景音乐合成进这个输出mp4中，无论是多段还是单段都可以。
  • finishRecordForEditor不会拼接多段视频，也不会将背景音乐合成到输出mp4文件中，而是仅仅将录制的片段（startRecording > stopRecording之后就会生成一个片段），按照指定的格式配置到project.json文件中（创建Editor时传入的Uri就是该文件的Uri）。
如果添加了背景音乐的录制多段，该如何进到编辑界面呢？

先调用finishRecording将视频拼接成输出地址的mp4，然后将该mp4用AliyunIImport接口导入到编辑界面。

录制界面添加普通动图显示效果不完整，该怎么解决？

需要获取普通动图素材的宽和高。
AliyunIRecorder#addPaster(EffectPaster effectPaster,float sx,float sy,float sw,float sh,float rotation,boolean flip)
其中sw和sh参数需要符合素材宽高和屏幕宽高的比列。

例如：素材的宽高分别为200、300，屏幕的宽高分别为540、720。则sw = (float)200/540, sh = (float)300/720。sx、sy是归一化的屏幕比例参数，坐标是以资源的中心点作为锚点的。

视频编辑

编辑时添加特效，使用AliyunICompose.compose合成出来的视频不带特效，是什么原因？

V3.5.0及以前的版本，要把编辑预览的特效持久化到本地的配置文件中，需要调用AliyunIEditor.onPause接口，如果没有调用，则特效配置不会持久化到本地文件中，那么通过AliyunICompose接口反序列化生成的Project就不带特效，也就导致合成出来的视频不带特效。

编辑时，调用applyMusic。添加音乐后，设置了startTime，为什么每次音乐流都从0开始播，而不是从startTime开始？

查看接口文档EffectBean类里对startTime的解释，startTime指的是特效在主流上的作用时间，并不是指素材流的起始时间，在V3.6.0版本之后增加了一个streamStartTime参数，这个参数是表示素材流的起始时间，即有这种需求的开发者，在V3.6.0及以后的版本中可以通过接口参数配置实现，但是V3.6.0之前的版本，只能由开发者先对素材流做裁剪，然后用裁剪的音乐去做背景音乐。

如下图所示：在播放到10s的时候，背景音乐开始播放，从音乐流的3s处播放，播放到10s处，重新从3s处开始播放，当第二遍播放到音乐流的6s时，刚好对应主流的20s位置，停止播放背景音乐。FAQ-android

如何添加gif作为主体流？

V3.7.0以下版本，gif格式的文件是作为图片类型导入；V3.7.0及以上版本，gif格式的文件如果作为视频类型导入，则当做视频播放gif所有帧，如果作为图片类型导入，则作为图片播放第一帧。

为什么设置完转场或者applySourceChange之后，视频卡住不动了？

需要您在进行这些操作之后调用mAliyunIEditor.play()接口。