抖音开放平台Logo
开发者文档
控制台
  • API 概览
  • 开放能力
  • 基础
  • 渲染
  • 设备
  • 文件
  • tt.getFileSystemManager
  • FileSystemManager
  • Stats
  • 位置
  • 媒体
  • 网络
  • 游戏转发分享
  • 实时语音
  • 数据缓存
  • 系统
  • 广告
  • 界面
  • 支付
  • 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 均不可以访问包目录


    错误码

    errorCodeerrMsgerrorType说明最低支持版本
    999993internal errorF
    小游戏框架内部错误,有需要请创建工单咨询
    1.15.0

    扫码体验

    请使用字节宿主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); }, });