Reference UrsIntent
Note:
Since Android 10, the FlagNewTask property must be set to true.
Properties
The ActionType specifies which action is triggered with the Intent:
- None: Nothing happens when the notification or the action button is tapped.
- Screen: When the notification is tapped, the designated screen of the app opens.
- Launcher: Tapping the notification will open any app. See also the ActivityStarter documentation at App Inventor.
- Event: The event UrsNotification.OnClick is triggered.
- GoBack: The notification panel closes and the system returns to the last app you ran.
The intents for the OnClick event can be differentiated using the ID property. If you want to use the OnClick event for a notification with action buttons, a different UrsIntent instance, which at least differs in ID, must be applied to the actual notification and to each action button. The ID of the associated UrsIntent instance is published by the OnClick event.
The other fields are only evaluated for ActionType Screen or Launcher. The column S marks fields that are relevant for the ActionType Screen, the column L those for the ActionType Launcher.
| Name | Type | S | L | Functionality | Default |
|---|---|---|---|---|---|
| ActionType | choice (Designer only) |
X | X | Specifies the type of action. Possible values are None, Screen, Launcher, Event or GoBack. Different fields are evaluated depending on the ActionType. | None |
| ActivityAction | text | - | X | Specifies the action that will be used to start the Activity. | -none- |
| ActivityClass | text | - | X | Specifies the class part of the specific component that will be started. ActivityPackage and ActivityClass define the Activity to be started when the notification is tapped. |
-none- |
| ActivityPackage | text | - | X | Specifies the class part of the specific component that will be started. ActivityPackage and ActivityClass define the Activity to be started when the notification is tapped. |
-none- |
| DataType | text | - | X | Specifies the MIME type to pass to the Activity. | -none- |
| DataUri | text | - | X | Specifies the data URI that will be used to start the activity. | -none- |
| FlagClearTask | boolean | X | X | This flag will cause any existing task that would be associated with the activity to be cleared before the activity is started. | false |
| FlagClearTop | boolean | X | X | If set, and the Activity being launched is already running in the current Task, then instead of launching a new instance of that Activity, all of the other activities on top of it will be closed and this Intent will be delivered to the (now on top) old Activity as a new Intent. | false |
| FlagExcludeFromRecent | boolean | X | X | If set, the new Activity is not kept in the list of recently launched activities. | false |
| FlagNewTask | boolean | X | X | If set, this
Activity
will become the start of a new
Task on this history stack. Since Android 10 this flag must be set to true. |
false |
| FlagNoAnimation | boolean | X | X | This flag will prevent the system from applying an Activity transition animation to go to the next activity state. | false |
| FlagNoHistory | boolean | X | X | If set, the new Activity is not kept in the history stack. As soon as the user navigates away from it, the activity is finished. | false |
| FlagPreviousIsTop | boolean | X | X | If set and this Intent is being used to launch a new Activity from an existing one, the current Activity will not be counted as the top Activity for deciding whether the new Intent should be delivered to the top instead of starting a new one. The previous Activity will be used as the top, with the assumption being that the current Activity will finish itself immediately | false |
| FlagReorderToFront | boolean | X | X | This flag will cause the launched Activity to be brought to the front of its task's history stack if it is already running. | false |
| FlagResetTaskIfNeeded | boolean | X | X | If set, and this Activity is either being started in a new Task or bringing to the top an existing Task, then it will be launched as the front door of the Task. This will result in the application of any affinities needed to have that Task in the proper state (either moving activities to or from it), or simply resetting that task to its initial state if needed. | false |
| FlagSingleTop | boolean | X | X | If set, the Activity will not be launched if it is already running at the top of the history stack. | false |
| FlagTaskOnHome | boolean | X | X | This flag will cause a newly launching task to be placed on top of the current home activity task (if there is one). That is, pressing back from the task will always return the user to home even if that was not the last activity they saw. This can only be used in conjunction with FLAG_ACTIVITY_NEW_TASK. | false |
| ID | text | X | X | Unique ID of this Intent. | -none- |
| ScreenStartValue | text | X | - | The start value to be transferred to the Screen to be
opened. Available via Control.getStartValue
 . |
-none- |
| ScreenToOpen | text | X | - | The name of the Screen to open when you tap the notification. | "Screen1" |