文件共享
  • iOS : Objective-C
  • Android
  • macOS
  • Windows
  • Web
  • Electron
  • 概述
  • 价格说明
  • 下载
  • 下载示例源码
  • 接入指南
  • 快速开始
  • 场景实践
  • 进阶功能
  • 客户端 API
  • 服务端 API v2
  • 常见错误码
  • 常见问题
  • 文档中心
  • 文件共享
  • 常见错误码

常见错误码

更新时间:2022-12-29 15:42

错误码key 错误码值 错误码备注
ZegoDocsViewSuccess 0 执行成功。
公共错误码区间
ZegoDocsViewErrorInternal 2000001 内部错误,请联系 ZEGO 技术支持处理。
ZegoDocsViewErrorParamInvalid 2000002 参数错误,请查看控制台输出的具体信息。
ZegoDocsViewErrorNetworkTimeout 2000003 网络超时,请检查网络或稍后重试。
ZegoDocsViewErrorRequestFailure 2000004 请求失败,请检查网络或联系 ZEGO 技术支持。
文件上传错误码
ZegoDocsViewErrorFileNotExist 2010001

找不到对应的本地文件,可能的原因包括:

  • 上传时访问了错误的文件路径。
  • 本地文件已被删除。
ZegoDocsViewErrorUploadFailed 2010002 上传失败。
ZegoDocsViewErrorUnsupportRenderType 2010003 不支持渲染模式。
格式转换错误码
ZegoDocsViewErrorFileEncrypt 2020001

需要转码的文件被加密,可能的原因包括:

  • Word 文件访问需要密码。
  • Excel 文件访问需要密码。
  • PPT 文件访问需要密码。
ZegoDocsViewErrorFileSizeLimit 2020002

文件内容过大,可能的原因包括:

  • Excel 文件大小超过 10 MB。
  • Excel 文件打开时间过久。
  • 文本文件大小超过 2 MB。
  • 其他文件大小超过 100 MB。
ZegoDocsViewErrorFileSheetLimit 2020003

文件页数过多,可能的原因包括:

  • Excel 文件 sheet 数量超过 20。
  • Word 文件页数超过 500。
  • PPT 文件页数超过 500。
ZegoDocsViewErrorConvertFail 2020004 格式转换失败。
ZegoDocsViewErrorConvertCancel 2020005 格式转换被取消。
ZegoDocsViewErrorFileContentEmpty 2020006

文件内容为空,可能的原因包括:

  • PDF 文件内无内容。
  • PPT 文件内没有幻灯片。
  • Excel 文件内无内容。
  • Word 文件内无内容。
ZegoDocsViewErrorFileReadOnly 2020007

文件为只读模式,可能的原因包括:

  • 动态 PPT 文件被设置为只读模式,会导致转码失败。
  • 动态 PPT 文件中包含转码服务器不支持的字体,会导致转码失败。
ZegoDocsViewErrorConvertElementNotSupported 2020008 源文件中存在不支持转码的元素。
ZegoDocsViewErrorConvertFileTypeInvalid 2020009 文件后缀名不符合 ZEGO 定义的文件规范。
ZegoDocsViewErrorConvertFileUnsafe 2020010 源文件中存在安全隐患,无法正常打开。
ZegoDocsViewErrorConvertElementNotExported 2020011 转码结束后存在图片、音视频文件未正常导出。
SDK 接口调用
ZegoDocsViewErrorAuthParamInvalid 2030001

认证参数错误。

可能原因1:Token 不正确。

  • 处理建议:请检查传入的 Token 是否正确,是否能正常使用。

可能原因2:文件共享服务未开通。

  • 处理建议:请联系 ZEGO 技术支持开通文件共享服务。
ZegoDocsViewErrorFilePathNotAccess 2030002

路径权限不足,可能的原因包括:

  • 初始化时传入的 log 目录不可用。
  • 初始化时传入的 cache 目录不可用。
  • 初始化时传入的 data 目录不可用。
ZegoDocsViewErrorInitFailed 2030003 初始化失败。
ZegoDocsViewErrorSizeInvalid 2030004 请在加载文件之前,确保能够读取当前 ZegoDocsView 的有效宽度和高度。
ZegoDocsViewErrorFreeSpaceLimit 2030005 本地空间不足。
ZegoDocsViewErrorUploadNotSupported 2030006 不支持文件上传功能。
ZegoDocsViewErrorUploadDuplicated 2030007 正在上传相同文件。
ZegoDocsViewErrorEmptyDomain 2030008 空域名。
ZegoDocsViewErrorHaveInit 2030009 已初始化。
ZegoDocsViewErrorServerFileNotExist 2030010

找不到对应的转码后文件,可能的原因包括:

  • 访问文件时传入了错误的 fileID,比如该文件上传时和当前访问时使用了不同的 AppID。
  • 对应的转码后文件已经被删除。
  • 文件的上传环境和文件的访问环境不一致。
ZegoDocsViewErrorLogFolderNotAccess 2030011 初始化时设置的日志目录无法创建或写入。
ZegoDocsViewErrorCacheFolderNotAccess 2030012 初始化时设置的缓存目录无法创建或写入。
ZegoDocsViewErrorDataFolderNotAccess 2030013 初始化时设置的数据目录无法创建或写入。
ZegoDocsViewErrorCacheNotSupported 2030014

不支持预加载该文件,请联系 ZEGO 技术支持,可能的原因包括:

  • 当前 AppID 未开通该服务。
  • 该文件暂不支持预加载。
ZegoDocsViewErrorCacheFailed 2030015

预加载失败,可能的原因包括:网络故障导致预加载失败。

ZegoDocsViewErrorZipFileInvalid 2030016

无效的 ZIP 文件,可能的原因包括:

  • 不是合法的 ZIP 文件。
  • 文件损坏。
ZegoDocsViewErrorH5FileInvalid 2030017

无效的 H5 文件,不符合 ZEGO 定义的 H5 文件规范,可能的原因包括:文件中没有 index.html。

ZegoDocsViewErrorFileCorruption 2030018

文件已经损坏,可能的原因包括:文件内容异常。

ZegoDocsViewErrorFileContentIncomplete 2030019

文件内容不完整,可能的原因包括:EOF 错误(文件内容不完整)。

ZegoDocsViewErrorGetContextFail 2030021 可能的原因包括:
  • 在部分 iOS 移动设备上渲染文件个数过多导致绘制 canvas 内存超出限制。
  • 在部分 iOS 移动设备渲染的静态文件页数过多,绘制 canvas 过超出内存限制。
处理建议:
  • 收到该错误码时进行刷新操作,SDK 内部会将其余非激活状态的文件卸载,释放内存。
  • 建议拆分文件,重新上传共享文件。
ZegoDocsViewErrorSwitchSpeakerFail 2030023 切换扬声器失败,可能的原因包括:
  • 使用的浏览器不支持 getUserMedia、enumerateDevices、setSinkId 等接口。
  • 文件不是动态文件。
处理建议:
  • 更换浏览器,如 Google Chrome 浏览器。
  • 使用动态文件。
H5 桥接层错误码
ZegoBridgeErrorNotReady 10001 H5 没有调用 getReady 会出现。
ZegoBridgeErrorParamInvalid 10002 参数错误,H5 调用脚本接口参数不符合要求时出现。
ZegoBridgeErrorRecordListLimit 10003 recordList 字节长度超过限制,H5 调用操作相关接口导致当前页的 recordList 超出最大长度限制(base64 后最大为 948 字节)。
ZegoBridgeErrorH5 10006 H5 内部代码执行出错。
本篇目录