教程3：Agent实例-–-behaviac-平芜编程栈

原文

本文档描述的是3.6及以后版本，对于3.5及以前的老版本请参考分类“3.5”。

我们知道，面向对象程序编程的定义就是使用对象来做设计，对象即是类的实例。behaviac组件是基于Agent类及其实例来运转的，Agent类的实例加载和执行行为树，而在行为树的节点中又有可能用到了Agent实例的成员属性或方法。

在编辑器的节点属性窗口中，为了给该节点配置参数，首先需要选择一个实例，然后再选择该实例的成员属性或方法，如下图所示：

这些实例来自于如下三个方面：

Self：当前行为树根节点所配置的Agent类的实例，类似于程序语言中的this。
成员实例：当前行为树根节点所配置的Agent类的成员属性，或是当前行为树的局部变量，需要是Agent或其子类类型。
全局实例：在类型信息浏览器中编辑并生成注册代码的各种Agent或其子类的全局变量。

成员实例

对于成员实例，在上图所示的节点属性窗口中会根据当前行为树根节点所配置的Agent类型，自动列举出所有的成员实例以供选择。但在使用该成员实例之前，需要确保该实例已经赋过值，而不是空指针或引用。

在类型信息浏览器中添加新的Agent子类SecondAgent，并为其添加一个int类型的成员属性p2，如下图所示：

然后，为FirstAgent类添加SecondAgent类型的成员属性pInstance，如下图所示：

点击上图中的“确认”按钮后，可以看到FirstAgent类多了一个成员属性pInstance，如下图所示：

全局实例

对于全局实例，各种Agent或其子类实例的名字注册和绑定是为了支持单件（Singleton）或者类似确定的全局性实例（同一个类可能会有若干个实例而不是仅仅有一个实例），如player、camera、director等。

点击类型信息浏览器中部的“实例名称”右侧的“新增”按钮，添加SecondAgent类型的全局实例SecondAgentInstance，如下图所示：

点击上图中的“确认”按钮后，可以看到SecondAgent类的“实例名称”下拉列表中有了新加的全局实例SecondAgentInstance，如下图所示：

点击上图中右下方的“应用”按钮，就可以在行为树中分别使用这2个新加的成员实例和全局实例了。

应用

新建一棵行为树“InstanceBT”，依次添加序列、赋值、条件和动作节点，并为根节点选择FirstAgent类型，将动作节点配置为Self及其成员方法SayHello，如下图所示：

选中ID为1的赋值节点，在其属性窗口“左参数”的实例名中，可以为其选择Self、SecondAgentInstance和pInstance 3个实例了，如下图所示：

为其选择SecondAgentInstance及其成员属性p2，如下图所示：

类似的，选中ID为2的赋值节点，为其选择pInstance及其成员属性p2，如下图所示：

选中ID为3的条件节点，将“左参数”选择为SecondAgentInstance及其成员属性p2，将“右参数”选择为pInstance及其成员属性p2，将“操作符”选择为“>”，如下图所示：

配置完之后，得到行为树“InstanceBT”如下图所示：

导出行为树后，程序端就可以在加载和执行该行为树“InstanceBT”了。

C++版

在源码包的tutorials/tutorial_3/cpp/tutorial_3.cpp文件中，定义了3个变量，如下代码所示：

FirstAgent*g_FirstAgent=NULL;SecondAgent*g_SecondAgent=NULL;SecondAgent*g_ThirdAgent=NULL;

其中，g_FirstAgent用于加载和执行行为树“InstanceBT”，g_SecondAgent用于赋值给g_FirstAgent的成员属性pInstance，g_ThirdAgent作为全局实例供行为树“InstanceBT”中的节点使用。这3个变量的初始化，如下代码所示：

boolInitPlayer(){LOGI("InitPlayer : %s\n","InstanceBT");// 创建g_FirstAgent，并加载行为树“InstanceBT”g_FirstAgent=behaviac::Agent::Create<FirstAgent>();boolbRet=g_FirstAgent->btload("InstanceBT");g_FirstAgent->btsetcurrent("InstanceBT");// 创建g_SecondAgent，并将该实例赋给g_FirstAgent的成员pInstanceg_SecondAgent=behaviac::Agent::Create<SecondAgent>();g_FirstAgent->SetSecondAgent(g_SecondAgent);// 创建g_ThirdAgent，并将"SecondAgentInstance"绑定给该实例g_ThirdAgent=behaviac::Agent::Create<SecondAgent>("SecondAgentInstance");returnbRet;}

C#版

在源码包的tutorials/tutorial_3/cs/tutorial_3.cs文件中，定义了3个变量，如下代码所示：

staticFirstAgentg_FirstAgent;staticSecondAgentg_SecondAgent;staticSecondAgentg_ThirdAgent;

staticboolInitPlayer(){Console.WriteLine("InitPlayer");// 创建g_FirstAgent，并加载行为树“InstanceBT”g_FirstAgent=newFirstAgent();boolbRet=g_FirstAgent.btload("InstanceBT");Debug.Assert(bRet);g_FirstAgent.btsetcurrent("InstanceBT");// 创建g_SecondAgent，并将该实例赋给g_FirstAgent的成员pInstanceg_SecondAgent=newSecondAgent();g_FirstAgent._set_pInstance(g_SecondAgent);// 创建g_ThirdAgent，并将"SecondAgentInstance"绑定给该实例g_ThirdAgent=newSecondAgent();behaviac.Agent.BindInstance(g_ThirdAgent,"SecondAgentInstance");returnbRet;}