数据表使用手册 | Game Framework

可以将游戏数据以表格（如 Microsoft Excel）的形式进行配置后，使用数据表模块使用这些数据表。

        private void DataTableExample()
        {
            EventComponent eventComponent = GameEntry.GetComponent<EventComponent>();
            // 订阅加载数据表相关的事件
            eventComponent.Subscribe(UnityGameFramework.Runtime.EventId.LoadDataTableSuccess, OnLoadDataTableSuccess);
            eventComponent.Subscribe(UnityGameFramework.Runtime.EventId.LoadDataTableFailure, OnLoadDataTableFailure);

            DataTableComponent dataTableComponent = GameEntry.GetComponent<DataTableComponent>();
            dataTableComponent.LoadDataTable<DRScene>("Scene", "Assets/DataTables/Scene.txt");
            // 注意：不要在这里直接使用刚刚请求加载的数据表，由于资源加载是异步的，所以要在收到加载数据表成功事件后才能使用
        }

        private void OnLoadDataTableSuccess(object sender, GameEventArgs e)
        {
            // 数据表加载成功事件
            UnityGameFramework.Runtime.LoadDataTableSuccessEventArgs ne = e as UnityGameFramework.Runtime.LoadDataTableSuccessEventArgs;
            Log.Info("Load data table '{0}' success.", ne.DataTableName);

            // 这里已经可以安全地使用数据表了
            DataTableComponent dataTableComponent = GameEntry.GetComponent<DataTableComponent>();
            // 获得数据表
            IDataTable<DRScene> dtScene = dataTableComponent.GetDataTable<DRScene>();
            // 获得所有行
            DRScene[] drScenes = dtScene.GetAllDataRows();
            // 根据行号获得某一行
            DRScene drScene = dtScene.GetDataRow(1); // 或直接使用 dtScene[1]
            if (drScene != null)
            {
                // 此行存在，可以获取内容了
                string name = drScene.Name;
                string assetName = drScene.AssetName;
                int backgroundMusicId = drScene.BackgroundMusicId;
            }
            else
            {
                // 此行不存在
            }

            // 获得满足条件的所有行
            DRScene[] drScenesWithCondition = dtScene.GetAllDataRows(x => x.BackgroundMusicId > 0);
            // 获得满足条件的第一行
            DRScene drSceneWithCondition = dtScene.GetDataRow(x => x.Name == "Main");
        }
        private void OnLoadDataTableFailure(object sender, GameEventArgs e)
        {
            // 数据表加载失败事件
            UnityGameFramework.Runtime.LoadDataTableFailureEventArgs ne = e as UnityGameFramework.Runtime.LoadDataTableFailureEventArgs;
            Log.Warning("Load data table '{0}' failure.", ne.DataTableName);
        }

private void DataTableExample()

{

EventComponent eventComponent = GameEntry.GetComponent<EventComponent>();

// 订阅加载数据表相关的事件

eventComponent.Subscribe(UnityGameFramework.Runtime.EventId.LoadDataTableSuccess, OnLoadDataTableSuccess);

eventComponent.Subscribe(UnityGameFramework.Runtime.EventId.LoadDataTableFailure, OnLoadDataTableFailure);

DataTableComponent dataTableComponent = GameEntry.GetComponent<DataTableComponent>();

dataTableComponent.LoadDataTable<DRScene>("Scene", "Assets/DataTables/Scene.txt");

// 注意：不要在这里直接使用刚刚请求加载的数据表，由于资源加载是异步的，所以要在收到加载数据表成功事件后才能使用

}

private void OnLoadDataTableSuccess(object sender, GameEventArgs e)

{

// 数据表加载成功事件

UnityGameFramework.Runtime.LoadDataTableSuccessEventArgs ne = e as UnityGameFramework.Runtime.LoadDataTableSuccessEventArgs;

Log.Info("Load data table '{0}' success.", ne.DataTableName);

// 这里已经可以安全地使用数据表了

DataTableComponent dataTableComponent = GameEntry.GetComponent<DataTableComponent>();

// 获得数据表

IDataTable<DRScene> dtScene = dataTableComponent.GetDataTable<DRScene>();

// 获得所有行

DRScene[] drScenes = dtScene.GetAllDataRows();

// 根据行号获得某一行

DRScene drScene = dtScene.GetDataRow(1); // 或直接使用 dtScene[1]

if (drScene != null)

{

// 此行存在，可以获取内容了

string name = drScene.Name;

string assetName = drScene.AssetName;

int backgroundMusicId = drScene.BackgroundMusicId;

}

else

{

// 此行不存在

}

// 获得满足条件的所有行

DRScene[] drScenesWithCondition = dtScene.GetAllDataRows(x => x.BackgroundMusicId > 0);

// 获得满足条件的第一行

DRScene drSceneWithCondition = dtScene.GetDataRow(x => x.Name == "Main");

}

private void OnLoadDataTableFailure(object sender, GameEventArgs e)

{

// 数据表加载失败事件

UnityGameFramework.Runtime.LoadDataTableFailureEventArgs ne = e as UnityGameFramework.Runtime.LoadDataTableFailureEventArgs;

Log.Warning("Load data table '{0}' failure.", ne.DataTableName);

}

相关 API 参考手册

本文固定链接: http://gameframework.cn/archives/250
转载请注明: Ellan 2016年08月30日于 Game Framework 发表

最后编辑：2016-10-08

作者：Ellan

GameFramework.cn 著名开源 Unity 游戏框架作者，曾就职于搜狐畅游、SOFTSTAR、KABAM 等公司，参与过《天龙八部端游》、《天龙八部手游》、《亚瑟王国》等项目。

站内专栏站点 QQ交谈

捐赠Game Framework 还在不断地发展，感谢大家的支持！

《数据表使用手册》有 6 条评论

张传伟说：

2016年11月3日15:28

为什么我在加载的时候总是失败，还有报错。文件就是之前教程的文件，所有都是这么做的，除了文件路径，是路径有要求吗。我放在Assets里面，代码也改了的Assets/Scene.txt。报错提示空指针
NullReferenceException: Object reference not set to an instance of an object
UnityGameFramework.Runtime.DefaultDataTableHelper.ReleaseDataTableAsset (System.Object dataTableAsset)
GameFramework.DataTable.a.b (System.String A_0, System.Object A_1, Single A_2, System.Object A_3)
UnityGameFramework.Runtime.EditorResourceComponent.LoadAsset (System.String assetName, GameFramework.Resource.LoadAssetCallbacks loadAssetCallbacks, System.Object userData) (at Assets/GameFramework/Scripts/EditorResourceComponent.cs:540)
GameFramework.DataTable.a.LoadDataTable (System.String dataTableAssetName, System.Object userData)
UnityGameFramework.Runtime.DataTableComponent.LoadDataTable (System.String dataTableName, System.Type dataTableType, System.String dataTableNameInType, System.String dataTableAssetName, System.Object userData)
UnityGameFramework.Runtime.DataTableComponent.LoadDataTable[DRSence] (System.String dataTableName, System.String dataTableAssetName)
TextEvent.DataTableExample () (at Assets/TextEvent.cs:35)
TextEvent.Start () (at Assets/TextEvent.cs:16)

回复
- Ellan 说：
  
  2016年11月6日17:57
  
  在这个错误之前，应该还有别的错误提示，主要问题在于没有找到 ResourceComponent 组件。
  
  回复
- 原呈说：
  
  2018年9月15日17:08
  
  哥们，你这问题怎么解决的。能跟我说一下么
  
  回复
Jin 说：

2017年8月10日14:44

很幸运能找到一个这么规范的框架

回复
- Ellan 说：
  
  2017年8月21日16:46
  
  感谢支持！
  
  回复
Dragon 说：

2018年6月15日10:12

你的框架真的很棒，比较清晰写的也很规范，

回复