抖音开放平台Logo
开发者文档
小游戏
控制台
  • API 概览
  • 开放能力
  • 基础
  • 渲染
  • 设备
  • 文件
  • 位置
  • 媒体
  • 网络
  • 游戏转发分享
  • 实时语音
  • 数据缓存
  • 系统
  • 广告
  • 界面
  • 支付
  • Worker

    • 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);
  },
});