Skip to content

Actors

When you run a statechart, it becomes an actor: a running process that can receive messages, send messages and change its behavior based on the messages it receives, which can cause effects outside of the actor.

An invoked actor is an actor that can execute its own actions and communicate with the machine. These invoked actors are started in a state and stopped when the state is exited.

Invoked actors are are labeled on their invoking state with ā€œInvoke /ā€ followed by the actorā€™s source name and ID.

You can invoke multiple actors on a single state. Top-level final states cannot have invoked actors.

Video player state machine containing closed and opened states. On the Play event, the Closed state transitions to the Opened state. The Opened state invokes a startVideo actor and has a description of ā€œThe video player should be in full-screen mode.ā€ The Opened state contains Playing and Paused states, which are transitioned between using the Pause and Play events. Thereā€™s a Stop event from the Opened state that transitions to the final state of Stopped. Thereā€™s a delayed transition from the Stopped state back to the Closed state after 5 seconds.Video player state machine containing closed and opened states. On the Play event, the Closed state transitions to the Opened state. The Opened state invokes a startVideo actor and has a description of ā€œThe video player should be in full-screen mode.ā€ The Opened state contains Playing and Paused states, which are transitioned between using the Pause and Play events. Thereā€™s a Stop event from the Opened state that transitions to the final state of Stopped. Thereā€™s a delayed transition from the Stopped state back to the Closed state after 5 seconds.

View this machine in the Stately Studio.

In the video player above, theĀ startVideoĀ actor is invoked when the video player is in theĀ OpenedĀ state.

Invoke actors on a stateā€‹

  1. Select the state you want to invoke an actor.
  2. Open theĀ State detailsĀ panel from the right tool menu.
  3. Use theĀ +Ā plus icon alongside theĀ Invoked actorsĀ to add a new action.
  4. Add the source for the actor using theĀ srcĀ textĀ input.
  5. Add the ID for the actor using theĀ IDĀ text input.
  6. Save the invoked actor using theĀ SaveĀ button.