Home

金山云短视频解决方案

1. 集成说明

1.1 运行环境

• 支持环境：armv7a、x86、arm64
• 最小支持Android系统版本：Android 4.4(API 19)

1.2 工程配置-具体详情查看Readme文件

• 按照Readme中描述，通过Gradle引用相关的第三方库
• 按照Readme中描述，配置好AndroidMainfest文件
• 通过github下载相应的AAR或者通过jCenter依赖相应的aar

2. 功能集成流程

2.1 鉴权

1. 注册鉴权监听器

 /**
  *  通过KSVSShortVideoKitManager静态方法Add一个监听器，用于监听鉴权的成功与失败。
  *  注意： 在代码使用过程中，如果发现鉴权过期，也会回调鉴权失败的接口
  */
 KSVSShortVideoKitManager.addAuthorizeListener(Context, IKSVSShortVideoAuthListener);

2. 鉴权

 /**
  *  鉴权成功或者失败，都会通过IKSVSShortVideoAuthListener返回结果
  *  @param: SDKToken,在金山云短视频解决方案官网申请得到，具体申请流程查看readme文件
  *  @param: UserToken,解释查看readme文件，如果不使用二次鉴权，这个值可以为空，如果使用，请联系自己的服务器分发。
  */
  KSVSShortVideoKitManager.authorize(Context,SDKToken, UserToken);

3. 移除单一的监听器

 /**
  * 移除之前添加的无用监听器
  */
 KSVSShortVideoKitManager.removeAuthorizeListener(Context, IKSVSShortVideoAuthListener);

4. 清除所有的监听器

 /**
  * 清除所有的监听器
  */
 KSVSShortVideoKitManager.releaseAuthorize(Context);

教你如何优雅的使用鉴权

因为IKSVSShortVideoAuthListener的onFailed方法会在任何时候回调，所以必须保证有一个IKSVSShortVideoAuthListener不能被回收，
这样我们才能处理所有的失败消息。
1. 按照Demo上的试例，我们可以在Application中注册一个监听器，这个监听器在任何的时候都不去销毁。
2. 在需要鉴权的Activity中(一般是有登录功能的Activity里)，我们进行鉴权，这个时候可以在Add一个IKSVSShortVideoAuthListener，
在收到鉴权成功或者失败的消息是，直接remove掉这次添加的Listener。
3. 如果在正常的时候录制、播放、推荐等页面时出现鉴权过期。此时会回调Application中IKSVSShortVideoAuthListener接口，可以在失败
时弹出提示或者增加自己的处理逻辑

2.2 开启录制页和播放器

1. 开启录制页

 /**
  * 启动录制页，注意：录制页是一个Activity，请在AndroidMainfest文件中注册并且声明相关的Activity
  * @param String：当前用户的唯一标示。短视频解决方案不记录用户的详细信息，唯一需要用户的唯一标示。请保证您APP服务器下发的Uid
  * 是唯一的。
  * @param KSVSKitDataBuild: 常规参数配置，目前可以通过KSVSKitDataBuild配置录制的最小时间和最大时间
  */
  KSVSShortVideoKitManager.startRecording(Context, String,KSVSKitDataBuild.build());

2. 开启播放页

/**
  * 启动播放页，注意：播放页是一个Activity，请在AndroidMainfest文件中注册并且声明相关的Activity
  * @param MediaInfo：需要播放的MediaInfo对象，您可以自己new一个MediaInfo对象，但是要保证MediaInfo对象中ID和Url的正确
  * @param null: 暂时不需要，请直接传入空即可
  * @param String: 当前用户的唯一标示。短视频解决方案不记录用户的详细信息，唯一需要用户的唯一标示。请保证您APP服务器下发的Uid
  * 是唯一的。
  *
  * 用途： 一般用于播放已上传视频，所以对于这个方法需要MediaInfo信息，如果您想通过这个播放器播放其他的视频，那么只能自己去搞定
  * MediaInfo中的内容了
  */
   KSVSShortVideoKitManager.startPlayer(Activity,MediaInfo, null, String);

教你如何优雅的使用录制页

• 对于录制视频而言，为了保证录制视频的完整性，可观看性，必须要求APP有录音和摄像的权限。但是众所周知，在Android6.0以上，这些权限 需要动态申请，so：

1. 可以在调用startRecording方法之前动态申请权限，如果没有这些权限，那就不让用户进行录制
2. 因为录制页中有用户从本地导入视频等功能，so，请在申请权限时也加上对SD卡操作的权限。
3. 在启动前友好的申请权限，可以让用户更加喜爱您的APP。

2.3 已上传视频