[转载]Unity3D 游戏引擎之使用C＃语言建立本地数据库(SQLITE)
以前在开发中一直使用IOS源生的数据库，通过传递消息的形式在与Unity3D中进行交互。本文我在详细说说如何使用C#语言来在MAC 操作系统下创建Unity本地数据库，我是C#控哇咔咔～～～
首先你需要得到Mono.Data.Sqlite.dll 文件 与System.Data.dll文件。如果你在Mac 操作系统下使用Unity那么很悲剧，找不到这两个文件，至少我没能找到。后来我在Windows下的Unity安装路径中找到了它。为了方便大家我将这两个文件上传至网盘中，如果没有这两个文件的朋友请下载。
下载地址：http://vdisk.weibo.com/s/abG7k
.zip文件下载完毕后直接解压，然后将Mono.Data.Sqlite.dll 文件 与System.Data.dll文件放在Unity工程中的Assets文件夹中。如下图所示，两个文件已经放置在Project视图当中。
Ok ，我们编写C#脚本，原始文章没有Unity数据库更新与删除的方法，我在这里加上更新与删除的方法，方便大家开发时使用。因为其实Unity中更新与删除数据库也是个比较重要的功能。
注意：下面脚本不要绑定在任何游戏对象身上，大家无需把它当作脚本可以当作一个工具类来使用。
using UnityEngine; using System; using System.Collections; using Mono.Data.Sqlite; public class DbAccess { private SqliteConnection dbConnection; private SqliteCommand dbCommand; private SqliteDataReader reader; public DbAccess (string connectionString) { OpenDB (connectionString); } public DbAccess () { } public void OpenDB (string connectionString) { try { dbConnection = new SqliteConnection (connectionString); dbConnection.Open (); Debug.Log ("Connected to db"); } catch(Exception e) { string temp1 = e.ToString(); Debug.Log(temp1); } } public void CloseSqlConnection () { if (dbCommand != null) { dbCommand.Dispose (); } dbCommand = null; if (reader != null) { reader.Dispose (); } reader = null; if (dbConnection != null) { dbConnection.Close (); } dbConnection = null; Debug.Log ("Disconnected from db."); } public SqliteDataReader ExecuteQuery (string sqlQuery) { dbCommand = dbConnection.CreateCommand (); dbCommand.CommandText = sqlQuery; reader = dbCommand.ExecuteReader (); return reader; } public SqliteDataReader ReadFullTable (string tableName) { string query = "SELECT * FROM " + tableName; return ExecuteQuery (query); } public SqliteDataReader InsertInto (string tableName, string[] values) { string query = "INSERT INTO " + tableName + " VALUES (" + values[0]; for (int i = 1; i < values.Length; ++i) { query += ", " + values[i]; } query += ")"; return ExecuteQuery (query); } public SqliteDataReader UpdateInto (string tableName, string []cols,string []colsvalues,string selectkey,string selectvalue) { string query = "UPDATE "+tableName+" SET "+cols[0]+" = "+colsvalues[0]; for (int i = 1; i < colsvalues.Length; ++i) { query += ", " +cols[i]+" ="+ colsvalues[i]; } query += " WHERE "+selectkey+" = "+selectvalue+" "; return ExecuteQuery (query); } public SqliteDataReader Delete(string tableName,string []cols,string []colsvalues) { string query = "DELETE FROM "+tableName + " WHERE " +cols[0] +" = " + colsvalues[0]; for (int i = 1; i < colsvalues.Length; ++i) { query += " or " +cols[i]+" = "+ colsvalues[i]; } Debug.Log(query); return ExecuteQuery (query); } public SqliteDataReader InsertIntoSpecific (string tableName, string[] cols, string[] values) { if (cols.Length != values.Length) { throw new SqliteException ("columns.Length != values.Length"); } string query = "INSERT INTO " + tableName + "(" + cols[0]; for (int i = 1; i < cols.Length; ++i) { query += ", " + cols[i]; } query += ") VALUES (" + values[0]; for (int i = 1; i < values.Length; ++i) { query += ", " + values[i]; } query += ")"; return ExecuteQuery (query); } public SqliteDataReader DeleteContents (string tableName) { string query = "DELETE FROM " + tableName; return ExecuteQuery (query); } public SqliteDataReader CreateTable (string name, string[] col, string[] colType) { if (col.Length != colType.Length) { throw new SqliteException ("columns.Length != colType.Length"); } string query = "CREATE TABLE " + name + " (" + col[0] + " " + colType[0]; for (int i = 1; i < col.Length; ++i) { query += ", " + col[i] + " " + colType[i]; } query += ")"; return ExecuteQuery (query); } public SqliteDataReader SelectWhere (string tableName, string[] items, string[] col, string[] operation, string[] values) { if (col.Length != operation.Length ¦¦ operation.Length != values.Length) { throw new SqliteException ("col.Length != operation.Length != values.Length"); } string query = "SELECT " + items[0]; for (int i = 1; i < items.Length; ++i) { query += ", " + items[i]; } query += " FROM " + tableName + " WHERE " + col[0] + operation[0] + "'" + values[0] + "' "; for (int i = 1; i < col.Length; ++i) { query += " AND " + col[i] + operation[i] + "'" + values[0] + "' "; } return ExecuteQuery (query); } }
首先是创建本地数据库，我们创建C#脚本Test.cs直接绑定在摄像机中。
using UnityEngine; using System.Collections; public class Test : MonoBehaviour { void Start () { //创建数据库名称为xuanyusong.db DbAccess db = new DbAccess("data source=xuanyusong.db"); //创建数据库表，与字段 db.CreateTable("momo",new string[]{"name","qq","email","blog"}, new string[]{"text","text","text","text"}); //关闭对象 db.CloseSqlConnection(); } }
运行游戏后，数据库对象会自动生成在项目的根目录中。查看数据库的软件我使用的是Navicat Premium，如果没有请大家下载，然后继续。如下图所示，数据库文件xuanyusong.db已经生成在项目的根目录中，接着我使用Navicat Premium软件将这个数据库打开。数据库的表名为momo 打开表后字段包含name、 qq 、email、 blog。都是我们在代码中创建的。
OK，我们继续。首先是插入数据，记得将编码修改成UTF-16 不然中文会乱码。
using UnityEngine; using System.Collections; public class Test : MonoBehaviour { void Start () { //创建数据库名称为xuanyusong.db DbAccess db = new DbAccess("data source=xuanyusong.db"); //请注意 插入字符串是 已经要加上'宣雨松' 不然会报错 db.InsertInto("momo", new string[]{ "'宣雨松'","'289187120'","'xuanyusong@gmail.com'","'www.xuanyusong.com'" }); db.CloseSqlConnection(); } }
接着是更新数据。UpdateInto是我新写的方法，接受更新多条数据。
using UnityEngine; using System.Collections; public class Test : MonoBehaviour { void Start () { //创建数据库名称为xuanyusong.db DbAccess db = new DbAccess("data source=xuanyusong.db"); db.UpdateInto("momo",new string[]{"name","qq"},new string[]{"'xuanyusong'","'11111111'"}, "email", "'xuanyusong@gmail.com'" ); db.CloseSqlConnection(); } }
然后是删除数据DELETE也是我封装的方法。
using UnityEngine; using System.Collections; public class Test : MonoBehaviour { void Start () { //创建数据库名称为xuanyusong.db DbAccess db = new DbAccess("data source=xuanyusong.db"); //请注意 插入字符串是 已经要加上'宣雨松' 不然会报错 db.CreateTable("momo",new string[]{"name","qq","email","blog"}, new string[]{"text","text","text","text"}); //我在数据库中连续插入三条数据 db.InsertInto("momo", new string[]{ "'宣雨松'","'289187120'","'xuanyusong@gmail.com'","'www.xuanyusong.com'" }); db.InsertInto("momo", new string[]{ "'雨松MOMO'","'289187120'","'000@gmail.com'","'www.xuanyusong.com'" }); db.InsertInto("momo", new string[]{ "'哇咔咔'","'289187120'","'111@gmail.com'","'www.xuanyusong.com'" }); //然后在删掉两条数据 db.Delete("momo",new string[]{"email","email"}, new string[]{"'xuanyusong@gmail.com'","'000@gmail.com'"} ); db.CloseSqlConnection(); } }
最后是查找数据。
using UnityEngine; using System.Collections; using Mono.Data.Sqlite; public class Test : MonoBehaviour { void Start () { //创建数据库名称为xuanyusong.db DbAccess db = new DbAccess("data source=xuanyusong.db"); //请注意 插入字符串是 已经要加上'宣雨松' 不然会报错 db.CreateTable("momo",new string[]{"name","qq","email","blog"}, new string[]{"text","text","text","text"}); //我在数据库中连续插入三条数据 db.InsertInto("momo", new string[]{ "'宣雨松'","'289187120'","'xuanyusong@gmail.com'","'www.xuanyusong.com'" }); db.InsertInto("momo", new string[]{ "'雨松MOMO'","'289187120'","'000@gmail.com'","'www.xuanyusong.com'" }); db.InsertInto("momo", new string[]{ "'哇咔咔'","'289187120'","'111@gmail.com'","'www.xuanyusong.com'" }); //然后在删掉两条数据 db.Delete("momo",new string[]{"email","email"}, new string[]{"'xuanyusong@gmail.com'","'000@gmail.com'"} ); //注解1 SqliteDataReader sqReader = db.SelectWhere("momo",new string[]{"name","email"},new string[]{"qq"},new string[]{"="},new string[]{"289187120"}); while (sqReader.Read()) { Debug.Log(sqReader.GetString(sqReader.GetOrdinal("name")) + sqReader.GetString(sqReader.GetOrdinal("email"))); } db.CloseSqlConnection(); } }
注解1：这里的结构非常像安卓的数据库指针，然后while循环把每一条数据都取出来。 sqReader.Gerordinal()方法就是拿到对应列名称的数据。如下图所示，经过一些列的添加与删除的操作最后数据库的内容如下。
如下图所示，我使用Log也将数据库name 与 email的字段打印了出来。最后我在强调一点，我们在OnStart方法中db.CreateTable创建数据库表，如果重复创建系统会抛出错误。避免这个情况请保证你的数据库表只会被创建一次。祝大家学习愉快嘎嘎嘎～～～
留言中看到有朋友说报错，那么MOMO将我的工程打包，提供下在地址
Unity 使用SQLite本地数据库的下载地址如下：http://vdisk.weibo.com/s/abGmB
如下图所示，请先在PlaySettings中修改Api Compatibility Level 改成.NET 2.0，如果不修改会报错
注意：Error building Player: Extracting referenced dlls failed.
无论你编译任何平台都请修改一下这里， 留言中有朋友在编译PC平台中 因为没有修改这里导致无法编译成功。。
IOS平台SQLite的使用：
然后需要修改Test.cs的脚本，在修改一下数据库保存的路径，我们将数据库放在沙盒当中。这样IOS中才可以读取数据库。
using UnityEngine; using System.Collections; using Mono.Data.Sqlite; public class Test : MonoBehaviour { void Start () { //数据库文件储存地址 string appDBPath = Application.persistentDataPath + "/xuanyusong.db"; DbAccess db = new DbAccess(@"Data Source=" + appDBPath); //请注意 插入字符串是 已经要加上'宣雨松' 不然会报错 db.CreateTable("momo",new string[]{"name","qq","email","blog"}, new string[]{"text","text","text","text"}); //我在数据库中连续插入三条数据 db.InsertInto("momo", new string[]{ "'宣雨松'","'289187120'","'xuanyusong@gmail.com'","'www.xuanyusong.com'" }); db.InsertInto("momo", new string[]{ "'雨松MOMO'","'289187120'","'000@gmail.com'","'www.xuanyusong.com'" }); db.InsertInto("momo", new string[]{ "'哇咔咔'","'289187120'","'111@gmail.com'","'www.xuanyusong.com'" }); //然后在删掉两条数据 db.Delete("momo",new string[]{"email","email"}, new string[]{"'xuanyusong@gmail.com'","'000@gmail.com'"} ); //注解1 using (SqliteDataReader sqReader = db.SelectWhere("momo",new string[]{"name","email"},new string[]{"qq"},new string[]{"="},new string[]{"289187120"})) { while (sqReader.Read()) { //目前中文无法显示 Debug.Log(sqReader.GetString(sqReader.GetOrdinal("name"))); Debug.Log(sqReader.GetString(sqReader.GetOrdinal("email"))); } sqReader.Close(); } db.CloseSqlConnection(); } }
下面开始打包成IOS版本，直接运行如下图所示，已经在XCODE的控制台中将字符串信息打印出来。目前我不知道如何读取中文，但是可以确定的是中文信息已经写入数据库中。不信大家可以打开沙盒看看。
Android平台SQLite的使用：
Android与IOS在使用SQLite数据库时有点区别，Android需要将第三方DLL放在Plugins当中。脚本也需要修改一下，先看看Test.cs的改动。
using UnityEngine; using System.Collections; using Mono.Data.Sqlite; public class Test : MonoBehaviour { void Start () { //数据库文件储存地址 string appDBPath = Application.persistentDataPath + "/xuanyusong.db"; //注意！！！！！！！这行代码的改动 DbAccess db = new DbAccess("URI=file:" + appDBPath); //请注意 插入字符串是 已经要加上'宣雨松' 不然会报错 db.CreateTable("momo",new string[]{"name","qq","email","blog"}, new string[]{"text","text","text","text"}); //我在数据库中连续插入三条数据 db.InsertInto("momo", new string[]{ "'宣雨松'","'289187120'","'xuanyusong@gmail.com'","'www.xuanyusong.com'" }); db.InsertInto("momo", new string[]{ "'雨松MOMO'","'289187120'","'000@gmail.com'","'www.xuanyusong.com'" }); db.InsertInto("momo", new string[]{ "'哇咔咔'","'289187120'","'111@gmail.com'","'www.xuanyusong.com'" }); //然后在删掉两条数据 db.Delete("momo",new string[]{"email","email"}, new string[]{"'xuanyusong@gmail.com'","'000@gmail.com'"} ); //注解1 using (SqliteDataReader sqReader = db.SelectWhere("momo",new string[]{"name","email"},new string[]{"qq"},new string[]{"="},new string[]{"289187120"})) { while (sqReader.Read()) { Debug.Log("xuanyusong" + sqReader.GetString(sqReader.GetOrdinal("name"))); Debug.Log("xuanyusong" + sqReader.GetString(sqReader.GetOrdinal("email"))); } sqReader.Close(); } db.CloseSqlConnection(); } void Update() { if (Input.GetKeyDown(KeyCode.Escape) ¦¦Input.GetKeyDown(KeyCode.Home) ) { Application.Quit(); } } }
如下图所示，Player Settings 请和我保持一致。
值得庆幸的是在Android下读取数据库时正常的显示了中文。如下图所示，运行打包后的程序后在Eclipse的后台已经能看到数据库显示的中文与英文，呵呵。
由于工程中需要一些DLL，所以我将工程的下载地址放出，请大家下载。
http://vdisk.weibo.com/s/abGz3
MAC平台下的使用：
请先下载原始版本 http://vdisk.weibo.com/s/abGmB
我们只需在原始版本之上进行修改即可。
修改Test.cs文件 ，请注意我在代码中标注的内容。
using UnityEngine; using System.Collections; using Mono.Data.Sqlite; public class Test : MonoBehaviour { string name = null; string email = null; string appDBPath = null; void Start () { //////////-------- //请注意！！！！！！！ //这里的修改 appDBPath = Application.dataPath + "/xuanyusong.db"; DbAccess db = new DbAccess(@"Data Source=" + appDBPath); //////////-------- //请注意 插入字符串是 已经要加上'宣雨松' 不然会报错 db.CreateTable("momo",new string[]{"name","qq","email","blog"}, new string[]{"text","text","text","text"}); //我在数据库中连续插入三条数据 db.InsertInto("momo", new string[]{ "'宣雨松'","'289187120'","'xuanyusong@gmail.com'","'www.xuanyusong.com'" }); db.InsertInto("momo", new string[]{ "'雨松MOMO'","'289187120'","'000@gmail.com'","'www.xuanyusong.com'" }); db.InsertInto("momo", new string[]{ "'哇咔咔'","'289187120'","'111@gmail.com'","'www.xuanyusong.com'" }); //然后在删掉两条数据 db.Delete("momo",new string[]{"email","email"}, new string[]{"'xuanyusong@gmail.com'","'000@gmail.com'"} ); SqliteDataReader sqReader = db.SelectWhere("momo",new string[]{"name","email"},new string[]{"qq"},new string[]{"="},new string[]{"289187120"}); while (sqReader.Read()) { Debug.Log(sqReader.GetString(sqReader.GetOrdinal("name")) + sqReader.GetString(sqReader.GetOrdinal("email"))); //取值 name = sqReader.GetString(sqReader.GetOrdinal("name")); email = sqReader.GetString(sqReader.GetOrdinal("email")); } db.CloseSqlConnection(); } void OnGUI() { ///为了让大家看的更清楚 我将数据库取出的内容显示在屏幕中 if(name != null) { GUILayout.Label("XXXXXXXXXXXXX" + name); } if (email!= null) { GUILayout.Label("XXXXXXXXXXXXX" + email); } if(appDBPath != null) { GUILayout.Label("数据库的路径" + appDBPath); } } }
生成工程后，运行生成的mac程序，我们可以看到 数据已经取出来了。
Windows平台SQLite的使用：
Windows平台下与Mac平台有点区别，废了老半天来找到问题所在。MOMO感谢在博客后面留言的朋友，因为没有你们的留言我也不会去研究MAC Windows下如何使用 呵呵。
进入正题，还是先修改Test.cs文件
using System.Collections; using Mono.Data.Sqlite; //using Mono.Data.SqliteClient; public class Test : MonoBehaviour { string name = null; string email = null; string path = null; void Start () { //数据库文件储存地址 //注意这里的修改！！！！！！！！！！！！！！ string appDBPath = Application.dataPath + "/xuanyusong.db"; //-------------------------- DbAccess db = new DbAccess(@"Data Source=" + appDBPath); path = appDBPath; //请注意 插入字符串是 已经要加上'宣雨松' 不然会报错 db.CreateTable("momo",new string[]{"name","qq","email","blog"}, new string[]{"text","text","text","text"}); //我在数据库中连续插入三条数据 db.InsertInto("momo", new string[]{ "'宣雨松'","'289187120'","'xuanyusong@gmail.com'","'www.xuanyusong.com'" }); db.InsertInto("momo", new string[]{ "'雨松MOMO'","'289187120'","'000@gmail.com'","'www.xuanyusong.com'" }); db.InsertInto("momo", new string[]{ "'哇咔咔'","'289187120'","'111@gmail.com'","'www.xuanyusong.com'" }); //然后在删掉两条数据 db.Delete("momo",new string[]{"email","email"}, new string[]{"'xuanyusong@gmail.com'","'000@gmail.com'"} ); //注解1 using (SqliteDataReader sqReader = db.SelectWhere("momo",new string[]{"name","email"},new string[]{"qq"},new string[]{"="},new string[]{"289187120"})) { while (sqReader.Read()) { //目前中文无法显示 Debug.Log("xuanyusong" + sqReader.GetString(sqReader.GetOrdinal("name"))); Debug.Log("xuanyusong" + sqReader.GetString(sqReader.GetOrdinal("email"))); name = sqReader.GetString(sqReader.GetOrdinal("name")); email = sqReader.GetString(sqReader.GetOrdinal("email")); } sqReader.Close(); } db.CloseSqlConnection(); } void OnGUI() { if(name != null) { GUILayout.Label(name); } if(email != null) { GUILayout.Label(email); } if(path != null) { GUILayout.Label(path); } } }
如下图所示打开Unity然后我们需要下载sqlite3.dll文件，接着将dll都放入Plugins文件夹中。不用担心 稍后我会把真个工程的下载地址贴出来其中包括所有的dll 。
最后直接打包成Windows平台工程。双击运行.exe文件，如下图所示数据库的数据以及路径MOMO已经打印在屏幕当中啦。哇咔咔～ 然后xuanyusong.db文件就放在ddd_Date文件夹中，我已经用红圈标注出来了。ddd就是工程的名称，ddd_Date该文件夹是自动生成的。
最后这个工程的下载地址，包括所有DLL以及代码MOMO感谢大家的支持。
下载地址：http://vdisk.weibo.com/s/abGL7
最后祝大家学习愉快。
来源： 雨松MOMO 作者：xuanyusong
