抖音开放平台Logo
控制台

tt.getFileSystemManager
收藏
我的收藏

基础库 1.15.0 开始支持本方法，这是一个同步方法。

获取全局唯一的文件管理器。

❗
警告
从基础库 2.21 版本（包含）开始， 小游戏对本地空间上限进行了调整。开发者通过文件接口能够保存的文件大小上限由之前的 50M 现在变更为 200M。开发者可以根据小游戏基础库版本做适配，或者在发布时设置最低基础库版本。目前，2.21 版本已经覆盖大部分用户
前提条件无
业务背景无
使用限制无
注意事项
  • 小游戏支持 200M 的本地文件空间存储。
  • 小游戏的本地空间储存逻辑上为以 appid 为纬度，不区分预览版，正式版。
相关教程无

语法

tt.getFileSystemManager()

参数说明

无

返回值

类型说明最低支持版本
object

文件管理器，FileSystemManager 类型。

1.15.0

FileSystemManager 参数说明

目录说明

小游戏文件系统分为以下 3 个部分

用户目录

以 ttfile://user 开头, 开发者拥有读写权限

临时目录

以 ttfile://temp 开头, 开发者拥有读权限, 无写权限

包目录

小游戏包体目录, 开发者拥有读权限, 无写权限

注意 除 access、accessSync、readFile、readFileSync 外其他 API 均不可以访问包目录


扫码体验

请使用字节宿主APP扫码

代码示例

开发者工具中预览

【代码示例1】

const fileSystemManager = tt.getFileSystemManager();

【代码示例2】访问 包目录不需要填写前缀, 例如读取包内 app.js 文件

const fileSystemManager = tt.getFileSystemManager();

fileSystemManager.readFile({
  filePath: "app.js",
  encoding: "utf8",
  success(res) {
    // app.js 文件内容
    console.log(res.data);
  },
  fail(res) {
    //
    console.error("读取失败", res.errMsg);
  },
});