Actions

An action describes a function, which takes an optional argument and performs a predefined task, producing an optional result. Actions may restrict or vary the work they perform depending on the arguments they receive, which may include type introspection and runtime context.

The Airship SDK includes built-in actions for common tasks, and you can create custom actions to extend functionality.

For a complete list of available built-in actions, see the Actions User Guide.

Running Actions

Run actions programmatically with Airship.Shared.actions.RunAction. The method is asynchronous, so run it as a coroutine. The action value is passed as a JSON string, and the result is returned to the onComplete callback.

// Run an action with a value
StartCoroutine(Airship.Shared.actions.RunAction("action_name", "\"action_value\"", (string result) => {
    Debug.Log("Action result: " + result);
}));

// Run an action without a value
StartCoroutine(Airship.Shared.actions.RunAction("action_name", null, (string result) => {
    Debug.Log("Action result: " + result);
}));

To handle errors, pass an optional onError callback.

StartCoroutine(Airship.Shared.actions.RunAction(
    "action_name",
    "\"action_value\"",
    (string result) => {
        Debug.Log("Action result: " + result);
    },
    (System.Exception error) => {
        Debug.LogError("Action error: " + error.Message);
    }
));

Custom Actions

Custom actions are registered with the native iOS and Android SDKs. See the native platform documentation for details:

• iOS Actions
• Android Actions