Instance Method

runAction:forKey:completionHandler:

Adds an identifiable action to the list of actions executed by the node. SceneKit calls the specified block when the action completes.

Required.

Declaration

- (void)runAction:(SCNAction *)action forKey:(NSString *)key completionHandler:(void (^)(void))block;

Parameters

action

The action to be performed.

key

A unique key used to identify the action.

block

A completion block called when the action completes.

Discussion

This method is identical to runAction:completionHandler:, but the action is stored and identified so that you can retrieve or cancel it later. If an action using the same key is already running, SceneKit removes it before adding the new action.

SceneKit calls your block after the action’s duration is complete. For example, you can use this method with a wait action to execute some code after a timed delay. If during the delay period you need to prevent the code from running, use the removeActionForKey: method to cancel it.

See Also

Running Actions

- runAction:

Adds an action to the list of actions executed by the node.

Required.

- runAction:completionHandler:

Adds an action to the list of actions executed by the node. SceneKit calls the specified block when the action completes.

Required.

- runAction:forKey:

Adds an identifiable action to the list of actions executed by the node.

Required.