自学内容网 自学内容网
自学内容网 > 正文

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

🕗 发布于 2024-09-27 14:05 unity  游戏引擎  

一、概述

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

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

方法跨平台支持读写能力适合场景特点
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 add com.gilzoide.sqlite-net
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进行简单的数据库操作。具体来说：

  1. Player类：定义了一个Player实体，包括一个自增的主键Id和一个Name属性。

  2. TestSQLite类：在Start方法中创建数据库连接，路径为持久数据路径下的"MyDb.db"。

  3. 创建表：使用CreateTable<Player>()自动生成Player表。

  4. 插入数据：创建一个新玩家并插入数据库，自动填充Id。

  5. 查询数据：

    • 使用Table方法通过条件查询玩家，输出符合条件的玩家信息。
    • 使用Query方法进行更低级的查询，获取Id为1的玩家。

  6. 执行命令：最后使用Execute方法执行VACUUM命令，优化数据库。

参考：

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

2. https://github.com/praeclarum/sqlite-net


原文地址：https://blog.csdn.net/tealcwu/article/details/142550234

免责声明：本站文章内容转载自网络资源，如本站内容侵犯了原著者的合法权益，可联系本站删除。更多内容请关注自学内容网（zxcms.com）！

相关文章

自学内容网
Copyright © 2015-2024