4.开发指南.md

@@ -47,14 +47,19 @@ DWVodVideoModel类是SDK中媒体的数据模型，无论是播放、下载都
 //字幕
 ///取值含义 -1 无字幕 ，0:subtitle, 1:subtitle2, 2:双语
 @property (nonatomic, assign, readonly) NSInteger defaultSubtitle;
+
 ///字幕1
 @property (nonatomic, strong, readonly) DWVideoSubtitleModel * subtitle;
+
 ///字幕2
 @property (nonatomic, strong, readonly) DWVideoSubtitleModel * subtitle2;
 
-//访客信息收集
+///访客信息收集
 @property (nonatomic, strong, readonly) DWVideoVisitorModel * visitor;
 
+///课堂练习
+@property (nonatomic, strong, readonly) NSArray <DWVideoExercisesModel *> * exercises;
+
 @property (nonatomic, assign, readonly)int reason;
 
 @property (nonatomic, strong, readonly)NSDate * responseTime;
@@ -134,6 +139,13 @@ DWPlayerView包含的属性及方法如下：
  */
 @property(nonatomic,assign)DWPlayerViewLoadStyle loadStyle;
 
+/**
+ 期待缓冲时长 默认 0，建议取值1 ~ 50 。
+ 注意：此属性仅针对iOS10以上系统， m3u8格式视频有效。
+ */
+
+@property(nonatomic,assign)NSTimeInterval forwardBufferDuration;
+
 /**
  是否是备用线路
  */
@@ -340,6 +352,17 @@ DWPlayerView包含的属性及方法如下：
  */
 -(void)reportVisitorCollectWithVisitorId:(NSString *)visitorId VideoId:(NSString *)videoId UserId:(NSString *)userId AndMessage:(NSString *)message;
 
+/**
+ 课堂练习统计上报 有此需求的客户调用
+ 
+ @param exercisesId 课堂练习ID 必填
+ @param videoId 视频ID 必填
+ @param userId CC账号ID  必填
+ @param questionMes 上报信息 必填 具体格式详见demo
+ @param completion  完成回调，返回课堂练习结果
+ */
+-(void)reportExercisesWithExercisesId:(NSString *)exercisesId videoId:(NSString *)videoId UserId:(NSString *)userId QuestionMes:(NSString *)questionMes AndCompletion:(void (^)(NSArray * resultArray,NSError * error))completion;
+
 ```
 
 ### 1.2.3 DWPlayerViewDelegate的使用
@@ -851,6 +874,75 @@ DWVideoVisitorMessageModel数据及含义如下：
 @property (nonatomic, strong, readonly)NSString * visitorTip;
 ```
 
+## 1.12 课堂练习
+课堂练习数据为DWVodVideoModel对象的exercises。
+
+DWVideoExercisesModel数据及含义如下：
+```
+///课堂练习id
+@property (nonatomic, strong, readonly)NSString * exercisesId;
+
+///标题
+@property (nonatomic, strong, readonly)NSString * title;
+
+///展现的时间,单位:秒
+@property (nonatomic, assign, readonly)NSInteger showTime;
+
+///课堂练习包含的问题列表
+@property (nonatomic, strong, readonly)NSArray <DWVideoExercisesQuestionModel *> * questions;
+
+///是否显示课堂练习
+@property (nonatomic, assign) BOOL isShow;
+```
+
+DWVideoExercisesQuestionModel数据及含义如下：
+```
+///问题id
+@property (nonatomic, strong, readonly)NSString * questionId;
+
+///问题解释内容
+@property (nonatomic, strong, readonly)NSString * explainInfo;
+
+///问题类型 0:单选 1:多选 2:填空
+@property (nonatomic, assign, readonly)NSInteger type;
+
+///问题的标题 (填空题的前半段)
+@property (nonatomic, strong, readonly)NSString * content;
+
+///问题的标题 (填空题后半段，选择题是为nil)
+@property (nonatomic, strong, readonly)NSString * content2;
+
+///问题的答案
+@property (nonatomic, strong, readonly)NSArray <DWVideoExercisesQuestionAnswerModel *> * answers;
+
+///此问题是否已经作答 YES:已答 NO:未答  注意：选择题，选项选中即为已答。填空题，内容填写即为已答。
+@property (nonatomic, assign, readonly)BOOL isReply;
+
+///是否答对
+@property (nonatomic, assign, readonly)BOOL isCorrect;
+
+///问题正确率
+@property (nonatomic, assign) NSInteger accuracy;
+```
+
+DWVideoExercisesQuestionAnswerModel数据及含义如下：
+```
+///课堂练习问题答案id
+@property (nonatomic, strong, readonly)NSString * answerId;
+
+///是否是正确选项
+@property (nonatomic, assign, readonly)BOOL isRight;
+
+///选择题：选项的内容  填空题：正确答案
+@property (nonatomic, strong, readonly)NSString * content;
+
+///选择题是否选中
+@property (nonatomic, assign) BOOL isSelect;
+
+///填空题填写内容
+@property (nonatomic, strong) NSString * answerContent;
+```
+
 # 2.下载功能
 
 ## 2.1 下载功能的快速集成，请详见2.集成指南
@@ -1368,6 +1460,7 @@ ERROR_QUALITY_NOTEXIST|2002|未查找到清晰度
 ERROR_LOCAL_UNAVAILABLE|2003|本地资源不可用
 ERROR_PLAYURL_UNAVAILABLE|2010|播放地址不可用/不存在
 ERROR_GIF_UNASSOCIATION|2100|GIF未关联播放器
+ERROR_EXRCISES_REQUEST|2302|课堂练习上报失败
 ERROR_DOWNLOAD_UNAVAILABLE|3000|网络资源不存在
 ERROR_DOWNLOAD_UNAUTHORIZED|3001|未获得下载授权
 ERROR_DOWNLOAD_UNSUPPORTM3U8|3002|暂不支持m3u8视频格式下载