抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台

基础库 3.74.0 开始支持本方法,这是一个异步方法。

读文件

前提条件无
业务背景无
使用限制无
注意事项无
相关教程无

语法

FileSystemManager.read(options)

参数说明

options 为 object 类型,属性如下:

属性名类型默认值必填说明最低支持版本
positionnumber否
文件读取的起始位置,如不传或传 null,则会从当前文件指针的位置读取。如果 position 是正整数,则文件指针位置会保持不变并从 position 读取文件。
3.74.0
lengthnumber0否
要从文件中读取的字节数,默认0
3.74.0
arrayBufferarrayBuffer是
数据写入的缓冲区,必须是 ArrayBuffer 实例
3.74.0
fdstring是
文件描述符。fd 通过 FileSystemManager.open 或 FileSystemManager.openSync 接口获得
3.74.0
offsetnumber0否
缓冲区中的写入偏移量,默认0
3.74.0
successfunction否
接口调用成功的回调函数
3.74.0
failfunction否
接口调用失败的回调函数
3.74.0
completefunction否
接口调用结束的回调函数(调用成功、失败都会执行)
3.74.0

回调成功

object 类型,属性如下:

属性名类型说明最低支持版本
errMsgstring
"FileSystemManager.readCompressedFile:ok"
3.74.0
bytesReadnumber
实际读取的字节数
3.74.0
arrayBufferarrayBuffer
被写入的缓存区的对象,即接口入参的 arrayBuffer
3.74.0

回调失败

object 类型,属性如下:

属性名类型说明最低支持版本
errMsgstring
"FileSystemManager.readCompressedFile:fail" + 详细错误信息
3.74.0

错误码

errNoerrMsg说明最低支持版本
20001invalid param
参数错误
3.74.0
21100bad file descriptor
无效的文件描述符
3.74.0
21101system error
小游戏框架内部错误,有需要请创建工单咨询
3.74.0
21102illegal operation on a directory
不可对目录进行此操作(例如,指定的 filePath 是一个已经存在的目录)
3.74.0
21103value of length is out of range
传入的 length 不合法
3.74.0
21104value of offset is out of range
传入的 offset 不合法
3.74.0
21105value of position is out of range
position 值越界
3.74.0
21106invalid fd
传入的 fd 无效,不是通过 open 打开获得的
3.74.0

扫码体验

请使用字节宿主APP扫码

代码示例

开发者工具中预览

const fs = tt.getFileSystemManager(); const arrayBuffer = new ArrayBuffer(1024); fs.read({ fd, arrayBuffer, offset: 0, position: 0, length: 10, success: (res) => { console.log('文件读取成功', res); }, fail: (err) => { console.error('文件读取失败', err); } });