自定义网表
< Zh | Dota 2 Workshop Tools
自定义网表(Nettable)是一个强大的游戏服务器与客户端之间的数据通讯工具。与游戏时间不同,网表将持续进行储存,并可以随时查询,玩家断开并重连时将重新创建。
示例
注册表格
你必须将顶级表格的名字列在game/ADDON_NAME/scripts/custom_net_tables.txt
。(如果此文件不在您的地图中您可以自行创建。)它使用这里所描述的:KeyValues3句法
<!-- kv3 encoding:text:version{e21c7f3c-8a33-41c5-9977-a76d3a32aa0d} format:generic:version{7412167c-06e9-4698-aff2-e63eb59037e7} -->;
{
custom_net_tables =
[
"example_nettable_1",
"example_nettable_2"
]
}
在服务器中写入网表(Lua)
服务器代码可以使用以下函数设置表格的值: CustomNetTables:SetTableValue( string table_name, string key, table value )
一个表格可以含有任意个字符串关键字,每一个都对应着一个Lua表格值。
![Note.png](/w/images/thumb/c/cc/Note.png/10px-Note.png)
CustomNetTables:SetTableValue( "example_nettable_1", "key_1", {} );
CustomNetTables:SetTableValue( "example_nettable_1", "key_2", { value = "hello" } );
CustomNetTables:SetTableValue( "example_nettable_2", "key_1", { a = 1, b = 2 } );
读取客户端的网表(Javascript)
当服务器上的网表数据发生变化时,他将被复制到各个客户端。Javascript可以查表格中的当前值,然后订阅以获取表格变化的通知。
![Note.png](/w/images/thumb/c/cc/Note.png/10px-Note.png)
//--------------------------------------------------------------------------------------------------
// GetAllTableValues returns the entire nettable as a Javascript object
//--------------------------------------------------------------------------------------------------
$.Msg( CustomNetTables.GetAllTableValues( "example_nettable_1" ) );
//--------------------------------------------------------------------------------------------------
// GetTableValue returns the value associated with a particular key
//--------------------------------------------------------------------------------------------------
$.Msg( CustomNetTables.GetTableValue( "example_nettable_2", "key_1" ) );
//--------------------------------------------------------------------------------------------------
// SubscribeNetTableListener allows you to be notified when any value in a table changes
//--------------------------------------------------------------------------------------------------
function OnNettable2Changed( table_name, key, data )
{
$.Msg( "Table ", table_name, " changed: '", key, "' = ", data );
}
CustomNetTables.SubscribeNetTableListener( "example_nettable_2", OnNettable2Changed );