产品 / 解决方案
平台 / 框架

文件上传或加载失败怎么处理?

产品 / 插件:文件共享

平台 / 框架:iOS / Android

更新时间:2021-11-18 16:02


问题描述

  1. 调用文件共享 SDK 上传文件接口,将目标文件上传后,收到转码失败的错误码及信息。
  2. 调用文件共享 SDK 加载文件接口,遇到加载失败(错误码为 ZegoDocsViewErrorServerFileNotExist,2030010)的情况。
  3. 调用文件共享 SDK 加载文件接口,遇到加载失败(错误码为 ZegoDocsViewErrorSizeInvalid,2030004)的情况。

问题原因

文件转码失败的原因

文件转码失败,可能有以下原因:

  • 源文件不可编辑。待转码的源文件必须是可编辑的,不⽀持对“只读”、“⼆进制加密”或设置了其它保护导致内容⽆法编辑的⽂件进⾏转码。
  • 用户的文件里包含的图片结构被破坏。用户在压缩文件里的图片的过程中导致图片受损,结构被破坏,此时图片虽然可以在电脑本地正常预览,但是在使用文件共享 SDK 进行文件上传时会失败。

加载文件失败(错误码 2030010)的原因

加载文件时返回的 2030010 错误码表示找不到服务器上的文件,可能有以下原因:

  • 传入的 fileID 错误,找不到对应文件。
  • 对应的文件已被删除。
  • 上传文件和加载文件时使用了不同的AppID,无法获取文件。

加载文件失败(错误码 2030004)的原因

加载文件时返回的 2030004 错误码表示没有获取到当前 ZegoDocsView 有效的宽度和高度,原因如下:

文件共享 SDK 在加载 ZegoDocsView 时,需要读取到该 View 的有效宽度和高度,以执行文件图片的切片工作。如果 SDK 加载时拿不到有效的宽度和高度,就会报错并抛出这个错误码。

解决方案

文件转码失败解决方案

  • 文件共享 SDK 不支持由 WPS 保存的文件,请确保您的文件是用 Microsoft Office 生成的。

  • 请确保您的文件时可编辑的:没有“只读”属性;没有经过加密;文件里包含的图片内容没有受损,可以在电脑中正常展示。

  • 如果您的文件类型是 图片 且在 Microsoft Office PPT 中导入正常,但无法转为 PDF,可通过如下步骤判断失败原因和处理:

    1. 使用图片处理工具判断图片是否被损坏:如使用 PS 工具导入该图片时,会报错 “IDAT: incorrect data check”,代表该图片已损坏;
    2. 通过 Microsoft Office PPT 对图片进行“另存为”操作,PPT 会对图片重新进行处理。此时将另存为的图片重新插入源文件,可正#常文件转码。

加载文件失败(错误码 2030010)解决方案

  • 确认传入的 fileID 是否是正确的,该文件上传成功后获取到的 fileID 和当前加载时的 fileID 必须保持一致。
  • 确认您是否调用过服务端 API https://docservice.zego.im/doc/del_file主动删除了已经上传到云端的文件。
  • 确认您在上传文件时使用的 AppID 是否与加载文件时使用的 AppID 一致,如果不一致,则无法访问到相应的文件。

加载文件失败(错误码 2030004)解决方案

方案一:

  • Android 因为 ZegoDocsView 获取宽高时,View 的绘制还未完成,此时存在时序问题。所以在 Android 中,一种常用的做法是以 Handler 为基础,调用 View.post() 将传入任务的执行时机调整到 View 绘制完成之后,从而能够确保获取到 View 有效的宽高。

    具体详细的使用方式可以在示例demo中参考。示例代码如下图所示:

        ZegoDocsView zegoDocsView = new ZegoDocsView(this);
        zegoDocsView.post(new Runnable() {
            @Override
            public void run() {
                zegoDocsView.loadFile("xxxxxx", "", new IZegoDocsViewLoadListener() {
                    @Override
                    public void onLoadFile(int errorCode) {
                        if (errorCode == 0) {
                            // 加载文件成功
                        } else {
                            // 加载文件失败
                        }
                    }
                });
            }
        });
  • iOS 在初始化的时候设置宽高,即可解决。

    ZegoDocsView * docsView = [[ZegoDocsView alloc] init];
    //设置一个非0的宽高
    [docsView setFrame:CGRectMake(0, 0, 1280, 720)];
    [docsView loadFileWithFileID:@"xxx" authKey:@"" completionBlock:^(ZegoDocsViewError errorCode) {
        if (errorCode == 0) {
                // 加载文件成功
        } else {
                // 加载文件失败
        }
    }];

方案二 :

在界面刚初始化时拿不到有效的宽度和高度,ZegoDocsView 提供了一个接口 setEstimatedSize 用于传入一个当前view的估计值,从而确保 loadFile 能够成功。

  • Android 示例代码

    ZegoDocsView zegoDocsView = new ZegoDocsView(this);
    zegoDocsView.setEstimatedSize(1280, 720);
    zegoDocsView.loadFile("xxx", "", new IZegoDocsViewLoadListener() {
        @Override
        public void onLoadFile(int errorCode) {
            if (errorCode == 0) {
                // 加载文件成功
            } else {
                // 加载文件失败
            }
        }
    });
  • iOS 示例代码

    ZegoDocsView * docsView = [[ZegoDocsView alloc] init];
    //不确定view的宽高的时候可以设置一个预估值
    [docsView setEstimatedSize:CGSizeMake(1280, 720)];
    [docsView loadFileWithFileID:@"xxx" authKey:@"" completionBlock:^(ZegoDocsViewError errorCode) {
        if (errorCode == 0) {
                // 加载文件成功
        } else {
                // 加载文件失败
        }
    }];

相关链接

本篇目录
下载 PDF