跳到主要内容

画布文件上传限制

更新时间 2025/02/27 01:22:46

画布内文件上传限制包括单个文件上传大小限制和文件总存储限制，当超出对应限制后会被 SDK 拒绝。

单个文件上传大小限制​

Web SDK 支持设置单个文件的最大上传大小，通过设置 uploadConfig.uploadSizeLimit 来设置单个文件最大上传大小。

uploadConfig?: {
  uploadSizeLimit?: number;
};

注：单个文件最大上传大小默认为 60M，单位为 B 。

即，当通过画布上传的本地文件超出文件的最大上传大小时，上传行为会被 SDK 拒绝，并提示错误原因。

文件总存储限制​

单一应用下的文件总存储存在限制，当应用下的文件大小总存储达到限额时，后续的上传行为会被 SDK 拒绝。

注：单一应用下，默认文件总存储限制为 2G 。

如果您需要提高文件总存储限制，请联系我们的销售团队。

限制方式​

英飞云服务会统计应用下文件存储空间总大小，包括从画布内直接上传的文件以及通过服务端接口上传的文件。

当文件总存储超出限额时，Web SDK 会通过 onUploadFailed 回调方法返回错误码及原因，您可以根据业务需要显示相应的友好消息提示。

enum UploadFailedCode {
  EXCEEDS_STORAGE_LIMIT = 1,
}
type UploadRejectInfo = {
  code: UploadFailedCode;
  message?: string;
};

onUploadFailed?: (info: UploadRejectInfo) => void;