RSDTaskViewController

The delegate for the task view controller.

Initializer for initializing using a XIB file.

Initializer for initializing from a storyboard or restoring from shutdown by the OS.

Initializer for initializing a view controller that is not associated with a storyboard or nib.

Initializer for initializing a view controller that is not associated with a storyboard or nib.

Initializer for initializing a view controller that is not associated with a storyboard or nib.

Main entry for vending an appropriate step view controller for a given step.

This method will look for a step view controller in the following order:

1. Call the delegate method taskViewController(:, viewControllerForStep stepModel:) and return the view controller supplied by that method. This will throw an exception if the delegate does not return a view controller that conforms to the RSDStepController protocol and inherits from UIViewController.
2. If the given step implements the RSDThemedUIStep protocol and returns a viewTheme, then call instantiateViewController(with viewTheme:) to instantiate a view controller for this step.
3. If the given step implements the RSDStepViewControllerVendor protocol and returns a non-nil instance of a view controller, then that will be returned.
4. If none of the functions listed above returns a view controller then return the view controller instantiated by calling vendDefaultViewController(for step:, with parent:).

Instantiate a step view controller using the given view theme element.

This is the default factory method for vending a view controller appropriate to a given step. This method is the fall-through for viewController(for step:).

The view controller vended is a drop-through with the following conditions:

1. If the step implements the RSDTaskInfoStep protocol then instantiate a RSDTaskInfoStepViewController.
2. If step.stepType == .countdown then instantiate a RSDCountdownStepViewController.
3. If the step implements the RSDActiveUIStep protocol, duration > 0, and the step includes the command for RSDActiveUIStepCommand.transitionAutomatically then instantiate a RSDActiveStepViewController.
4. If RSDTableStepViewController.doesSupport() returns true then instantiate a RSDTableStepViewController
5. Otherwise, instantiate a DebugStepViewController to be used during development as a placeholder.

Main entry for vending an appropriate async action controller for a given configuration.

This method will look for an async action controller in the following order:

1. Call the delegate method taskViewController(:, asyncActionFor configuration:) and return the controller supplied by that method.
2. If the given configuration implements the RSDAsyncActionVendor protocol and returns a non-nil instance of a controller, then that will be returned.
3. Otherwise, return the controller instantiated by calling vendDefaultAsyncActionController(for step:).

This is the default factory method for vending an async action controller appropriate to a given configuration. This method is the fall-through for asyncAction(for configuration:).

The base class will return nil, but this is provided to allow a subclass of RSDTaskViewController to vend an async action controller.

Handle a failure of the async action controller.

The default implementation will record an error result to the task results and then remove the controller from the list of controllers being managed by the task view controller.

If this is a background task that should be stopped on interrupt, then that error will stop the task.

Cancel all the async action controllers being managed by this task controller.

A mutable path object used to track the current state of a running task.

Returns a list of the async action controllers that are currently active. This includes controllers that are requesting permissions, starting, running, and stopping.

Show a loading state while fetching the given task from the task info.

Fired when the task controller is ready to go forward. This method must invoke the goForward() method either to go forward automatically or else go forward after a user action.

Hide the loading state if currently showing it.

Navigate to the next step from the previous step in the given direction.

Failed to fetch the task from the current task path. Handle the error. A retry can be fired by calling goForward().

The task has completed, either as a result of all the steps being completed or because of an early exit.

This method is called when a task result is ready for upload, save, archive, etc. This method will be called when either (a) the task is ready to dismiss or (b) when the task is displaying the last completion step.

Add async action controllers to the shared queue for the given configuations. It is up to the task controller to decide how to create the controllers and how to manage adding them to the currentStepController array.

The async actions should not be started. Instead they should be returned with idle status.

Start the async action controllers. The protocol extension calls this method when an async action should be started directly after the step is presented.

The task controller needs to handle blocking any navigation changes until the async controllers are ready to proceed. Otherwise, the modal popup alert can be swallowed by the step change.

Stop the async action controllers. The protocol extension does not directly implement stopping the async actions to allow customization of how the results are added to the task and whether or not forward navigation should be blocked until the completion handler is called. When the stop action is called, the view controller needs to handle stopping the controllers, adding the results, and showing a loading state until ready to move forward in the task navigation.

The container view for the loading indicator.

Show a loading view. Default implementation calls showStandardLoadingView() on the RSDLoadingViewControllerProtocol extension.

The page view controller used to control the view controller navigation.

This is a work-around to not being able to hook up child view controllers via the storyboard IBOutlet. The method is called in viewDidLoad to see if there is already a view controller of the expected type that is included in the storyboard or nib that was used to create this view controller.

This method will add a page view controller in the instance where this view controller was loaded without one. The method is called in viewDidLoad if findPageViewController returns nil. This method should instantiate a view controller and add it to this view controller as a child view controller.

Override viewDidLoad() to set up the page view controller.

Override viewWillAppear() to start the task if needed.

Returns the currently active step controller (if any).

Respond to a gesture to go back. Always returns nil but will call goBack() if appropriate.

Respond to a gesture to go forward. Always returns nil but will call goForward() if appropriate.

The current background task may be a subtask for the case where a group of tasks are being run together as a flow that combines other tasks.

Start the background audio session if needed.