共享文件管理

本文主要介绍如何管理要共享的文件。

上传文件

调用 ZegoSuperBoardManager 的上传文件方法上传文件到 ZEGO 文件云服务，上传成功后会获取该文件的 fileID，开发者可以调用 ZegoSuperBoardManager 的 createFileView 接口，传入 ZegoCreateFileConfig 加载该文件。

文件上传分为上传中，排队中，转换中，和转换成功等多个阶段。具体上传状态请查看 ZegoSuperBoardUploadFileState

• 上传阶段：如果正常上传，会产生多次回调，每次都包含文件上传进度。例如当前上传 50%，则 "infoMap" 内容为 {"uploadPercent":0.50}；当前上传 100%，则 "infoMap" 内容为 {"uploadPercent":1.00}。
• 格式转换阶段：如果转换成功，只产生一次回调，包含转换后的文件 ID。例如当前转换完成，则 "infoMap" 内容为 {"fileID":"ekxxxxxxxxv"}。

上传普通文件

调用 uploadFile 方法上传普通文件。

var file; // 待上传文件
if (!file) return alert('请先选择文件');
var zegoSuperBoard = ZegoSuperBoardManager.getInstance();
//上传文件后转码后渲染模式类型，如果用户涉及到 iOS、Web、Windows、Mac、小程序各端的业务，推荐使用 VectorAndIMG 模式。
zegoSuperBoard
    .uploadFile(file, renderType, function(infoMap) {

        // 上传中...
        if(infoMap.status === ZegoSuperBoardUploadFileState.UPLOADING){

        }
        // 排队中...
        if(infoMap.status === ZegoSuperBoardUploadFileState. WAITING){

        }
        // 转码中...
        if(infoMap.status === ZegoSuperBoardUploadFileState.CONVERTING){

        }
        // 转换成功
        if(infoMap.status === ZegoSuperBoardUploadFileState.CONVERTED){
            // 获得转码成功的文件 ID
            var fileID = infoMap.fileID;
        }

    })
    .then(function(fileID) {
        // 这里上传完成立即创建文件白板，开发者根据实际情况处理
    })
    .catch(function(error){
        // 上传失败
        console.log(error)
    });

上传 H5 文件

通过 ZegoSuperboardCustomH5Config 设置上传 H5 文件的配置参数，并调用 uploadH5File 方法上传 H5 文件。

var selectedH5File = null; // 当前选择的 H5 压缩包文件

var config = {
    width: 1600, // 自定义文件的宽
    height: 900, // 自定义文件的高
    pageCount: 7, // 自定义文件的页数
    // 自定义文件缩略图相对路径数组
    thumbnailList: ['thumbnail/1.png','thumbnail/2.png','thumbnail/3.png','thumbnail/4.png','thumbnail/5.png','thumbnail/6.png','thumbnail/7.png']
};
zegoSuperBoard
    .uploadH5File(selectedH5File, config, function(res) {
        // 上传进度
        console.log(res.uploadPercent + '%');
    })
    .then(function(fileID) {
        // 上传成功，得到 H5 文件 ID
        // 这里上传完成立即创建文件白板，开发者根据实际情况处理
    })
    .catch(function(error) {
        // 上传失败
        console.log(error)
    }); 

缓存文件

cacheFile 方法提前请求该文件中的资源。

var zegoSuperBoard = ZegoSuperBoardManager.getInstance()
zegoSuperBoard.cacheFile(fileID).then(function(res){
    // 回调中返回的参数：failedFileNum - 请求失败资源数，totalFileNum - 该文件预请求总资源数
}).catch(function(error){
    // 缓存失败
})