ActionManager 类型

模块: cc

cc.ActionManager 是可以管理动作的单例类。
通常你并不需要直接使用这个类，99%的情况您将使用 CCNode 的接口。
但也有一些情况下，您可能需要使用这个类。
例如：

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

索引

方法

• addAction 增加一个动作，同时还需要提供动作的目标对象，目标对象是否暂停作为参数。
  如果目标已存在，动作将会被直接添加到现有的节点中。
  如果目标不存在，将为这一目标创建一个新的实例，并将动作添加进去。
  当目标状态的 paused 为 true，动作将不会被执行
• removeAllActions 移除所有对象的所有动作。
• removeAllActionsFromTarget 移除指定对象上的所有动作。
  属于该目标的所有的动作将被删除。
• removeAction 移除指定的动作。
• removeActionByTag 删除指定对象下特定标签的一个动作，将删除首个匹配到的动作。
• getActionByTag 通过目标对象和标签获取一个动作。
• getNumberOfRunningActionsInTarget 返回指定对象下所有正在运行的动作数量。
  组合动作被算作一个动作。
  例如：
  
  • 如果您正在运行 7 个动作组成的序列动作（Sequence），这个函数将返回 1。
    
  • 如果你正在运行 2 个序列动作（Sequence）和 5 个普通动作，这个函数将返回 7。
    
• pauseTarget 暂停指定对象：所有正在运行的动作和新添加的动作都将会暂停。
• resumeTarget 让指定目标恢复运行。在执行序列中所有被暂停的动作将重新恢复运行。
• pauseAllRunningActions 暂停所有正在运行的动作，返回一个包含了那些动作被暂停了的目标对象的列表。
• resumeTargets 让一组指定对象恢复运行（用来逆转 pauseAllRunningActions 效果的便捷函数）。
• pauseTargets 暂停一组指定对象。
• purgeSharedManager 清除共用的动作管理器。它释放了持有的实例。
  因为它使用 this，因此它不能是静态的。
• update ActionManager 主循环。

Details

方法

addAction

增加一个动作，同时还需要提供动作的目标对象，目标对象是否暂停作为参数。
如果目标已存在，动作将会被直接添加到现有的节点中。
如果目标不存在，将为这一目标创建一个新的实例，并将动作添加进去。
当目标状态的 paused 为 true，动作将不会被执行

参数列表

• action Action
• target Node
• paused Boolean

removeAllActions

移除所有对象的所有动作。

removeAllActionsFromTarget

移除指定对象上的所有动作。
属于该目标的所有的动作将被删除。

参数列表

• target Node
• forceDelete Boolean

removeAction

移除指定的动作。

参数列表

• action Action

removeActionByTag

删除指定对象下特定标签的一个动作，将删除首个匹配到的动作。

参数列表

• tag Number
• target Node

getActionByTag

通过目标对象和标签获取一个动作。

参数列表

• tag Number
• target Node

getNumberOfRunningActionsInTarget

返回指定对象下所有正在运行的动作数量。
组合动作被算作一个动作。
例如：

• 如果您正在运行 7 个动作组成的序列动作（Sequence），这个函数将返回 1。
  
• 如果你正在运行 2 个序列动作（Sequence）和 5 个普通动作，这个函数将返回 7。
  

参数列表

• target Node

pauseTarget

暂停指定对象：所有正在运行的动作和新添加的动作都将会暂停。

参数列表

• target Node

resumeTarget

让指定目标恢复运行。在执行序列中所有被暂停的动作将重新恢复运行。

参数列表

• target Node

pauseAllRunningActions

暂停所有正在运行的动作，返回一个包含了那些动作被暂停了的目标对象的列表。

resumeTargets

让一组指定对象恢复运行（用来逆转 pauseAllRunningActions 效果的便捷函数）。

参数列表

• targetsToResume Array

pauseTargets

暂停一组指定对象。

参数列表

• targetsToPause Array

purgeSharedManager

清除共用的动作管理器。它释放了持有的实例。
因为它使用 this，因此它不能是静态的。

update

ActionManager 主循环。

参数列表

• dt Number delta time in seconds