"TalkfunDocument.h"(文档相关方法)
#import <Foundation/Foundation.h>
@interface TalkfunDocument : NSObject
//根据courseID获取PPT文件列表
- (void)getDocumentListOfCourse:(NSString *)courseID callback:(void (^)(id result))callback;
//根据PPT课件ID获取相应课件信息
- (void)getDocument:(NSString *)courseWareID callback:(void (^)(id result))callback;
//根据PPT课件ID加载课件
- (void)loadDocument:(NSString *)courseWareID callback:(void (^)(id result))callback;
//提供courseID和文件(本地图片的asset(PHAsset或者ALAsset类型)的对象的集合 或 文件的地址) 上传图片或文档,返回上传结果
- (void)upload:(NSString *)courseID files:(NSArray *)files callback:(void (^)(id result))callback;
//轮询文件处理进度
- (void)processProgress:(NSString *)courseID callback:(void (^)(id result))callback;
//取消上传某个文档
- (void)cancelUpload:(NSString *)courseID filePath:(NSString *)filePath callback:(void (^)(id result))callback;
@end
根据courseID获取PPT文件列表的返回数据
- (void)getDocumentListOfCourse:(NSString *)courseID callback:(void (^)(id result))callback;
返回data格式数据:
字段 类型 描述 id string 文档ID name string 文档名 thumbnail string 封面缩略图地址
根据PPT课件ID获取相应课件的返回数据
- (void)getDocument:(NSString *)courseWareID callback:(void (^)(id result))callback;
返回data格式数据:
字段 类型 描述 id string 文档ID name string 文档名 url string 图片url前缀 thumbnail string 封面缩略图地址 pictures array page:页数,title:标题,urls:大图,thumbnailUrls:缩略图 size int 文档大小,单位为字节
图片上传和文档上传
- (void)upload:(NSString *)course_id files:(NSArray *)files callback:(void (^)(id result))callback;
- 提供courseID和文件(本地图片的asset(PHAsset或者ALAsset类型)的对象的集合 或 文件的地址) 上传图片或文档,返回上传结果
上传事件(广播)
- (上传进度)TALKFUN_NOTIFICATION_DOCUMENT_UPLOAD_PROGRESS
- (上传完成)TALKFUN_NOTIFICATION_DOCUMENT_UPLOAD_DONE
- (上传失败)TALKFUN_NOTIFICATION_DOCUMENT_UPLOAD_FAIL
轮询文件处理进度
- (void)processProgress:(NSString *)ID callback:(void (^)(id result))callback;
未上传过的文件,文件上传完毕返回的数据里面会有个文档的ID,要查看文件处理的进度就根据这个文件的ID查看进度。
返回responseObject里面的data格式数据:
字段 类型 描述 bid string 主播ID client_ip string 客户IP from string 上传方式 id string 文件ID location string 1代表在云服务器端 course_id string 绑定的课程ID(没有,为0) ext string 文件后缀名 filemd5 string 文件MD5 name string 文件名 partner_id string 合作方ID pid string 合作方ID sid string 存储服务器ID size string 文件大小 t string 文件上传的时间戳 type string 文件类型
//成功上传返回的数据:
{
code = 0;
responseObject = {
code = 0;
data = {
bid = 12526;
"client_ip" = "119.130.206.173";
"course_id" = 0;
ext = doc;
filemd5 = dad9e6ce43214270733d1fe37621a6e3;
from = 1;
id = 117038;
location = 1;
md5 = dad9e6ce43214270733d1fe37621a6e3;
name = "\U50bb\U903c\U5fc314";
"partner_id" = 20;
pid = 20;
sid = 2;
sign = 92c29898fc4e345f3db3f538299a404c;
size = 1575424;
t = 1488196597;
type = 2;
};
timestamp = 1488196606;
};
type = document;
}
返回document里面的数据:
字段 类型 描述 bid string 主播ID course_id string 绑定的课程ID(没有,为0) ext string 文件后缀名 filemd5 string 文件MD5 name string 文件名 origin string 图片地址 pages string 页数 partner_id string 合作方ID sid string 存储服务器ID size string 文件大小 thumb string 文件缩略图地址 type string 文件类型 url string 文件地址
已经上传过的文档返回的信息
{
code = "-10";
document = {
bid = 12526;
"course_id" = 0;
ext = doc;
from = 1;
id = 117038;
location = 1;
md5 = dad9e6ce43214270733d1fe37621a6e3;
name = "\U50bb\U903c\U5fc314";
origin = "";
pages = 2;
"partner_id" = 20;
sid = 2;
size = 1575424;
thumb = "https://lp2-4.talk-fun.com/doc/da/d9/e6/ce43214270733d1fe37621a6e3/thumb.jpg";
type = 2;
url = "https://lp2-4.talk-fun.com/doc/da/d9/e6/ce43214270733d1fe37621a6e3";
};
msg = "该文档已经上传过";
}
轮询文件处理进度
- (void)processProgress:(NSString *)ID callback:(void (^)(id result))callback;
- 取消上传某个文档