手把手系列 API解析 【脚本解析之任务目标（Objective）】BY 月

chilled

Objective主要用在战役中的任务目标设定，这样就可以做出节奏紧凑，丰富多彩的任务体验啦。
这里主要把Objective相关的本地API介绍一下。有什么不对，请大家指出来，我们共同进步啊。
其中Example都没有添加，大家有什么好例子也可以推荐啊，谢谢。

原帖：http://bbs.sc2mod.net/read.php?tid-99.html

---

native int ObjectiveCreate3 (

textinName,

textinDescription,

int inState,

bool inVisible,

bool inPrimary

);

功能

创建一个待完成的任务目标

参数

【text inName】：任务目标的名字，显示出来的名字

【text inDescription】：任务目标的描述，鼠标上ToolTips显示的文字

【int inState】：任务目标的状态

【bool inVisible】：是否可见

【bool inPrimary】：是否是主要任务目标

返回值

【int】：创建的任务目标ID

Example

---

native int ObjectiveLastCreated ();

功能

获取最近一次创建的任务目标

参数

无

返回值

【int】：创建的任务目标ID

Example

---

native void ObjectiveDestroy (int inObjective);

功能

摧毁一个任务目标

参数

【int inObjective】：待摧毁的任务目标ID

返回值

无

Example

---

native void ObjectiveDestroyAll (playergroupinPlayers);

功能

摧毁用户组的所有任务目标

参数

【playergroup inPlayers】：用户组

返回值

无

Example

---

native void ObjectiveShow (int inObjective, playergroup inPlayers, boolinShow);

功能

显示/隐藏 某个用户组的某个任务目标

参数

【int inObjective】：待显示的任务目标ID

【playergroup inPlayers】：用户组

【bool inShow】：是否显示

返回值

无

Example

---

native bool ObjectiveVisible (int inObjective, intinPlayer);

功能

获取某个用户的某个任务目标是否被显示着

参数

【int inObjective】：待检测的任务目标ID

【int inPlayer】：用户

返回值

【true】：显示

【false】：未显示

Example

---

native void ObjectiveSetName (int inObjective, text inName);

功能

设置某个任务目标的名字

参数

【int inObjective】：要设置的任务目标ID

【text inName】：要设置的名字

返回值

无

Example

---

native text ObjectiveGetName (int inObjective);

功能

获取某个任务目标的名字

参数

【int inObjective】：任务目标ID

返回值

【text】：任务目标的名字

Example

native void ObjectiveSetDescription (int inObjective, text inText);

功能

设置某个任务目标的描述

参数

【int inObjective】：要设置的任务目标ID

【text inText】：要设置的任务目标的描述内容

返回值

无

Example

---

native text ObjectiveGetDescription (intinObjective);

功能

获取某个任务目标的描述

参数

【int inObjective】：任务目标ID

返回值

【text】：任务目标的描述

Example

native void ObjectiveSetState (int inObjective, intinState);

功能

设置某个任务目标的状态

参数

【int inObjective】：要设置的任务目标ID

【int inState】：要设置的任务目标的状态

返回值

无

Example

---

native int ObjectiveGetState (int inObjective);

功能

获取某个任务目标的状态

参数

【int inObjective】：任务目标ID

返回值

【int】：任务目标的状态

Example

---

native void ObjectiveSetPlayerGroup (int inObjective, playergroup inPlayers);

功能

设置某个任务目标的用户组

参数

【int inObjective】：要设置的任务目标ID

【playergroup inPlayers】：要设置的任务目标的用户组

返回值

无

Example

---

native playergroup ObjectiveGetPlayerGroup (intinObjective);

功能

获取某个任务目标的用户组

参数

【int inObjective】：任务目标ID

返回值

【playergroup】：任务目标的用户组

Example

---

native void ObjectiveSetPrimary (int inObjective, boolinPrimary);

功能

设置某个任务目标是否主要任务目标

参数

【int inObjective】：要设置的任务目标ID

【bool inPrimary】：任务目标是否是主要任务目标

返回值

无

Example

---

native bool ObjectiveGetPrimary (int inObjective);

功能

获取某个任务目标是否是主要任务目标

参数

【int inObjective】：任务目标ID

返回值

【true】：任务目标是主要任务

【false】：任务目标不是主要任务

Example

---

jpg

还以为是视频呢，
“手把手”。

我只是个马甲

大概素还米完成。正在制作中吧……

chilled

计划是先把API讲解一边，然后才是例程。否则做出来教程的基础可能会不好。

cccty1l

哎？LS呢？

啊啊，我说什么好。不要突然删贴啊喂。

灵魂仲裁者

寒心那个组织 这个我们听起来终于米有精神分裂的感觉了