c#获取对象的唯一标识_Articy Importer Guide

原文链接

基本对象处理 Basic Object Handling

当你为 Unity 项目从 articy:draft 中导出数据时，articy importer 插件将能够根据你的数据生成数据库，并为所有数据创建C#类型和属性。本篇文章将介绍如何获取这些数据。

本篇文章将包含如下内容：

简单对象获取 Simple Object Access
进阶对象获取 Advanced Object Access
相关连接 See Also

简单对象获取 Simple Object Access

获取 articy 对象的最基本方法是直接从数据库中查询：

// 通过技术名称获取对象
ArticyObject manfred1 = ArticyDatabase.GetObject("Chr_Manfred");

使用 ArticyDatabase 类，我们通过 GetObject 方法和技术名称 "Chr_Manfred" 获取到了一个对象。返回的对象是 ArticyObject ，是数据库中所有对象的基本类型。

同样也能手动转换 ArticyObjec，也可以也可以要求GetObject方法返回特定类型：

// 通过确切类型和技术名称获取一个对象
Player_Character manfred2 = ArticyDatabase.GetObject<Player_Character>("Chr_Manfred");

该案例中，我们提供了 Player_Character 这一模板名称，返回的对象将被自动地转换为该类型。变量 manfred2 现在包含着对 Player_Character 类型的实体的引用，我们可以访问其所有属性：

// 我们可以访问所有导出的属性
Debug.Log( manfred2.Text );
// 当然也可以设置属性
manfred2.DisplayName = "Advanced Manfred 2.0";

技术名称（Technical Name）并非是查询数据库的唯一途径。另一个办法是使用 articy 对象独有的对象id：

var manfred3 = ArticyDatabase.GetObject(0x1000001000010C6);
// ↑以十六进制表示
// ↓以十进制表示
var manfred4 = ArticyDatabase.GetObject(72057598332899526);

请注意如何写十六进制（如articy:draft中所示）或十进制，这是将id打印到log或将其存储在int中时显示的。

注意该插件包含将对象的ID转换为其十六进制字符串表示法的方法，反之亦然。 参见ToHex（Int64）

Articy并不要求技术名称独一无二。事实上，完全可以把一个名字分配给多个对象，并使用技术名称获取到所有同名对象。

List<ArticyObject> allManfreds = ArticyDatabase.GetObjects("Chr_Manfred");

在这种情况下，要获取特定对象，请使用具有唯一 id 的 GetObject（id）。

注意由于出错的可能性很高，建议不要为articy:draft的多个对象故意分配相同的技术名称。要将某些对象组合在一起，请使用自定义模板并按其类型查询对象。有关如何按类型查询对象的信息，请参见基本对象处理。

进阶对象获取 Advanced Object Access

有时你会想获取某个特定类型的所有对象。此时可使用ArticyDatabase包含的GetAllOfType<TObject>()方法。任何标准的articy对象类型都可用于指定，使用自定义的模板亦可。

var allmyItems = ArticyDatabase.GetAllOfType<Item>();

为进一步过滤返回的道具列表，还可使用LINQ指定其他条件。请参阅Microsoft的LINQ文档，了解如何编写LINQ语句。下面的示例仅选取了价格高于100的item类型对象。

var allExpensiveItems = ArticyDatabase.GetAllOfType<Item>().Where( aItem => aItem.Template.Item.GoldCost > 100).ToList();