|
|
|
版本：3.3.1
|
|
|
|
版本：3.3.4
|
|
|
|
|
|
|
|
日期：2018-12-11
|
|
|
|
日期：2019-1-25
|
|
|
|
|
|
|
|
# 1.概述
|
|
|
|
iOS点播SDK是适用于iOS平台的云点播SDK。使用此SDK可以与CC视频云服务进行对接，在iOS端使用CC视频的点播功能。
|
| ... | ... | @@ -307,8 +307,21 @@ playerView.delegate =self;//设置代理 |
|
|
|
size = 42;
|
|
|
|
surroundColor = 0xFF6600;
|
|
|
|
url = "http://1.material.bokecc.com/material/1725A8A9604EAE30/3624.srt";
|
|
|
|
subtitleName = "中文";
|
|
|
|
sort = 1
|
|
|
|
};
|
|
|
|
|
|
|
|
subtitle2Dic = {
|
|
|
|
bottom = "0.23";
|
|
|
|
code = "utf-8";
|
|
|
|
color = 0x0000FF;
|
|
|
|
font = "Times New Roman";
|
|
|
|
size = 42;
|
|
|
|
surroundColor = 0xFF6600;
|
|
|
|
url = "http://1.material.bokecc.com/material/1725A8A9604EAE30/3624.srt";
|
|
|
|
subtitleName = "英文";
|
|
|
|
sort = 2
|
|
|
|
};
|
|
|
|
defaultSubtitle = 0
|
|
|
|
authvalidate = {
|
|
|
|
enable = 0;
|
|
|
|
freetime = 15;
|
| ... | ... | @@ -330,7 +343,9 @@ playerView.delegate =self;//设置代理 |
|
|
|
- vrmode （整数）1表示当前视频是VR视频 0表示当前视频是普通视频
|
|
|
|
- videomarks （打点数组） marktime为打点时间 markdesc打点描述
|
|
|
|
- questions(问答数组)showTime显示时间 jump能否跳过 content问题及选项(其中{图片URL}) backSecond回退时间 explainInfo解释 right是否正确
|
|
|
|
- subtitleDic(字幕字典信息) bottom离底部的距离比例 code编码格式 color颜色 font字体(如果没有改字体 则用默认字体) size字体大小 surroundColor背景色 url获取字幕的地址
|
|
|
|
- subtitleDic(字幕字典信息) bottom离底部的距离比例 code编码格式 color颜色 font字体(如果没有改字体 则用默认字体) size字体大小 surroundColor背景色 url获取字幕的地址 subtitleName字幕名称 sort双语中字幕对应的位置1:上, 2:下 只有一个字幕时sort=0
|
|
|
|
- subtitle2Dic 同subtitleDic
|
|
|
|
- defaultSubtitle字幕默认显示哪条，取值含义 0: subtitleDic, 1: subtitle2Dic, 2 双语 没有字幕信息该值为-1
|
|
|
|
- authvalidate(授权验证字典信息)无此功能的客户返回信息里没有该字段，只有开通了此项功能的客户的返回信息里才有该字段。enable:0代表授权验证不通过，1代表通过 freetime：试看时间 messaage：提示信息
|
|
|
|
|
|
|
|
注：视频数据里playurl与spareurl是两个不同的线路 可切换
|
| ... | ... | @@ -535,45 +550,50 @@ clickurl 跳转连接，返回结果为""代表没有跳转链接。string类 |
|
|
|
具体详情参见Demo。
|
|
|
|
```
|
|
|
|
### 4.1.16GIF功能
|
|
|
|
DWGIFManger可以将正在播放的视频做成GIF图，流程为：
|
|
|
|
1.初始化DWGIFManager对象，设置GIF录制相关的参数，
|
|
|
|
2.在开始录制之前调用associationWithUrl: CurrentPlayer: AndUseM3U8Method方法
|
|
|
|
3.然后调用startRecordingGif
|
|
|
|
4.结束调用endRecordingGif，并通过block回调生成的GIF路径
|
|
|
|
DWGIFManger开放的API如下：
|
|
|
|
DWGIFManger可以将正在播放的视频做成GIF图，流程为：需要先截取视频 ，再将截取的视频转成GIF图。DWGIFManger开放的API如下：
|
|
|
|
```
|
|
|
|
/**
|
|
|
|
|
|
|
|
* 关联播放器，startRecordingGif录制开始前调用 !!!在每次startRecordingGif前，都要调用此方法
|
|
|
|
|
|
|
|
* @param playUrl 播放路径
|
|
|
|
* @param currentPlayer 当前播放player
|
|
|
|
* @param m3u8Method 为YES，会强制使用m3u8视频格式截取GIF方式，一般设置为NO即可
|
|
|
|
|
|
|
|
*/
|
|
|
|
-(void)associationWithUrl:(NSURL *)playUrl CurrentPlayer:(AVPlayer *)currentPlayer AndUseM3U8Method:(BOOL)m3u8Method;
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
|
|
|
* 开始录制gif
|
|
|
|
|
|
|
|
*/
|
|
|
|
-(void)startRecordingGif;
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
|
|
|
* 结束录制gif 如果视频播放完成，内部会自动调用此方法，完成GIF回调
|
|
|
|
|
|
|
|
*/
|
|
|
|
-(void)endRecordingGif;
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
|
|
|
* 取消录制gif
|
|
|
|
|
|
|
|
*/
|
|
|
|
-(void)cancelRecordGif;
|
|
|
|
截取视频
|
|
|
|
@param videoUrl 视频的URL
|
|
|
|
@param outPath 输出路径
|
|
|
|
@param outputFileType 输出视频格式
|
|
|
|
@param videoRange 截取视频的范围
|
|
|
|
@param completeBlock 视频截取的回调
|
|
|
|
*/
|
|
|
|
- (void)interceptVideoAndVideoUrl:(NSURL *)videoUrl withOutPath:(NSString *)outPath outputFileType:(NSString *)outputFileType range:(NSRange)videoRange intercept:(InterceptBlock)interceptBlock;
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
@param mediaUrlStr URL字符串
|
|
|
|
@return 返回视频时长
|
|
|
|
*/
|
|
|
|
- (CGFloat)getMediaDurationWithMediaUrl:(NSString *)mediaUrlStr;
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
生成GIF图片
|
|
|
|
@param videoURL 视频的路径URL
|
|
|
|
@param loopCount 播放次数
|
|
|
|
@param time 每帧的时间间隔 默认0.25s
|
|
|
|
@param imagePath 存放GIF图片的文件路径
|
|
|
|
@param completeBlock 完成的回调
|
|
|
|
|
|
|
|
*/
|
|
|
|
- (void)createGIFfromURL:(NSURL*)videoURL loopCount:(int)loopCount delayTime:(CGFloat )time gifImagePath:(NSString *)imagePath complete:(CompleteBlock)completeBlock;
|
|
|
|
|
|
|
|
/**
|
|
|
|
生成GIF图片
|
|
|
|
@param videoURL 视频的路径URL
|
|
|
|
@param frameCount 视频的总时长乘以固定数值 如：视频总时长*4
|
|
|
|
@param time 每帧的时间间隔
|
|
|
|
@param loopCount 播放次数
|
|
|
|
@param imagePath 存放GIF图片的文件路径
|
|
|
|
@param completeBlock 完成的回调
|
|
|
|
*/
|
|
|
|
- (void)createGIFfromURL:(NSURL*)videoURL withFrameCount:(int)frameCount delayTime:(CGFloat )time loopCount:(int)loopCount gifImagePath:(NSString *)imagePath complete:(CompleteBlock)completeBlock;
|
|
|
|
|
|
|
|
注意：1.截取视频前需要用获取截取视频的URL，加密SDK调用drmGIFURL方法，非加密SDK调用unDrmGIFURL方法
|
|
|
|
2.在视频将要结束播放的时候做GIF功能时，要计算截取视频的实际时长以及在播放完成的代理方法中暂停该视频，否则可能出现bug
|
|
|
|
以上API使用详情参见demo。
|
|
|
|
```
|
|
|
|
### 4.1.17音频播放功能
|
| ... | ... | @@ -1061,7 +1081,6 @@ SDK提供了DWLog模块用来打印HTTP通信日志，可以在App的任意位 |
|
|
|
105 视频状态未知错误
|
|
|
|
130 创建AVPlayer 失败
|
|
|
|
131 未知播放错误
|
|
|
|
170 截取GIF时，未调用关联方法
|
|
|
|
300 xml解析失败
|
|
|
|
301 断电续传参数错误
|
|
|
|
302 用户剩余空间不足
|
| ... | ... | @@ -1080,4 +1099,4 @@ SDK提供了DWLog模块用来打印HTTP通信日志，可以在App的任意位 |
|
|
|
[https://github.com/CCVideo/VOD_iOS_DRM_SDK/tree/master/doc/api](https://github.com/CCVideo/VOD_iOS_DRM_SDK/tree/master/doc/api)
|
|
|
|
|
|
|
|
|
|
|
|
# 6.Q&A |
|
|
|
# 6.Q&A |
|
|
\ No newline at end of file |
