【Unity基础】Unity中跨平台使用SQLite

news2024/9/27 8:22:04

一、概述

游戏中数据存储方案众多，在进行选择时，除了要考虑数据类型外，还要考虑对于跨平台的支持。

对于数据存储方案将在单独文章里介绍，下面只是总结了不同方案的特点。

方法	跨平台支持	读写能力	适合场景	特点
Resources	优秀	只读	小型项目，静态资源加载	简单方便，Unity 自动管理
StreamingAssets	中等	只读	大型文件（音频、视频、配置文件等）	保留原始文件格式，路径平台相关
PersistentDataPath	优秀	读写	用户数据、存档、设置	持久化存储，适合存档和用户数据
ScriptableObject	优秀	只读	配置数据、静态游戏数据	Unity 原生支持，内存优化
SQLite/数据库	中等	读写	大量结构化数据管理，复杂查询	强大数据管理功能，需第三方支持
REST API / 云存储	优秀	读写

本系列文章将重点介绍如何在跨平台项目中使用SQLite做为数据存储方案。

这里的跨平台指的是Windows, Mac, Linux, iOS, Android，WebGL，基本上覆盖主流平台。

在查找过程中，AssetStore上有一些支持SQLite的插件，但都是收费的，而许多文章里提到的SQLite4Unity3d，SQLiteUnityKit， sqlite-unity-plugin等已经许多年不更新维护了。

现在在Github上找到最新的一个插件是unity-sqlite-net，这是一位巴西的游戏开发者在维护。

本系列文章就是基于这个插件进行介绍的。

这个插件支持的平台包括Windows, Linux, macOS, iOS, tvOS, visionOS, Android 和WebGL。

二、安装Unity-sqlite-net插件

安装方法有多种：

使用openupm 注册表并使用openupm-cli安装此包：

openupm add com.gilzoide.sqlite-net

使用Unity 包管理器进行安装，网址如下：

https://github.com/gilzoide/unity-sqlite-net.git#1.0.1

Assets克隆此存储库或直接在项目或文件夹中下载它的快照Packages。

https://github.com/gilzoide/unity-sqlite-net

三、运行示例代码

在Unity项目中添加下面的脚本，并在场景中创建一个空对象并挂载这个脚本，运行后可以通过Log查看运行记录。

using SQLite;
using UnityEngine;

// 该库包含一些简单的属性，您可以使用它们来控制表的构造，ORM 样式
public class Player
{
    [PrimaryKey, AutoIncrement]
    public int Id { get; set; }
    public string Name { get; set; }
}

public class TestSQLite : MonoBehaviour
{
    void Start()
    {
        // 1. 创建与数据库的连接。
        // 特殊的“:memory:”内存数据库
        // 还支持“file:///somefile”等 URI
        var db = new SQLiteConnection($"{Application.persistentDataPath}/MyDb.db");

        // 2. 定义实体后，您可以通过调用 CreateTable 自动在数据库中生成表
        db.CreateTable<Player>();

        // 3. 您可以使用 Insert 在数据库中插入行
        // Insert 调用填充 Id，该 Id 标记为 [AutoIncremented]
        var newPlayer = new Player
        {
            Name = "gilzoide",
        };

        db.Insert(newPlayer);
        Debug.Log($"Player new ID: {newPlayer.Id}");
        // 对于更新和删除也存在类似的方法。

        // 4.a 查询数据的最直接方法
        // 是使用 Table 方法。这可以使用谓词
        // 通过 WHERE 子句进行约束和/或添加 ORDER BY 子句
        var query = db.Table<Player>().Where(p => p.Name.StartsWith("g"));

        foreach (Player player in query)
        {
            Debug.Log($"Found player named {player.Name} with ID {player.Id}");
        }

        // 4.b 您还可以使用 Query 方法进行低级查询
        var players = db.Query<Player>("SELECT * FROM Player WHERE Id = ?", 1);

        foreach (Player player in players)
        {
            Debug.Log($"Player with ID 1 is called {player.Name}");
        }

        // 5. 您可以使用 Execute方法对数据库执行低级更新，例如运行 PRAGMA 或 VACUUM
        db.Execute("VACUUM");
    }
}

这段示例代码展示了如何在Unity中使用SQLite进行简单的数据库操作。具体来说：