cocos代码研究（11）ActionManager类学习笔记

时间：2024-06-09 09:06:38

理论部分

ActionManager是一个单例类，管理所有动作。 通常你不需要直接使用这个类。大多情况下，你将使用Node的接口，它提供了更友好的封装 但也有一些情况下，你可能需要使用这个单例。 示例:

  • 当你想要运行一个动作，但目标不是节点类型。
  • 当你想要暂停/恢复动作。

代码部分

void addAction (Action *action, Node *target, bool paused)
增加一个动作，同时还需要提供动作的目标对象，目标对象是否暂停作为参数。当目标状态paused为true，动作将不会被执行。

实例：

    auto director = Director::getInstance();

    director->getActionManager()->addAction(action, grossini, true);

void removeAllActions ()
删除所有目标对象的所有动作。

void removeAllActionsFromTarget (Node *target)
从一个特定的目标删除所有动作。 属于该目标的所有的动作将被删除。

void removeAction (Action *action)
删除一个动作。

void removeActionByTag (int tag, Node *target)
删除目标对象下特定标签标记的一个动作，将删除首个匹配到的动作。

void removeAllActionsByTag (int tag, Node *target)
删除目标对象下特定标签标记的所有动作。

void removeActionsByFlags (unsigned int flags, Node *target)
删除目标对象下特定标记组动作

Action * getActionByTag (int tag, const Node *target) const
通过目标对象和标签获取一个动作。

ssize_t getNumberOfRunningActionsInTarget (const Node *target) const
返回指定目标下所有正在运行的动作数量。 组合动作被算作一个动作。例子:

ssize_t numberOfRunningActionsInTarget (Node *target) const
void pauseTarget (Node *target)
暂停目标对象：所有正在运行的动作和新添加的动作都将会暂停。

void resumeTarget (Node *target)
让目标对象恢复运行。在执行序列中所有被暂停的动作将重新恢复运行。

实例：

    auto director = Director::getInstance();

    director->getActionManager()->resumeTarget(node);

Vector< Node * > pauseAllRunningActions ()
暂停所有正在运行的动作，返回一个动作被暂停的目标对象列表。

void resumeTargets (const Vector< Node * > &targetsToResume)
让一组目标对象恢复运行。

相关文章