Unity 之 抖音小游戏本地数据最新存储方法分享

抖音小游戏是一种基于抖音平台开发的小型游戏，与传统的 APP 不同，抖音小游戏运行在抖音客户端内部，可以通过抖音的分享、推荐等功能进行传播。在抖音小游戏开发过程中，文件存储系统是一个非常重要的组成部分，本文将详细介绍抖音小游戏文件存储系统的实现原理和使用方法。

一、抖音小游戏文件存储系统背景

官方文档：使用新文件系统说明，
内容包括了：

• 新文件系统的背景
• 已有存档文件迁移方法：
• 数据对比：在老文件系统上写入约400MB的文件后，打开游戏后占用内存约1G，在迁移后则基本不会再占用内存，游戏内存将至630MB左右

在原有实现中，C#标准的文件接口，如File.ReadAllText、File.WriteAllText、FileStream等，是将数据写入到内存文件系统，然后再在合适的时机自动同步内存数据到IndexedDB中存储。由于采用了IndexedDB文件存储系统，使得运行时内存有一定的增加，如果文件数量过多，可能会发生闪退。

另外，IndexedDB文件存储系统兼容性不够好，在部分iOS系统上会无法正常使用，从而导致无法正常进入游戏的情况。所以我们提供 StarkFileSystemManager接口作为替换，开发者可以通过调用StarkSDKSpace.StarkSDK.API.GetStarkFileSystemManager()方法来使用新的文件存储系统。

---

二、文件存储系统的使用方法

2.1 初始化

在使用文件系统时，我会习惯性的做一个初始化：首先需要获取文件系统管理器对象StarkFileSystemManager，然后获取到一个用户数据存储的路径StarkFileSystemManager.USER_DATA_PATH。

后面的文件相关操作都要在 dyFileSystem，dyFilePath 两个变量的基础上进行操作。

初始化参考代码如下：

using StarkSDKSpace;public class StarkSDKTest : MonoBehaviour
{// 抖音存储文件系统private StarkFileSystemManager dyFileSystem;// 用户数据存储的路径private string dyFilePath;void Start(){dyFileSystem = StarkSDK.API.GetStarkFileSystemManager();dyFilePath = StarkFileSystemManager.USER_DATA_PATH;}
}

2.1 创建目录

创建目录有同步和异步两种写法：

同步方法：MkdirSync(string dirPath, bool recursive = false);

dyFileSystem.MkdirSync(dicPath, false);：

• 第一个参数表示：创建的目录路径，注意：地址要以上面获取的 dyFilePath 作为根目录。
• 第二个参数表示：是否在递归创建该目录的上级目录后再创建该目录。如果对应的上级目录已经存在，则不创建该上级目录。

示例代码：

void CreateDic(string dicPath)
{// 判断文件是否存在if (!dyFileSystem.AccessSync(dicPath)){string isSucc = dyFileSystem.MkdirSync(dicPath, false);Debug.Log($"创建目录成功状态：{isSucc} 为空，则表示创建成功");}else{Debug.Log($"已经存在此目录：{dicPath}, 无需再次创建");}
}

异步方法 Mkdir(MkdirParam param)

参数与同步方法一致，可添加创建成功或失败回调。

void CreateDicAsync(string dicPath)
{if (!dyFileSystem.AccessSync(dicPath)){MkdirParam param = new MkdirParam();param.dirPath = dicPath;param.recursive = false;param.fail = delegate(StarkBaseResponse response){Debug.Log($"异步创建目录失败，失败原因: errCode:{response.errCode} , errMsg:{response.errMsg}");};param.success = response =>{            Debug.Log($"异步创建目录成功，执行成功回调。");};dyFileSystem.Mkdir(param);}else{Debug.Log($"已经存在此目录：{dicPath}, 无需再次创建");}
}

若创建失败，则可根据errMsg进行修改，若不清楚如何修改可以使用errCode和官方文档进行比较。

官方文件系统文档地址

---

2.3 存储数据

涉及知识点：

1. 写入文件
   可以写入字符串 string 或者 字节数组byte[]两种类型，也有同步异步两种方式。
2. 读取文件
   写入时用的什么类型存储，读取时就使用使用类型。字符串方式写入默认编码格式为utf8。
3. 校验文件/目录是否存在

同步写法参考代码如下：

/// <summary> 
/// 存储数据
///     --> 不存在，创建并写入
///     --> 已存在，读取并写入
/// PS：地址要以上面获取的 dyFilePath 作为根目录，后面则可自行创建
/// </summary>
/// <param name="filePath">文件存储地址</param>
/// <param name="fileContext">文件存储内容</param>
void CreateFile(string filePath, string fileContext)
{if (!dyFileSystem.AccessSync(filePath)){string isSucc = dyFileSystem.WriteFileSync(filePath, fileContext, "utf8");Debug.Log($"创建文件成功状态：{isSucc} 为空，则表示创建成功");}else{// 读取并写入 --> 注意编码格式与创建一致string readContext = dyFileSystem.ReadFileSync(filePath, "utf8");Debug.Log($"读取文件内容：{readContext}");string isSucc = dyFileSystem.WriteFileSync(filePath, readContext + fileContext);Debug.Log($"读取并写入：{filePath}, 无需再次创建");}
}

---

2.4 删除目录/文件

dyFileSystem.RmdirSync(delPath, false);：

• 第一个参数表示：删除目录/文件的路径。
• 第二个参数表示：是否递归删除目录。如果为 true，则删除该目录和该目录下的所有子目录以及文件。为false则删除指定目录/文件。

// 删除文件/目录
void DeleteFileOrDic(string delPath)
{if (dyFileSystem.AccessSync(delPath)){// 第二个参数表示：是否递归删除目录。如果为 true，则删除该目录和该目录下的所有子目录以及文件string isSucc = dyFileSystem.RmdirSync(delPath, false);Debug.Log($"删除文件/目录成功状态：{isSucc} 为空，则表示删除成功");}else{Debug.Log($"不存在此文件/目录：{delPath}, 无需删除");}
}

---

2.5 其他相关操作

复制文件：也同样有同步和异步两种方法，使用方式和上面基本一致

重命名文件：

---

三，小结

抖音小游戏文件存储系统是一个非常重要的组成部分，它提供了一种简单、可靠的方式来存储和管理小游戏中的数据。此文件存储系统支持存储和读取文本、JSON、二进制等类型的数据，并提供了多种 API 来实现数据的存储和访问。

在开发抖音小游戏时，可以使用抖音小游戏文件存储系统来实现数据的存储和访问，从而提高小游戏的性能和用户体验。