# Titanium.Android
> The top-level Android module.
- Source: https://titaniumsdk.com/docs/sdk/12.5.0/Titanium.Android
- Titanium SDK version: 12.5.0
- Kind: module
- Platforms: Android
- Since: Titanium SDK 1.5
- Extends: Titanium.Module
- Inheritance: Titanium.Module > Titanium.Proxy
The Android module allows the application to manage various Android components.
#### Action Bar
An action bar is a UI feature that identifies the application and user location, and
provides user actions and navigation modes.
The Titanium SDK lets you customize the look of the action bar and add action items.
Action items are added using the [Titanium.Android.Menu](https://titaniumsdk.com/docs/sdk/Titanium.Android.Menu.md) API.
For more information about the action bar, see the
[Titanium.Android.ActionBar API reference](https://titaniumsdk.com/docs/sdk/Titanium.Android.ActionBar.md).
#### Activities
An Android application is made up of one or more activities. Each activity represents a single screen
with a user interface.
In Titanium, each `Window` or `TabGroup` has its own activity. The application
can access the activity of a `Window` and `TabGroup` object and monitor its lifecycle events.
Titanium also lets you launch new activities by creating intents to launch them.
See the "Intents" section below.
For more information about activities, see the
[Titanium.Android.Activity API reference](https://titaniumsdk.com/docs/sdk/Titanium.Android.Activity.md).
#### Broadcast Intents and Receivers
Broadcast Intents allow your application to send out a message to any application that sets up
a Broadcast Receiver to listen to it. Your application can also register Broadcast Receivers
to listen to system events sent by the Android OS, such as low battery warnings or airplane
mode changes.
For more information about broadcasts, see the
[Android Broadcast Intents and Receivers guide](https://titaniumsdk.com/guide/Titanium_SDK/Titanium_SDK_How-tos/Platform_API_Deep_Dives/Android_API_Deep_Dives/Android_Broadcast_Intents_and_Receivers.html)
and [Titanium.Android.BroadcastReceiver API reference](https://titaniumsdk.com/docs/sdk/Titanium.Android.BroadcastReceiver.md).
#### Intents
Intents are message objects that specify actions to perform which can start either activities,
broadcasts or services.
For more information about intents, see the
[Titanium.Android.Intent API reference](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md).
#### Intent Filters
Intent Filters advertise to the Android OS that your application handles certain actions and
data types. For example, when another application wants to share an image or text, your application
can define intent filters to let Android know your application can handle those data types.
For more information about intent filters, see the
[Android Intent Filters guide](https://titaniumsdk.com/guide/Titanium_SDK/Titanium_SDK_How-tos/Platform_API_Deep_Dives/Android_API_Deep_Dives/Android_Intent_Filters.html).
#### Notifications
Notifications alert the user that something is happening to your application while it is
in the background. Notifications appear in the notification drawer until the user
clears them and on the lock screen for devices running Android 5.0 or greater.
Note that the user can filter or turn notifications on and off from **Settings**.
For more information about notifications, see the
[Titanium.Android.Notification API reference](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md).
For Android toast notifications (pop-up notifications sent while the application is in the
foreground), see [Titanium.UI.Notification](https://titaniumsdk.com/docs/sdk/Titanium.UI.Notification.md).
#### Options Menu
The options menu is a feature of older Android devices (prior to Android 3.0 (API 11)), and has been
replaced by the action bar. The options menu is accessed by pressing the **Menu** and presents
a pop-up menu of options the user can execute.
The `Titanium.Android.Menu` API is used to construct both the options menu and action items for
the action bar.
For more information about the options menu, see the
[Titanium.Android.Menu API reference](https://titaniumsdk.com/docs/sdk/Titanium.Android.Menu.md).
#### Services
A service is a component started by an application that runs in the background. The service
does not have any application UI associated with it, so the user does not directly interact
with it, only your application.
The Titanium SDK gives you the ability to write your own Android Services using JavaScript.
The service executes your JavaScript code at intervals you specify. Note that the service
will stop running when you back out of the app. So, if you want the service to continue running,
then it's recommended that you set the root window's [exitOnClose](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md#exitOnClose)
property to `false` so that the window will persist in the background like iOS.
For more information about services, see the
[Titanium.Android.Service API reference](https://titaniumsdk.com/docs/sdk/Titanium.Android.Service.md).
#### Permissions
Starting from Android 6.0 (API level 23), users need to grant certain permissions to apps while the
app is running. You can read it more [here](https://developer.android.com/training/permissions/requesting.html).
Starting with Android 13 you have to use more granular media permissions. Check the [official documentation](https://developer.android.com/about/versions/13/behavior-changes-13#granular-media-permissions).
Make sure to add e.g. `` to your tiapp.xml too.
In Titanium SDK, to support this, we have the [Titanium.Android.requestPermissions](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#requestPermissions) method. It is used to
request any permission you may need. An example of using it is shown below:
``` js
var permissions = [ 'android.permission.CAMERA', 'android.permission.READ_EXTERNAL_STORAGE', 'android.permission.WRITE_EXTERNAL_STORAGE' ];
if (Ti.Platform.versionMajor >= 13) {
// example for camera and image permission on Android 13
permissions = [ 'android.permission.CAMERA', 'android.permission.READ_MEDIA_IMAGES' ]
}
Ti.Android.requestPermissions(permissions, function (e) {
if (e.success) {
Ti.API.info('SUCCESS');
} else {
Ti.API.info('ERROR: ' + e.error);
}
});
```
## Properties
### ACTION_AIRPLANE_MODE_CHANGED
- Type: String
- Platforms: Android
- Permission: read-only
User switched airplane mode on or off.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
See [Intent.ACTION_AIRPLANE_MODE_CHANGED in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_AIRPLANE_MODE_CHANGED).
### ACTION_ALL_APPS
- Type: String
- Platforms: Android
- Permission: read-only
List all applications.
Use with the [Titanium.Android.Intent.action](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md#action) property to create an **Activity Intent**.
See [Intent.ACTION_ALL_APPS in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_ALL_APPS).
### ACTION_ANSWER
- Type: String
- Platforms: Android
- Permission: read-only
Handle an incoming phone call.
Use with the [Titanium.Android.Intent.action](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md#action) property to create an **Activity Intent**.
See [Intent.ACTION_ANSWER in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_ANSWER).
### ACTION_ATTACH_DATA
- Type: String
- Platforms: Android
- Permission: read-only
Used to indicate that the data is an attachment.
Use with the [Titanium.Android.Intent.action](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md#action) property to create an **Activity Intent**.
See [Intent.ACTION_ATTACH_DATA in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_ATTACH_DATA).
### ACTION_BATTERY_CHANGED
- Type: String
- Platforms: Android
- Permission: read-only
Listen to battery state change status.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
Note that Titanium exposes battery monitoring using the [Titanium.Platform](https://titaniumsdk.com/docs/sdk/Titanium.Platform.md) API.
See [Intent.ACTION_BATTERY_CHANGED in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_BATTERY_CHANGED).
### ACTION_BATTERY_LOW
- Type: String
- Platforms: Android
- Permission: read-only
Indicates low battery condition on the device.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
Note that Titanium exposes battery monitoring using the [Titanium.Platform](https://titaniumsdk.com/docs/sdk/Titanium.Platform.md) API.
See [Intent.ACTION_BATTERY_LOW in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_BATTERY_LOW).
### ACTION_BATTERY_OKAY
- Type: String
- Platforms: Android
- Permission: read-only
Inidicates the battery is now okay after being low.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
Note that Titanium exposes battery monitoring using the [Titanium.Platform](https://titaniumsdk.com/docs/sdk/Titanium.Platform.md) API.
See [Intent.ACTION_BATTERY_OKAY in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_BATTERY_OKAY).
### ACTION_BOOT_COMPLETED
- Type: String
- Platforms: Android
- Permission: read-only
Indicates the system has finished booting.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
The application needs to also set the `android.permission.RECEIVE_BOOT_COMPLETED` permission
in the Android manifest section of the `tiapp.xml` file.
``` xml
```
See [Intent.ACTION_BOOT_COMPLETED in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_BOOT_COMPLETED).
### ACTION_BUG_REPORT
- Type: String
- Platforms: Android
- Permission: read-only
Show activity for reporting a bug.
Use with the [Titanium.Android.Intent.action](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md#action) property to create an **Activity Intent**.
See [Intent.ACTION_BUG_REPORT in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_BUG_REPORT).
### ACTION_CALL
- Type: String
- Platforms: Android
- Permission: read-only
Perform a call to someone specified by the `data` property.
Use with the [Titanium.Android.Intent.action](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md#action) property to create an **Activity Intent**.
See [Intent.ACTION_CALL in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_CALL).
### ACTION_CALL_BUTTON
- Type: String
- Platforms: Android
- Permission: read-only
User pressed the call button.
Use with the [Titanium.Android.Intent.action](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md#action) property to create an **Activity Intent**.
See [Intent.ACTION_CALL_BUTTON in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_CALL_BUTTON).
### ACTION_CAMERA_BUTTON
- Type: String
- Platforms: Android
- Permission: read-only
The camera button was pressed.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
See [Intent.ACTION_CAMERA_BUTTON in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_CAMERA_BUTTON).
### ACTION_CHOOSER
- Type: String
- Platforms: Android
- Permission: read-only
Display an activity chooser.
Use with the [Titanium.Android.Intent.action](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md#action) property to create an Activity Chooser.
You can also create an activity chooser using the [Titanium.Android.createIntentChooser](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#createIntentChooser) method.
See [Intent.ACTION_CHOOSER in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_CHOOSER).
### ACTION_CLOSE_SYSTEM_DIALOGS
- Type: String
- Platforms: Android
- Permission: read-only
User dismissed a temporary system dialog, such as the notification drawer or recent-app drawer.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
See [Intent.ACTION_CLOSE_SYSTEM_DIALOGS in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_CLOSE_SYSTEM_DIALOGS).
### ACTION_CONFIGURATION_CHANGED
- Type: String
- Platforms: Android
- Permission: read-only
The device's configuration changed.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
See [Intent.ACTION_CONFIGURATION_CHANGED in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_CONFIGURATION_CHANGED).
### ACTION_CREATE_SHORTCUT
- Type: String
- Platforms: Android
- Permission: read-only
Create a shortcut.
Use with the [Titanium.Android.Intent.action](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md#action) property to create an **Activity Intent**.
See [Intent.ACTION_CREATE_SHORTCUT in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_CREATE_SHORTCUT).
### ACTION_DATE_CHANGED
- Type: String
- Platforms: Android
- Permission: read-only
Date changed.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
See [Intent.ACTION_DATE_CHANGED in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_DATE_CHANGED).
### ACTION_DEFAULT
- Type: String
- Platforms: Android
- Permission: read-only
Default action, which is `Titanium.Android.ACTION_VIEW`
Use with the [Titanium.Android.Intent.action](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md#action) property to create an **Activity Intent**.
See [Intent.ACTION_DEFAULT in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_DEFAULT).
### ACTION_DELETE
- Type: String
- Platforms: Android
- Permission: read-only
Delete the data specified by the Intent's `data` property.
Use with the [Titanium.Android.Intent.action](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md#action) property to create an **Activity Intent**.
See [Intent.ACTION_DELETE in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_DELETE).
### ACTION_DEVICE_STORAGE_LOW
- Type: String
- Platforms: Android
- Permission: read-only
Indicates a low memory condition on the device.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
See [Intent.ACTION_DEVICE_STORAGE_LOW in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_DEVICE_STORAGE_LOW).
### ACTION_DIAL
- Type: String
- Platforms: Android
- Permission: read-only
Dial a number specified by the Intent's `data` property.
Use with the [Titanium.Android.Intent.action](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md#action) property to create an **Activity Intent**.
See [Intent.ACTION_DIAL in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_DIAL).
### ACTION_EDIT
- Type: String
- Platforms: Android
- Permission: read-only
Provide editable access to the data specified by the Intent's `data` property.
Use with the [Titanium.Android.Intent.action](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md#action) property to create an **Activity Intent**.
See [Intent.ACTION_EDIT in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_EDIT).
### ACTION_GET_CONTENT
- Type: String
- Platforms: Android
- Permission: read-only
Allow the user to select a particular kind of data specified by the Intent's `type` property.
Use with the [Titanium.Android.Intent.action](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md#action) property to create an **Activity Intent**.
See [Intent.ACTION_GET_CONTENT in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_GET_CONTENT).
### ACTION_GTALK_SERVICE_CONNECTED
- Type: String
- Platforms: Android
- Permission: read-only
GTalk connection has been established.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
See [Intent.ACTION_GTALK_SERVICE_CONNECTED in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_GTALK_SERVICE_CONNECTED).
### ACTION_GTALK_SERVICE_DISCONNECTED
- Type: String
- Platforms: Android
- Permission: read-only
GTalk connection has been disconnected.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
See [Intent.ACTION_GTALK_SERVICE_DISCONNECTED in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_GTALK_SERVICE_DISCONNECTED).
### ACTION_HEADSET_PLUG
- Type: String
- Platforms: Android
- Permission: read-only
A wired headset has been plugged in or unplugged.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
See [Intent.ACTION_HEADSET_PLUG in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_HEADSET_PLUG).
### ACTION_INPUT_METHOD_CHANGED
- Type: String
- Platforms: Android
- Permission: read-only
An input method has been changed.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
See [Intent.ACTION_INPUT_METHOD_CHANGED in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_INPUT_METHOD_CHANGED).
### ACTION_INSERT
- Type: String
- Platforms: Android
- Permission: read-only
Insert an empty item into the given container.
Use with the [Titanium.Android.Intent.action](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md#action) property to create an **Activity Intent**.
See [Intent.ACTION_INSERT in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_INSERT).
### ACTION_INSERT_OR_EDIT
- Type: String
- Platforms: Android
- Permission: read-only
Pick an existing item or insert an empty item, then edit it.
Use with the [Titanium.Android.Intent.action](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md#action) property to create an **Activity Intent**.
See [Intent.ACTION_INSERT_OR_EDIT in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_INSERT_OR_EDIT).
### ACTION_MAIN
- Type: String
- Platforms: Android
- Permission: read-only
Start as the main entry point.
Use with the [Titanium.Android.Intent.action](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md#action) property to create an **Activity Intent**.
See [Intent.ACTION_MAIN in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_MAIN).
### ACTION_MANAGE_PACKAGE_STORAGE
- Type: String
- Platforms: Android
- Permission: read-only
Indicates low memory condition notification acknowledged by user and package management should be started.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
See [Intent.ACTION_MANAGE_PACKAGE_STORAGE in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_MANAGE_PACKAGE_STORAGE).
### ACTION_MEDIA_BAD_REMOVAL
- Type: String
- Platforms: Android
- Permission: read-only
External media was removed from SD card slot, but mount point was not unmounted.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
See [Intent.ACTION_MEDIA_BAD_REMOVAL in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_MEDIA_BAD_REMOVAL).
### ACTION_MEDIA_BUTTON
- Type: String
- Platforms: Android
- Permission: read-only
The media button was pressed.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
See [Intent.ACTION_MEDIA_BUTTON in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_MEDIA_BUTTON).
### ACTION_MEDIA_CHECKING
- Type: String
- Platforms: Android
- Permission: read-only
External media is present and being disk-checked.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
See [Intent.ACTION_MEDIA_CHECKING in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_MEDIA_CHECKING).
### ACTION_MEDIA_EJECT
- Type: String
- Platforms: Android
- Permission: read-only
User has expressed the desire to remove the external storage media.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
Applications should close all files they have open within the mount point when they receive this intent.
See [Intent.ACTION_MEDIA_EJECT in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_MEDIA_EJECT).
### ACTION_MEDIA_MOUNTED
- Type: String
- Platforms: Android
- Permission: read-only
External media is present and mounted at its mount point.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
See [Intent.ACTION_MEDIA_MOUNTED in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_MEDIA_MOUNTED).
### ACTION_MEDIA_NOFS
- Type: String
- Platforms: Android
- Permission: read-only
External media is present, but is using an incompatible filesystem or is blank.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
See [Intent.ACTION_MEDIA_NOFS in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_MEDIA_NOFS).
### ACTION_MEDIA_REMOVED
- Type: String
- Platforms: Android
- Permission: read-only
External media has been removed.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
See [Intent.ACTION_MEDIA_REMOVED in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_MEDIA_REMOVED).
### ACTION_MEDIA_SCANNER_FINISHED
- Type: String
- Platforms: Android
- Permission: read-only
The media scanner has finished scanning a directory.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
See [Intent.ACTION_MEDIA_SCANNER_FINISHED in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_MEDIA_SCANNER_FINISHED).
### ACTION_MEDIA_SCANNER_SCAN_FILE
- Type: String
- Platforms: Android
- Permission: read-only
Request the media scanner to scan a file and add it to the media database.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
See [Intent.ACTION_MEDIA_SCANNER_SCAN_FILE in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_MEDIA_SCANNER_SCAN_FILE).
### ACTION_MEDIA_SCANNER_STARTED
- Type: String
- Platforms: Android
- Permission: read-only
The media scanner has started scanning a directory.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
See [Intent.ACTION_MEDIA_SCANNER_STARTED in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_MEDIA_SCANNER_STARTED).
### ACTION_MEDIA_SHARED
- Type: String
- Platforms: Android
- Permission: read-only
External media is unmounted because it is being shared via USB mass storage.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
See [Intent.ACTION_MEDIA_SHARED in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_MEDIA_SHARED).
### ACTION_MEDIA_UNMOUNTABLE
- Type: String
- Platforms: Android
- Permission: read-only
Corresponds to the Android `Intent.ACTION_MEDIA_UNMOUNTABLE` constant.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
See [Intent.ACTION_MEDIA_UNMOUNTABLE in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_MEDIA_UNMOUNTABLE).
### ACTION_MEDIA_UNMOUNTED
- Type: String
- Platforms: Android
- Permission: read-only
External media is present, but not mounted at its mount point.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
See [Intent.ACTION_MEDIA_UNMOUNTED in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_MEDIA_UNMOUNTED).
### ACTION_NEW_OUTGOING_CALL
- Type: String
- Platforms: Android
- Permission: read-only
An outgoing call is about to be placed.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
The application needs to also set the `android.permission.NEW_OUTGOING_CALL` permission
in the Android manifest section of the `tiapp.xml` file.
``` xml
```
See [Intent.ACTION_NEW_OUTGOING_CALL in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_NEW_OUTGOING_CALL).
### ACTION_PACKAGE_ADDED
- Type: String
- Platforms: Android
- Permission: read-only
A new application package has been installed on the device.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
See [Intent.ACTION_PACKAGE_ADDED in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_PACKAGE_ADDED).
### ACTION_PACKAGE_CHANGED
- Type: String
- Platforms: Android
- Permission: read-only
An existing application package has been changed.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
See [Intent.ACTION_PACKAGE_CHANGED in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_PACKAGE_CHANGED).
### ACTION_PACKAGE_DATA_CLEARED
- Type: String
- Platforms: Android
- Permission: read-only
The user has cleared the data of a package.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
See [Intent.ACTION_PACKAGE_DATA_CLEARED in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_PACKAGE_DATA_CLEARED).
### ACTION_PACKAGE_REMOVED
- Type: String
- Platforms: Android
- Permission: read-only
An existing application package has been removed from the device.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
See [Intent.ACTION_PACKAGE_REMOVED in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_PACKAGE_REMOVED).
### ACTION_PACKAGE_REPLACED
- Type: String
- Platforms: Android
- Permission: read-only
A new version of an application package has been installed, replacing an existing version that was previously installed.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
See [Intent.ACTION_PACKAGE_REPLACED in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_PACKAGE_REPLACED).
### ACTION_PACKAGE_RESTARTED
- Type: String
- Platforms: Android
- Permission: read-only
The user has restarted a package, and all of its processes have been killed.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
See [Intent.ACTION_PACKAGE_RESTARTED in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_PACKAGE_RESTARTED).
### ACTION_PICK
- Type: String
- Platforms: Android
- Permission: read-only
Pick an item from the directory indicated by the Intent's `data` property.
Use with the [Titanium.Android.Intent.action](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md#action) property to create an **Activity Intent**.
See [Intent.ACTION_PICK in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_PICK).
### ACTION_PICK_ACTIVITY
- Type: String
- Platforms: Android
- Permission: read-only
Pick an activity given an intent.
Use with the [Titanium.Android.Intent.action](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md#action) property to create an **Activity Intent**.
Add the activity intent using the intent's `putExtra()` method. Pass the method
`Titanium.Android.EXTRA_INTENT` as the `name` parameter and the activity intent
as the `data` parameter.
See [Intent.ACTION_PICK_ACTIVITY in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_PICK_ACTIVITY).
### ACTION_POWER_CONNECTED
- Type: String
- Platforms: Android
- Permission: read-only
External power has been connected to the device.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
See [Intent.ACTION_POWER_CONNECTED in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_POWER_CONNECTED).
### ACTION_POWER_DISCONNECTED
- Type: String
- Platforms: Android
- Permission: read-only
External power has been disconnected from the device.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
See [Intent.ACTION_POWER_DISCONNECTED in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_POWER_DISCONNECTED).
### ACTION_POWER_USAGE_SUMMARY
- Type: String
- Platforms: Android
- Permission: read-only
Show power usage information to the user.
Use with the [Titanium.Android.Intent.action](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md#action) property to create an **Activity Intent**.
See [Intent.ACTION_POWER_USAGE_SUMMARY in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_POWER_USAGE_SUMMARY).
### ACTION_PROVIDER_CHANGED
- Type: String
- Platforms: Android
- Permission: read-only
Content provider published new events or items.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
See [Intent.ACTION_PROVIDER_CHANGED in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_PROVIDER_CHANGED).
### ACTION_REBOOT
- Type: String
- Platforms: Android
- Permission: read-only
Device rebooted.
**Only used by the system.**
See [Intent.ACTION_REBOOT in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_REBOOT).
### ACTION_RUN
- Type: String
- Platforms: Android
- Permission: read-only
Run the data.
Use with the [Titanium.Android.Intent.action](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md#action) property to create an **Activity Intent**.
See [Intent.ACTION_RUN in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_RUN).
### ACTION_SCREEN_OFF
- Type: String
- Platforms: Android
- Permission: read-only
Sent when the device goes to sleep and becomes non-interactive.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
See [Intent.ACTION_SCREEN_OFF in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_SCREEN_OFF).
### ACTION_SCREEN_ON
- Type: String
- Platforms: Android
- Permission: read-only
Sent when the device wakes up and becomes interactive.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
See [Intent.ACTION_SCREEN_ON in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_SCREEN_ON).
### ACTION_SEARCH
- Type: String
- Platforms: Android
- Permission: read-only
Perform a search.
Use with the [Titanium.Android.Intent.action](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md#action) property to create an **Activity Intent**.
See [Intent.ACTION_SEARCH in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_SEARCH).
### ACTION_SEARCH_LONG_PRESS
- Type: String
- Platforms: Android
- Permission: read-only
Start action associated with long pressing on the search key.
Use with the [Titanium.Android.Intent.action](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md#action) property to create an **Activity Intent**.
See [Intent.ACTION_SEARCH_LONG_PRESS in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_SEARCH_LONG_PRESS).
### ACTION_SEND
- Type: String
- Platforms: Android
- Permission: read-only
Deliver data to another activity.
Use with the [Titanium.Android.Intent.action](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md#action) property to create an **Activity Intent**.
See [Intent.ACTION_SEND in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_SEND).
### ACTION_SEND_MULTIPLE
- Type: String
- Platforms: Android
- Permission: read-only
Deliver multiple data to another activity.
Use with the [Titanium.Android.Intent.action](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md#action) property to create an **Activity Intent**.
See [Intent.ACTION_SEND_MULTIPLE in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_SEND_MULTIPLE).
### ACTION_SENDTO
- Type: String
- Platforms: Android
- Permission: read-only
Deliver data to the recipient specified by the Intent's `data` property.
Use with the [Titanium.Android.Intent.action](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md#action) property to create an **Activity Intent**.
See [Intent.ACTION_SENDTO in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_SENDTO).
### ACTION_SET_WALLPAPER
- Type: String
- Platforms: Android
- Permission: read-only
Show settings for choosing the system wallpaper.
Use with the [Titanium.Android.Intent.action](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md#action) property to create an **Activity Intent**.
See [Intent.ACTION_SET_WALLPAPER in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_SET_WALLPAPER).
### ACTION_SHUTDOWN
- Type: String
- Platforms: Android
- Permission: read-only
Device is shutting down.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
See [Intent.ACTION_SHUTDOWN in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_SHUTDOWN).
### ACTION_SYNC
- Type: String
- Platforms: Android
- Permission: read-only
Perform data synchronization.
Use with the [Titanium.Android.Intent.action](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md#action) property to create an **Activity Intent**.
See [Intent.ACTION_SYNC in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_SYNC).
### ACTION_SYSTEM_TUTORIAL
- Type: String
- Platforms: Android
- Permission: read-only
Start the platform-defined tutorial.
Use with the [Titanium.Android.Intent.action](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md#action) property to create an **Activity Intent**.
See [Intent.ACTION_SYSTEM_TUTORIAL in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_SYSTEM_TUTORIAL).
### ACTION_TIME_CHANGED
- Type: String
- Platforms: Android
- Permission: read-only
The time was set.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
See [Intent.ACTION_TIME_CHANGED in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_TIME_CHANGED).
### ACTION_TIME_TICK
- Type: String
- Platforms: Android
- Permission: read-only
The current time changed. Sent every minute.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
See [Intent.ACTION_TIME_TICK in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_TIME_TICK).
### ACTION_UID_REMOVED
- Type: String
- Platforms: Android
- Permission: read-only
A user ID was removed from the system.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
See [Intent.ACTION_UID_REMOVED in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_UID_REMOVED).
### ACTION_USER_PRESENT
- Type: String
- Platforms: Android
- Permission: read-only
Sent when the user is present after device wakes up.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
See [Intent.ACTION_USER_PRESENT in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_USER_PRESENT).
### ACTION_VIEW
- Type: String
- Platforms: Android
- Permission: read-only
Display data to the user.
Use with the [Titanium.Android.Intent.action](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md#action) property to create an **Activity Intent**.
See [Intent.ACTION_VIEW in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_VIEW).
### ACTION_VOICE_COMMAND
- Type: String
- Platforms: Android
- Permission: read-only
Start voice command.
Use with the [Titanium.Android.Intent.action](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md#action) property to create an **Activity Intent**.
See [Intent.ACTION_VOICE_COMMAND in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_VOICE_COMMAND).
### ACTION_WALLPAPER_CHANGED
- Type: String
- Platforms: Android
- Requires: Android ≤4.1
- Permission: read-only
The current system wallpaper has changed.
Pass to the [Titanium.Android.registerBroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#registerBroadcastReceiver) method to listen to the system broadcast.
See [Intent.ACTION_WALLPAPER_CHANGED in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_WALLPAPER_CHANGED).
### ACTION_WEB_SEARCH
- Type: String
- Platforms: Android
- Permission: read-only
Perform a web search.
Use with the [Titanium.Android.Intent.action](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md#action) property to create an **Activity Intent**.
See [Intent.ACTION_WEB_SEARCH in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_WEB_SEARCH).
### CATEGORY_ALARM
- Type: String
- Platforms: Android
- Since: Titanium SDK 3.6.0
- Permission: read-only
Notification category indicating an alarm or timer.
Use with the [Titanium.Android.Notification.category](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#category) property.
See [Notification.CATEGORY_ALARM in the Android API Reference](https://developer.android.com/reference/android/app/Notification.html#CATEGORY_ALARM).
### CATEGORY_ALTERNATIVE
- Type: String
- Platforms: Android
- Permission: read-only
Set if the activity should be considered as an alternative action to the data the user is currently viewing.
Pass to the Intent's [addCategory()](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md#addCategory) method to set a category.
See [Intent.CATEGORY_ALTERNATIVE in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#CATEGORY_ALTERNATIVE).
### CATEGORY_BROWSABLE
- Type: String
- Platforms: Android
- Permission: read-only
Activity can browse the Internet.
Pass to the Intent's [addCategory()](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md#addCategory) method to set a category.
The `Titanium.Android.ACTION_MAIN` constant must also be set in the intent's `action` property.
See [Intent.CATEGORY_BROWSABLE in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#CATEGORY_BROWSABLE).
### CATEGORY_CALL
- Type: String
- Platforms: Android
- Since: Titanium SDK 3.6.0
- Permission: read-only
Notification category indicating an incoming call (voice or video) or similar synchronous
communication request.
Use with the [Titanium.Android.Notification.category](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#category) property.
See [Notification.CATEGORY_CALL in the Android API Reference](https://developer.android.com/reference/android/app/Notification.html#CATEGORY_CALL).
### CATEGORY_DEFAULT
- Type: String
- Platforms: Android
- Permission: read-only
Activity should be used as the default action to perform on a piece of data.
Pass to the Intent's [addCategory()](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md#addCategory) method to set a category.
See [Intent.CATEGORY_DEFAULT in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#CATEGORY_DEFAULT).
### CATEGORY_DEVELOPMENT_PREFERENCE
- Type: String
- Platforms: Android
- Permission: read-only
Activity is in the development preference panel.
Pass to the Intent's [addCategory()](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md#addCategory) method to set a category.
See [Intent.CATEGORY_DEVELOPMENT_PREFERENCE in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#CATEGORY_DEVELOPMENT_PREFERENCE).
### CATEGORY_EMAIL
- Type: String
- Platforms: Android
- Since: Titanium SDK 3.6.0
- Permission: read-only
Notification category indicating an asynchronous bulk message (email).
Use with the [Titanium.Android.Notification.category](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#category) property.
See [Notification.CATEGORY_EMAIL in the Android API Reference](https://developer.android.com/reference/android/app/Notification.html#CATEGORY_EMAIL).
### CATEGORY_EMBED
- Type: String
- Platforms: Android
- Permission: read-only
Activity can run inside a parent activity.
See [Intent.CATEGORY_EMBED in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#CATEGORY_EMBED).
### CATEGORY_ERROR
- Type: String
- Platforms: Android
- Since: Titanium SDK 3.6.0
- Permission: read-only
Notification category indicating an error in background operation or authentication status.
Use with the [Titanium.Android.Notification.category](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#category) property.
See [Notification.CATEGORY_ERROR in the Android API Reference](https://developer.android.com/reference/android/app/Notification.html#CATEGORY_ERROR).
### CATEGORY_EVENT
- Type: String
- Platforms: Android
- Since: Titanium SDK 3.6.0
- Permission: read-only
Notification category indicating a calendar event.
Use with the [Titanium.Android.Notification.category](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#category) property.
See [Notification.CATEGORY_EVENT in the Android API Reference](https://developer.android.com/reference/android/app/Notification.html#CATEGORY_EVENT).
### CATEGORY_FRAMEWORK_INSTRUMENTATION_TEST
- Type: String
- Platforms: Android
- Permission: read-only
To be used as test code for framework instrumentation tests.
See [Intent.CATEGORY_FRAMEWORK_INSTRUMENTATION_TEST in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#CATEGORY_FRAMEWORK_INSTRUMENTATION_TEST).
### CATEGORY_HOME
- Type: String
- Platforms: Android
- Permission: read-only
Home activity, the first activity that is displayed when the device boots.
Pass to the Intent's [addCategory()](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md#addCategory) method to set a category.
See [Intent.CATEGORY_HOME in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#CATEGORY_HOME).
### CATEGORY_INFO
- Type: String
- Platforms: Android
- Permission: read-only
Provides information about the package it is in.
Pass to the Intent's [addCategory()](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md#addCategory) method to set a category.
See [Intent.CATEGORY_INFO in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#CATEGORY_INFO).
### CATEGORY_LAUNCHER
- Type: String
- Platforms: Android
- Permission: read-only
Activity is in the device's launcher.
Pass to the Intent's [addCategory()](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md#addCategory) method to set a category.
See [Intent.CATEGORY_LAUNCHER in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#CATEGORY_LAUNCHER).
### CATEGORY_MESSAGE
- Type: String
- Platforms: Android
- Since: Titanium SDK 3.6.0
- Permission: read-only
Notification category indicating an incoming direct message (SMS, instant message, etc.).
Use with the [Titanium.Android.Notification.category](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#category) property.
See [Notification.CATEGORY_MESSAGE in the Android API Reference](https://developer.android.com/reference/android/app/Notification.html#CATEGORY_MESSAGE).
### CATEGORY_MONKEY
- Type: String
- Platforms: Android
- Permission: read-only
This activity may be exercised by the monkey or other automated test tools.
See [Intent.CATEGORY_MONKEY in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#CATEGORY_MONKEY).
### CATEGORY_OPENABLE
- Type: String
- Platforms: Android
- Permission: read-only
Activity can open raw `file://` or `scheme://` URIs.
See [Intent.CATEGORY_OPENABLE in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#CATEGORY_OPENABLE).
### CATEGORY_PREFERENCE
- Type: String
- Platforms: Android
- Permission: read-only
This activity is a preference panel.
Pass to the Intent's [addCategory()](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md#addCategory) method to set a category.
See [Intent.CATEGORY_PREFERENCE in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#CATEGORY_PREFERENCE).
### CATEGORY_PROGRESS
- Type: String
- Platforms: Android
- Since: Titanium SDK 3.6.0
- Permission: read-only
Notification category indicating the progress of a long-running background operation.
Use with the [Titanium.Android.Notification.category](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#category) property.
See [Notification.CATEGORY_PROGRESS in the Android API Reference](https://developer.android.com/reference/android/app/Notification.html#CATEGORY_PROGRESS).
### CATEGORY_PROMO
- Type: String
- Platforms: Android
- Since: Titanium SDK 3.6.0
- Permission: read-only
Notification category indicating a promotion or advertisement.
Use with the [Titanium.Android.Notification.category](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#category) property.
See [Notification.CATEGORY_PROMO in the Android API Reference](https://developer.android.com/reference/android/app/Notification.html#CATEGORY_PROMO).
### CATEGORY_RECOMMENDATION
- Type: String
- Platforms: Android
- Since: Titanium SDK 3.6.0
- Permission: read-only
Notification category indicating a specific, timely recommendation for a single thing.
Use with the [Titanium.Android.Notification.category](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#category) property.
See [Notification.CATEGORY_RECOMMENDATION in the Android API Reference](https://developer.android.com/reference/android/app/Notification.html#CATEGORY_RECOMMENDATION).
### CATEGORY_SAMPLE_CODE
- Type: String
- Platforms: Android
- Permission: read-only
To be used as a sample code example (not part of the normal user experience).
See [Intent.CATEGORY_SAMPLE_CODE in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#CATEGORY_SAMPLE_CODE).
### CATEGORY_SELECTED_ALTERNATIVE
- Type: String
- Platforms: Android
- Permission: read-only
Activity should be considered as an alternative selection action to the data the user
has currently selected.
Pass to the Intent's [addCategory()](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md#addCategory) method to set a category.
See [Intent.CATEGORY_SELECTED_ALTERNATIVE in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#CATEGORY_SELECTED_ALTERNATIVE).
### CATEGORY_SERVICE
- Type: String
- Platforms: Android
- Since: Titanium SDK 3.6.0
- Permission: read-only
Notification category for a running background service.
Use with the [Titanium.Android.Notification.category](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#category) property.
See [Notification.CATEGORY_SERVICE in the Android API Reference](https://developer.android.com/reference/android/app/Notification.html#CATEGORY_SERVICE).
### CATEGORY_SOCIAL
- Type: String
- Platforms: Android
- Since: Titanium SDK 3.6.0
- Permission: read-only
Notification category for a social network or sharing update.
Use with the [Titanium.Android.Notification.category](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#category) property.
See [Notification.CATEGORY_SOCIAL in the Android API Reference](https://developer.android.com/reference/android/app/Notification.html#CATEGORY_SOCIAL).
### CATEGORY_STATUS
- Type: String
- Platforms: Android
- Since: Titanium SDK 3.6.0
- Permission: read-only
Notification category indicating ongoing information about device or contextual status.
Use with the [Titanium.Android.Notification.category](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#category) property.
See [Notification.CATEGORY_STATUS in the Android API Reference](https://developer.android.com/reference/android/app/Notification.html#CATEGORY_STATUS).
### CATEGORY_TAB
- Type: String
- Platforms: Android
- Permission: read-only
Activity to be used in a tab activity.
Pass to the Intent's [addCategory()](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md#addCategory) method to set a category.
See [Intent.CATEGORY_TAB in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#CATEGORY_TAB).
### CATEGORY_TEST
- Type: String
- Platforms: Android
- Permission: read-only
To be used as a test (not part of the normal user experience).
Pass to the Intent's [addCategory()](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md#addCategory) method to set a category.
See [Intent.CATEGORY_TEST in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#CATEGORY_TEST).
### CATEGORY_TRANSPORT
- Type: String
- Platforms: Android
- Since: Titanium SDK 3.6.0
- Permission: read-only
Notification category indicating media transport control for playback.
Use with the [Titanium.Android.Notification.category](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#category) property.
See [Notification.CATEGORY_TRANSPORT in the Android API Reference](https://developer.android.com/reference/android/app/Notification.html#CATEGORY_TRANSPORT).
### CATEGORY_UNIT_TEST
- Type: String
- Platforms: Android
- Permission: read-only
To be used as a unit test (run through the Test Harness).
See [Intent.CATEGORY_UNIT_TEST in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#CATEGORY_UNIT_TEST).
### currentActivity
- Type: Titanium.Android.Activity
- Platforms: Android
- Permission: read-only
References the top-most window's activity.
### currentService
- Type: Titanium.Android.Service
- Platforms: Android
- Permission: read-only
Service in the active context.
### DEFAULT_ALL
- Type: Number
- Platforms: Android
- Permission: read-only
Use all default settings for a notification; see
[Notification.defaults](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#defaults).
See [Notification.DEFAULT_ALL in the Android API Reference](https://developer.android.com/reference/android/app/Notification.html#DEFAULT_ALL).
### DEFAULT_LIGHTS
- Type: Number
- Platforms: Android
- Permission: read-only
Use the default light settings for a notification; see
[Notification.defaults](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#defaults).
See [Notification.DEFAULT_LIGHTS in the Android API Reference](https://developer.android.com/reference/android/app/Notification.html#DEFAULT_LIGHTS).
### DEFAULT_SOUND
- Type: Number
- Platforms: Android
- Permission: read-only
Use the default sound settings for a notification; see
[Notification.defaults](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#defaults).
See [Notification.DEFAULT_SOUND in the Android API Reference](https://developer.android.com/reference/android/app/Notification.html#DEFAULT_SOUND).
### DEFAULT_VIBRATE
- Type: Number
- Platforms: Android
- Permission: read-only
Use the default vibration settings for a notification; see
[Notification.defaults](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#defaults).
See [Notification.DEFAULT_VIBRATE in the Android API Reference](https://developer.android.com/reference/android/app/Notification.html#DEFAULT_VIBRATE).
### EXTRA_ALARM_COUNT
- Type: String
- Platforms: Android
- Permission: read-only
Integer indicating how many pending alarms are being delivered with the intent.
See [Intent.EXTRA_ALARM_COUNT in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#EXTRA_ALARM_COUNT).
### EXTRA_BCC
- Type: String
- Platforms: Android
- Permission: read-only
String array containing e-mail addresses for blind carbon copying.
See [Intent.EXTRA_BCC in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#EXTRA_BCC).
### EXTRA_CC
- Type: String
- Platforms: Android
- Permission: read-only
String array containing e-mail addresses for carbon copying.
See [Intent.EXTRA_CC in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#EXTRA_CC).
### EXTRA_DATA_REMOVED
- Type: String
- Platforms: Android
- Permission: read-only
Boolean indicating full uninstall (true) or partial uninstall (false).
Sent with the `Titanium.Android.ACTION_PACKAGE_REMOVED` broadcast.
See [Intent.EXTRA_DATA_REMOVED in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#EXTRA_DATA_REMOVED).
### EXTRA_DONT_KILL_APP
- Type: String
- Platforms: Android
- Permission: read-only
Boolean indicating to restart the application or not.
Sent with the `Titanium.Android.ACTION_PACKAGE_REMOVED` and
`Titanium.Android.ACTION_PACKAGE_CHANGED` broadcasts.
See [Intent.EXTRA_DONT_KILL_APP in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#EXTRA_DONT_KILL_APP).
### EXTRA_EMAIL
- Type: String
- Platforms: Android
- Permission: read-only
String array containing e-mail addresses.
See [Intent.EXTRA_EMAIL in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#EXTRA_EMAIL).
### EXTRA_INTENT
- Type: String
- Platforms: Android
- Permission: read-only
An Intent describing the choices you would like shown.
Set if the Intent's action is `Titanium.Android.ACTION_PICK_ACTIVITY`.
See [Intent.EXTRA_INTENT in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#EXTRA_INTENT).
### EXTRA_KEY_EVENT
- Type: String
- Platforms: Android
- Permission: read-only
A KeyEvent object containing the event that triggered the creation of the Intent it is in.
See [Intent.EXTRA_KEY_EVENT in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#EXTRA_KEY_EVENT).
### EXTRA_PHONE_NUMBER
- Type: String
- Platforms: Android
- Permission: read-only
String holding the phone number to call or number that was called.
Sent with the `Titanium.Android.ACTION_NEW_OUTGOING_CALL` broadcast.
Set if the Intent's action is `Titanium.Android.ACTION_CALL`.
See [Intent.EXTRA_PHONE_NUMBER in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#EXTRA_PHONE_NUMBER).
### EXTRA_REPLACING
- Type: String
- Platforms: Android
- Permission: read-only
Boolean indicating if the package is being replaced.
Sent with the `Titanium.Android.ACTION_PACKAGE_REMOVED` broadcast.
See [Intent.EXTRA_REPLACING in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#EXTRA_REPLACING).
### EXTRA_SHORTCUT_ICON
- Type: String
- Platforms: Android
- Permission: read-only
Bitmap icon.
Return value of an intent with a `Titanium.Android.ACTION_CREATE_SHORTCUT` action.
See [Intent.EXTRA_SHORTCUT_ICON in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#EXTRA_SHORTCUT_ICON).
### EXTRA_SHORTCUT_ICON_RESOURCE
- Type: String
- Platforms: Android
- Permission: read-only
Resource of the shortcut.
Return value of an intent with a `Titanium.Android.ACTION_CREATE_SHORTCUT` action.
See [Intent.EXTRA_SHORTCUT_ICON_RESOURCE in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#EXTRA_SHORTCUT_ICON_RESOURCE).
### EXTRA_SHORTCUT_INTENT
- Type: String
- Platforms: Android
- Permission: read-only
Intent of a shortcut.
Return value of an intent with a `Titanium.Android.ACTION_CREATE_SHORTCUT` action.
See [Intent.EXTRA_SHORTCUT_INTENT in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#EXTRA_SHORTCUT_INTENT).
### EXTRA_SHORTCUT_NAME
- Type: String
- Platforms: Android
- Permission: read-only
Name of the shortcut.
Return value of an intent with a `Titanium.Android.ACTION_CREATE_SHORTCUT` action.
See [Intent.EXTRA_SHORTCUT_NAME in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#EXTRA_SHORTCUT_NAME).
### EXTRA_STREAM
- Type: String
- Platforms: Android
- Permission: read-only
URI containing the stream data.
Use if the Intent's action is `Titanium.Android.ACTION_SEND`.
See [Intent.EXTRA_STREAM in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#EXTRA_STREAM).
### EXTRA_SUBJECT
- Type: String
- Platforms: Android
- Permission: read-only
Subject line of a message.
See [Intent.EXTRA_SUBJECT in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#EXTRA_SUBJECT).
### EXTRA_TEMPLATE
- Type: String
- Platforms: Android
- Permission: read-only
Initial data to place in a newly created record.
Use if the Intent's action is `Titanium.Android.ACTION_INSERT`.
See [Intent.EXTRA_TEMPLATE in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#EXTRA_TEMPLATE).
### EXTRA_TEXT
- Type: String
- Platforms: Android
- Permission: read-only
Corresponds to the Android `Intent.EXTRA_TEXT` constant.
See [Intent.EXTRA_TEXT in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#EXTRA_TEXT).
### EXTRA_TITLE
- Type: String
- Platforms: Android
- Permission: read-only
Corresponds to the Android `Intent.EXTRA_TITLE` constant.
Set if the Intent's action is `Titanium.Android.ACTION_CHOOSER`.
See [Intent.EXTRA_TITLE in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#EXTRA_TITLE).
### EXTRA_UID
- Type: String
- Platforms: Android
- Permission: read-only
UID of the assigned packaged.
Sent with the `Titanium.Android.ACTION_UID_REMOVED` broadcast, and may be sent with the
`Titanium.Android.ACTION_PACKAGE_CHANGED` and `Titanium.Android.ACTION_PACKAGE_REMOVED` broadcasts.
See [Intent.EXTRA_UID in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#EXTRA_UID).
### FILL_IN_ACTION
- Type: Number
- Platforms: Android
- Permission: read-only
Not used.
See [Intent.FILL_IN_ACTION in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#FILL_IN_ACTION).
### FILL_IN_CATEGORIES
- Type: Number
- Platforms: Android
- Permission: read-only
Not used.
See [Intent.FILL_IN_CATEGORIES in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#FILL_IN_CATEGORIES).
### FILL_IN_COMPONENT
- Type: Number
- Platforms: Android
- Permission: read-only
Not used.
See [Intent.FILL_IN_COMPONENT in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#FILL_IN_COMPONENT).
### FILL_IN_DATA
- Type: Number
- Platforms: Android
- Permission: read-only
Not used.
See [Intent.FILL_IN_DATA in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#FILL_IN_DATA).
### FILL_IN_PACKAGE
- Type: Number
- Platforms: Android
- Permission: read-only
Not used.
See [Intent.FILL_IN_PACKAGE in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#FILL_IN_PACKAGE).
### FLAG_ACTIVITY_BROUGHT_TO_FRONT
- Type: Number
- Platforms: Android
- Permission: read-only
If activity is already running, bring it to the foreground.
Set by the system when launching a task.
See [Intent.FLAG_ACTIVITY_BROUGHT_TO_FRONT in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#FLAG_ACTIVITY_BROUGHT_TO_FRONT).
### FLAG_ACTIVITY_CLEAR_TOP
- Type: Number
- Platforms: Android
- Permission: read-only
If the activity is present, removes any activities on top of it to make it the foreground activity.
Bitwise-OR the constant with the Intent's `flags` property.
See [Intent.FLAG_ACTIVITY_CLEAR_TOP in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#FLAG_ACTIVITY_CLEAR_TOP).
### FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET
- Type: Number
- Platforms: Android
- Requires: Android ≤5.0
- Permission: read-only
Corresponds to the Android `Intent.FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET` constant.
See [Intent.FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET).
### FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS
- Type: Number
- Platforms: Android
- Permission: read-only
Exclude the activity from recently launched activities.
Bitwise-OR the constant with the Intent's `flags` property.
See [Intent.FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS).
### FLAG_ACTIVITY_FORWARD_RESULT
- Type: Number
- Platforms: Android
- Permission: read-only
Return result to the original calling activity.
Bitwise-OR the constant with the Intent's `flags` property.
See [Intent.FLAG_ACTIVITY_FORWARD_RESULT in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#FLAG_ACTIVITY_FORWARD_RESULT).
### FLAG_ACTIVITY_LAUNCHED_FROM_HISTORY
- Type: Number
- Platforms: Android
- Permission: read-only
Activity was launched from history.
Set by the system when launching a task.
See [Intent.FLAG_ACTIVITY_LAUNCHED_FROM_HISTORY in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#FLAG_ACTIVITY_LAUNCHED_FROM_HISTORY).
### FLAG_ACTIVITY_MULTIPLE_TASK
- Type: Number
- Platforms: Android
- Permission: read-only
Start the activity as a new task even if it exists.
Must be used with the `Titanium.Android.FLAG_ACTIVITY_NEW_TASK`.
Bitwise-OR the constant with the Intent's `flags` property.
See [Intent.FLAG_ACTIVITY_MULTIPLE_TASK in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#FLAG_ACTIVITY_MULTIPLE_TASK).
### FLAG_ACTIVITY_NEW_TASK
- Type: Number
- Platforms: Android
- Permission: read-only
Activity will be the start of a new task (collection of activities).
Bitwise-OR the constant with the Intent's `flags` property.
See [Intent.FLAG_ACTIVITY_NEW_TASK in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#FLAG_ACTIVITY_NEW_TASK).
### FLAG_ACTIVITY_NO_ANIMATION
- Type: Number
- Platforms: Android
- Permission: read-only
Prevent transition animation.
Bitwise-OR the constant with the Intent's `flags` property.
See [Intent.FLAG_ACTIVITY_NO_ANIMATION in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#FLAG_ACTIVITY_NO_ANIMATION).
### FLAG_ACTIVITY_NO_HISTORY
- Type: Number
- Platforms: Android
- Permission: read-only
Do not keep the activity in the history stack.
Bitwise-OR the constant with the Intent's `flags` property.
See [Intent.FLAG_ACTIVITY_NO_HISTORY in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#FLAG_ACTIVITY_NO_HISTORY).
### FLAG_ACTIVITY_NO_USER_ACTION
- Type: Number
- Platforms: Android
- Permission: read-only
Disables the [onUserLeaveHint()](https://developer.android.com/reference/android/app/Activity.html#onUserLeaveHint()) callback.
Bitwise-OR the constant with the Intent's `flags` property.
See [Intent.FLAG_ACTIVITY_NO_USER_ACTION in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#FLAG_ACTIVITY_NO_USER_ACTION).
### FLAG_ACTIVITY_PREVIOUS_IS_TOP
- Type: Number
- Platforms: Android
- Permission: read-only
Corresponds to the Android `Intent.FLAG_ACTIVITY_PREVIOUS_IS_TOP` constant.
Bitwise-OR the constant with the Intent's `flags` property.
See [Intent.FLAG_ACTIVITY_PREVIOUS_IS_TOP in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#FLAG_ACTIVITY_PREVIOUS_IS_TOP).
### FLAG_ACTIVITY_REORDER_TO_FRONT
- Type: Number
- Platforms: Android
- Permission: read-only
If the activity already exists, place it at the top of the history stack.
Bitwise-OR the constant with the Intent's `flags` property.
See [Intent.FLAG_ACTIVITY_REORDER_TO_FRONT in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#FLAG_ACTIVITY_REORDER_TO_FRONT).
### FLAG_ACTIVITY_RESET_TASK_IF_NEEDED
- Type: Number
- Platforms: Android
- Permission: read-only
If the task already exists, resets the task to its initial state.
Bitwise-OR the constant with the Intent's `flags` property.
See [Intent.FLAG_ACTIVITY_RESET_TASK_IF_NEEDED in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#FLAG_ACTIVITY_RESET_TASK_IF_NEEDED).
### FLAG_ACTIVITY_SINGLE_TOP
- Type: Number
- Platforms: Android
- Permission: read-only
Do not launch the activity if it is already running.
Bitwise-OR the constant with the Intent's `flags` property.
See [Intent.FLAG_ACTIVITY_SINGLE_TOP in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#FLAG_ACTIVITY_SINGLE_TOP).
### FLAG_AUTO_CANCEL
- Type: Number
- Platforms: Android
- Permission: read-only
Cancel the notification when it is clicked by the user.
Use with [Notification.flags](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#flags).
See also: [Notification.FLAG_AUTO_CANCEL in the Android API Reference](https://developer.android.com/reference/android/app/Notification.html#FLAG_AUTO_CANCEL).
### FLAG_CANCEL_CURRENT
- Type: Number
- Platforms: Android
- Permission: read-only
Cancel the current pending intent before creating a new one.
Use with the [Titanium.Android.PendingIntent.flags](https://titaniumsdk.com/docs/sdk/Titanium.Android.PendingIntent.md#flags) property.
See [PendingIntent.FLAG_CANCEL_CURRENT in the Android API Reference](https://developer.android.com/reference/android/app/PendingIntent.html#FLAG_CANCEL_CURRENT).
### FLAG_DEBUG_LOG_RESOLUTION
- Type: Number
- Platforms: Android
- Permission: read-only
Enable a log message to print out the resolution of the intent.
Bitwise-OR the constant with the Intent's `flags` property.
See [Intent.FLAG_DEBUG_LOG_RESOLUTION in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#FLAG_DEBUG_LOG_RESOLUTION).
### FLAG_FROM_BACKGROUND
- Type: Number
- Platforms: Android
- Permission: read-only
Indicates the intent is coming from a background operation.
Bitwise-OR the constant with the Intent's `flags` property.
See [Intent.FLAG_FROM_BACKGROUND in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#FLAG_FROM_BACKGROUND).
### FLAG_GRANT_READ_URI_PERMISSION
- Type: Number
- Platforms: Android
- Permission: read-only
Grant read permission on the URI in the Intent's data or clipboard.
Bitwise-OR the constant with the Intent's `flags` property.
See [Intent.FLAG_GRANT_READ_URI_PERMISSION in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#FLAG_GRANT_READ_URI_PERMISSION).
### FLAG_GRANT_WRITE_URI_PERMISSION
- Type: Number
- Platforms: Android
- Permission: read-only
Grants write permission on the URI in the Intent's data or clipboard.
Bitwise-OR the constant with the Intent's `flags` property.
See [Intent.FLAG_GRANT_WRITE_URI_PERMISSION in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#FLAG_GRANT_WRITE_URI_PERMISSION).
### FLAG_IMMUTABLE
- Type: Number
- Platforms: Android
- Since: Titanium SDK 10.1.0
- Requires: Android 6.0+
- Permission: read-only
Pending intent should be immutable.
Use with the [Titanium.Android.PendingIntent.flags](https://titaniumsdk.com/docs/sdk/Titanium.Android.PendingIntent.md#flags) property.
See [PendingIntent.FLAG_IMMUTABLE in the Android API Reference](https://developer.android.com/reference/android/app/PendingIntent.html#FLAG_IMMUTABLE).
### FLAG_INSISTENT
- Type: Number
- Platforms: Android
- Permission: read-only
Repeat audio until the notification is cancelled or the notification window
is opened.
Use with [Notification.flags](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#flags).
See also: [Notification.FLAG_INSISTENT in the Android API Reference](https://developer.android.com/reference/android/app/Notification.html#FLAG_INSISTENT).
### FLAG_MUTABLE
- Type: Number
- Platforms: Android
- Since: Titanium SDK 10.1.0
- Requires: Android 12.0+
- Permission: read-only
Pending intent should be mutable.
Use with the [Titanium.Android.PendingIntent.flags](https://titaniumsdk.com/docs/sdk/Titanium.Android.PendingIntent.md#flags) property.
See [PendingIntent.FLAG_MUTABLE in the Android API Reference](https://developer.android.com/reference/android/app/PendingIntent.html#FLAG_MUTABLE).
### FLAG_NO_CLEAR
- Type: Number
- Platforms: Android
- Permission: read-only
Do not cancel the notification when the user clicks the Clear All button.
Use with [Notification.flags](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#flags).
See also: [Notification.FLAG_NO_CLEAR in the Android API Reference](https://developer.android.com/reference/android/app/Notification.html#FLAG_NO_CLEAR).
### FLAG_NO_CREATE
- Type: Number
- Platforms: Android
- Permission: read-only
If the current intent does not exist, do not create it.
Use with the [Titanium.Android.PendingIntent.flags](https://titaniumsdk.com/docs/sdk/Titanium.Android.PendingIntent.md#flags) property.
See [PendingIntent.FLAG_NO_CREATE in the Android API Reference](https://developer.android.com/reference/android/app/PendingIntent.html#FLAG_NO_CREATE).
### FLAG_ONE_SHOT
- Type: Number
- Platforms: Android
- Permission: read-only
The pending intent can only be used once.
Use with the [Titanium.Android.PendingIntent.flags](https://titaniumsdk.com/docs/sdk/Titanium.Android.PendingIntent.md#flags) property.
See [PendingIntent.FLAG_ONE_SHOT in the Android API Reference](https://developer.android.com/reference/android/app/PendingIntent.html#FLAG_ONE_SHOT).
### FLAG_ONGOING_EVENT
- Type: Number
- Platforms: Android
- Permission: read-only
Specifies that a notification is in reference to something that is ongoing, like a phone call.
Use with [Notification.flags](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#flags).
See also: [Notification.FLAG_ONGOING_EVENT in the Android API Reference](https://developer.android.com/reference/android/app/Notification.html#FLAG_ONGOING_EVENT).
### FLAG_ONLY_ALERT_ONCE
- Type: Number
- Platforms: Android
- Permission: read-only
Play an alert (sound, lights, and/or vibration) once each time the notification is sent, even if it has not been canceled before that.
Use with [Notification.flags](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#flags).
See also: [Notification.FLAG_ONLY_ALERT_ONCE in the Android API Reference](https://developer.android.com/reference/android/app/Notification.html#FLAG_ONLY_ALERT_ONCE).
### FLAG_RECEIVER_REGISTERED_ONLY
- Type: Number
- Platforms: Android
- Permission: read-only
When sending a broadcast, only registered receivers will be called.
Bitwise-OR the constant with the Intent's `flags` property.
See [Intent.FLAG_RECEIVER_REGISTERED_ONLY in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#FLAG_RECEIVER_REGISTERED_ONLY).
### FLAG_SHOW_LIGHTS
- Type: Number
- Platforms: Android
- Permission: read-only
Use LED lights to alert the user to the notification.
Use with [Notification.flags](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#flags).
See also: [Notification.FLAG_SHOW_LIGHTS in the Android API Reference](https://developer.android.com/reference/android/app/Notification.html#FLAG_SHOW_LIGHTS).
### FLAG_UPDATE_CURRENT
- Type: Number
- Platforms: Android
- Permission: read-only
If the current pending intent already exists, only update the current intent's extra data.
Use with the [Titanium.Android.PendingIntent.flags](https://titaniumsdk.com/docs/sdk/Titanium.Android.PendingIntent.md#flags) property.
See [PendingIntent.FLAG_UPDATE_CURRENT in the Android API
Reference](https://developer.android.com/reference/android/app/PendingIntent.html#FLAG_UPDATE_CURRENT).
### FOREGROUND_SERVICE_TYPE_CAMERA
- Type: Number
- Platforms: Android
- Since: Titanium SDK 9.3.0
- Permission: read-only
Allows the camera to be used while the app is in the background.
This constant is passed to the [Titanium.Android.Service.foregroundNotify](https://titaniumsdk.com/docs/sdk/Titanium.Android.Service.md#foregroundNotify) method.
To use this constant, you must also set your `` element to the
`foregroundServieType` attribute value as shown below.
``` xml
```
See Google's [ServiceInfo.FOREGROUND_SERVICE_TYPE_CAMERA](https://developer.android.com/reference/android/content/pm/ServiceInfo.html#FOREGROUND_SERVICE_TYPE_CAMERA)
documentation for more details.
### FOREGROUND_SERVICE_TYPE_CONNECTED_DEVICE
- Type: Number
- Platforms: Android
- Since: Titanium SDK 8.3.0
- Permission: read-only
Allows connecting to Android Auto, bluetooth, TV or other devices while app is in the background.
This constant is passed to the [Titanium.Android.Service.foregroundNotify](https://titaniumsdk.com/docs/sdk/Titanium.Android.Service.md#foregroundNotify) method.
To use this constant, you must also set your `` element to the
`foregroundServieType` attribute value as shown below.
``` xml
```
See Google's [ServiceInfo.FOREGROUND_SERVICE_TYPE_CONNECTED_DEVICE](https://developer.android.com/reference/android/content/pm/ServiceInfo.html#FOREGROUND_SERVICE_TYPE_CONNECTED_DEVICE)
documentation for more details.
### FOREGROUND_SERVICE_TYPE_LOCATION
- Type: Number
- Platforms: Android
- Since: Titanium SDK 8.3.0
- Permission: read-only
Allows accessing location from the GPS, map, etc. while the app is in the background.
This constant is passed to the [Titanium.Android.Service.foregroundNotify](https://titaniumsdk.com/docs/sdk/Titanium.Android.Service.md#foregroundNotify) method.
To use this constant, you must also set your `` element to the
`foregroundServieType` attribute value as shown below.
``` xml
```
See Google's [ServiceInfo.FOREGROUND_SERVICE_TYPE_LOCATION](https://developer.android.com/reference/android/content/pm/ServiceInfo.html#FOREGROUND_SERVICE_TYPE_LOCATION)
documentation for more details.
### FOREGROUND_SERVICE_TYPE_MANIFEST
- Type: Number
- Platforms: Android
- Since: Titanium SDK 8.3.0
- Permission: read-only
A special value indicates to use all types set in manifest file.
This constant is passed to the [Titanium.Android.Service.foregroundNotify](https://titaniumsdk.com/docs/sdk/Titanium.Android.Service.md#foregroundNotify) method.
See Google's [ServiceInfo.FOREGROUND_SERVICE_TYPE_MANIFEST](https://developer.android.com/reference/android/content/pm/ServiceInfo.html#FOREGROUND_SERVICE_TYPE_MANIFEST)
documentation for more details.
### FOREGROUND_SERVICE_TYPE_MEDIA_PLAYBACK
- Type: Number
- Platforms: Android
- Since: Titanium SDK 8.3.0
- Permission: read-only
Allows music, video, news or other media playback while the app is in the background.
This constant is passed to the [Titanium.Android.Service.foregroundNotify](https://titaniumsdk.com/docs/sdk/Titanium.Android.Service.md#foregroundNotify) method.
To use this constant, you must also set your `` element to the
`foregroundServieType` attribute value as shown below.
``` xml
```
See Google's [ServiceInfo.FOREGROUND_SERVICE_TYPE_MEDIA_PLAYBACK](https://developer.android.com/reference/android/content/pm/ServiceInfo.html#FOREGROUND_SERVICE_TYPE_MEDIA_PLAYBACK)
documentation for more details.
### FOREGROUND_SERVICE_TYPE_MEDIA_PROJECTION
- Type: Number
- Platforms: Android
- Since: Titanium SDK 8.3.0
- Permission: read-only
Allows managing a media projection session for screen recording or taking screenshots
while app is in the background.
This constant is passed to the [Titanium.Android.Service.foregroundNotify](https://titaniumsdk.com/docs/sdk/Titanium.Android.Service.md#foregroundNotify) method.
To use this constant, you must also set your `` element to the
`foregroundServieType` attribute value as shown below.
``` xml
```
See Google's [ServiceInfo.FOREGROUND_SERVICE_TYPE_MEDIA_PROJECTION](https://developer.android.com/reference/android/content/pm/ServiceInfo.html#FOREGROUND_SERVICE_TYPE_MEDIA_PROJECTION)
documentation for more details.
### FOREGROUND_SERVICE_TYPE_MICROPHONE
- Type: Number
- Platforms: Android
- Since: Titanium SDK 9.3.0
- Permission: read-only
Allows the microphone to be used while the app is in the background.
This constant is passed to the [Titanium.Android.Service.foregroundNotify](https://titaniumsdk.com/docs/sdk/Titanium.Android.Service.md#foregroundNotify) method.
To use this constant, you must also set your `` element to the
`foregroundServieType` attribute value as shown below.
``` xml
```
See Google's [ServiceInfo.FOREGROUND_SERVICE_TYPE_MICROPHONE](https://developer.android.com/reference/android/content/pm/ServiceInfo.html#FOREGROUND_SERVICE_TYPE_MICROPHONE)
documentation for more details.
### FOREGROUND_SERVICE_TYPE_NONE
- Type: Number
- Platforms: Android
- Since: Titanium SDK 8.3.0
- Permission: read-only
The default foreground service type.
This constant is passed to the [Titanium.Android.Service.foregroundNotify](https://titaniumsdk.com/docs/sdk/Titanium.Android.Service.md#foregroundNotify) method.
See Google's [ServiceInfo.FOREGROUND_SERVICE_TYPE_NONE](https://developer.android.com/reference/android/content/pm/ServiceInfo.html#FOREGROUND_SERVICE_TYPE_NONE)
documentation for more details.
### FOREGROUND_SERVICE_TYPE_PHONE_CALL
- Type: Number
- Platforms: Android
- Since: Titanium SDK 8.3.0
- Permission: read-only
Allows ongoing phone call or video conferencing access while the app is in the background.
This constant is passed to the [Titanium.Android.Service.foregroundNotify](https://titaniumsdk.com/docs/sdk/Titanium.Android.Service.md#foregroundNotify) method.
To use this constant, you must also set your `` element to the
`foregroundServieType` attribute value as shown below.
``` xml
```
See Google's [ServiceInfo.FOREGROUND_SERVICE_TYPE_PHONE_CALL](https://developer.android.com/reference/android/content/pm/ServiceInfo.html#FOREGROUND_SERVICE_TYPE_PHONE_CALL)
documentation for more details.
### IMPORTANCE_DEFAULT
- Type: Number
- Platforms: Android
- Since: Titanium SDK 7.0.0
- Permission: read-only
Used with [NotificationChannel](https://titaniumsdk.com/docs/sdk/Titanium.Android.NotificationChannel.md) to specify an importance level.
### IMPORTANCE_HIGH
- Type: Number
- Platforms: Android
- Since: Titanium SDK 7.0.0
- Permission: read-only
Used with [NotificationChannel](https://titaniumsdk.com/docs/sdk/Titanium.Android.NotificationChannel.md) to specify an importance level.
### IMPORTANCE_LOW
- Type: Number
- Platforms: Android
- Since: Titanium SDK 7.0.0
- Permission: read-only
Used with [NotificationChannel](https://titaniumsdk.com/docs/sdk/Titanium.Android.NotificationChannel.md) to specify an importance level.
### IMPORTANCE_MAX
- Type: Number
- Platforms: Android
- Since: Titanium SDK 7.0.0
- Permission: read-only
Used with [NotificationChannel](https://titaniumsdk.com/docs/sdk/Titanium.Android.NotificationChannel.md) to specify an importance level.
### IMPORTANCE_MIN
- Type: Number
- Platforms: Android
- Since: Titanium SDK 7.0.0
- Permission: read-only
Used with [NotificationChannel](https://titaniumsdk.com/docs/sdk/Titanium.Android.NotificationChannel.md) to specify an importance level.
### IMPORTANCE_NONE
- Type: Number
- Platforms: Android
- Since: Titanium SDK 7.0.0
- Permission: read-only
Used with [NotificationChannel](https://titaniumsdk.com/docs/sdk/Titanium.Android.NotificationChannel.md) to specify an importance level.
### IMPORTANCE_UNSPECIFIED
- Type: Number
- Platforms: Android
- Since: Titanium SDK 7.0.0
- Permission: read-only
Used with [NotificationChannel](https://titaniumsdk.com/docs/sdk/Titanium.Android.NotificationChannel.md) to specify an importance level.
### NAVIGATION_MODE_STANDARD
- Type: Number
- Platforms: Android
- Since: Titanium SDK 3.2.0
- Permission: read-only
Standard Action Bar navigation mode.
Use with the [Titanium.Android.ActionBar.navigationMode](https://titaniumsdk.com/docs/sdk/Titanium.Android.ActionBar.md#navigationMode) property. Note: NAVIGATION_MODE_STANDARD has been deprecated in API level 21 and up.
### NAVIGATION_MODE_TABS
- Type: Number
- Platforms: Android
- Since: Titanium SDK 3.2.0
- Permission: read-only
Action Bar tab navigation mode.
Use with the [Titanium.Android.ActionBar.navigationMode](https://titaniumsdk.com/docs/sdk/Titanium.Android.ActionBar.md#navigationMode) property. Note: NAVIGATION_MODE_TABS has been deprecated in API level 21 and up.
### PENDING_INTENT_FOR_ACTIVITY
- Type: Number
- Platforms: Android
- Permission: read-only
- DEPRECATED since 2.0.0, removed in 10.0.0.
Not used.
### PENDING_INTENT_FOR_BROADCAST
- Type: Number
- Platforms: Android
- Permission: read-only
- DEPRECATED since 2.0.0, removed in 10.0.0.
Not used.
### PENDING_INTENT_FOR_SERVICE
- Type: Number
- Platforms: Android
- Permission: read-only
- DEPRECATED since 2.0.0, removed in 10.0.0.
Not used.
### PENDING_INTENT_MAX_VALUE
- Type: Number
- Platforms: Android
- Permission: read-only
- DEPRECATED since 2.0.0, removed in 10.0.0.
Not used.
### PRIORITY_DEFAULT
- Type: Number
- Platforms: Android
- Since: Titanium SDK 3.6.0
- Permission: read-only
Default priority if it does not fit into another priority category.
Use with the [Titanium.Android.Notification.priority](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#priority) property.
See also: [Notification.PRIORITY_DEFAULT in the Android API Reference](https://developer.android.com/reference/android/app/Notification.html#PRIORITY_DEFAULT).
### PRIORITY_HIGH
- Type: Number
- Platforms: Android
- Since: Titanium SDK 3.6.0
- Permission: read-only
Use for high priority notifications like real-time chat messages.
Use with the [Titanium.Android.Notification.priority](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#priority) property.
See also: [Notification.PRIORITY_HIGH in the Android API Reference](https://developer.android.com/reference/android/app/Notification.html#PRIORITY_HIGH).
### PRIORITY_LOW
- Type: Number
- Platforms: Android
- Since: Titanium SDK 3.6.0
- Permission: read-only
Use for low priority notifications like software updates.
Use with the [Titanium.Android.Notification.priority](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#priority) property.
See also: [Notification.PRIORITY_LOW in the Android API Reference](https://developer.android.com/reference/android/app/Notification.html#PRIORITY_LOW).
### PRIORITY_MAX
- Type: Number
- Platforms: Android
- Since: Titanium SDK 3.6.0
- Permission: read-only
Use for urgent or time-critical notifications, for example, turn-by-turn directions or
emergency alerts.
Use with the [Titanium.Android.Notification.priority](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#priority) property.
See also: [Notification.PRIORITY_MAX in the Android API Reference](https://developer.android.com/reference/android/app/Notification.html#PRIORITY_MAX).
### PRIORITY_MIN
- Type: Number
- Platforms: Android
- Since: Titanium SDK 3.6.0
- Permission: read-only
Use for expired events.
Use with the [Titanium.Android.Notification.priority](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#priority) property.
Note that the user will not be alerted to the notification (sound, vibration, etc.),
but the notification will appear in the drawer.
See also: [Notification.PRIORITY_MIN in the Android API Reference](https://developer.android.com/reference/android/app/Notification.html#PRIORITY_MIN).
### R
- Type: Titanium.Android.R
- Platforms: Android
- Permission: read-only
Accessor for Android system resources.
To access your application's resources, use [Titanium.App.Android.R](https://titaniumsdk.com/docs/sdk/Titanium.App.Android.md#R).
### RESULT_CANCELED
- Type: Number
- Platforms: Android
- Permission: read-only
Used with [setResult](https://titaniumsdk.com/docs/sdk/Titanium.Android.Activity.md#setResult) to specify that
an activity was canceled.
### RESULT_FIRST_USER
- Type: Number
- Platforms: Android
- Permission: read-only
Used with [setResult](https://titaniumsdk.com/docs/sdk/Titanium.Android.Activity.md#setResult) to specify a
user-defined result.
User-defined result constants values start at `RESULT_FIRST_USER`.
### RESULT_OK
- Type: Number
- Platforms: Android
- Permission: read-only
Used with [setResult](https://titaniumsdk.com/docs/sdk/Titanium.Android.Activity.md#setResult) to specify that
an activity succeeded.
### rootActivity
- Type: Titanium.Android.Activity
- Platforms: Android
- Since: Titanium SDK 8.0.0
- Permission: read-only
The first activity launched by the application.
This is the main launcher activity defined in the "AndroidManifest.xml" which shows the splash screen.
All windows opened are child activities below this root activity.
Closing this root activity via its [finish()](https://titaniumsdk.com/docs/sdk/Titanium.Android.Activity.md#finish) method will close
all of its child activity windows as well and exit out of the app.
When resuming the app via a data intent such as a URL, notification, shortcut, etc. the root activity
will fire a "newintent" event and update its [intent](https://titaniumsdk.com/docs/sdk/Titanium.Android.Activity.md#intent) property with
the newly received intent.
### SCREEN_ORIENTATION_BEHIND
- Type: Number
- Platforms: Android
- Permission: read-only
Use with [requestedOrientation](https://titaniumsdk.com/docs/sdk/Titanium.Android.Activity.md#requestedOrientation) to
specify the activity should run in the same orientation as the activity behind it
in the activity stack.
### SCREEN_ORIENTATION_LANDSCAPE
- Type: Number
- Platforms: Android
- Permission: read-only
Use with [requestedOrientation](https://titaniumsdk.com/docs/sdk/Titanium.Android.Activity.md#requestedOrientation) to
specify a landscape screen orientation.
### SCREEN_ORIENTATION_NOSENSOR
- Type: Number
- Platforms: Android
- Permission: read-only
Use with [requestedOrientation](https://titaniumsdk.com/docs/sdk/Titanium.Android.Activity.md#requestedOrientation) to
specify that the sensor should be ignored and the display should not rotate.
### SCREEN_ORIENTATION_PORTRAIT
- Type: Number
- Platforms: Android
- Permission: read-only
Use with [requestedOrientation](https://titaniumsdk.com/docs/sdk/Titanium.Android.Activity.md#requestedOrientation) to
specify a portrait screen orientation.
### SCREEN_ORIENTATION_SENSOR
- Type: Number
- Platforms: Android
- Permission: read-only
Use with [requestedOrientation](https://titaniumsdk.com/docs/sdk/Titanium.Android.Activity.md#requestedOrientation) to
specify that orientation should be determined by the orientation sensor.
### SCREEN_ORIENTATION_UNSPECIFIED
- Type: Number
- Platforms: Android
- Permission: read-only
Use with [requestedOrientation](https://titaniumsdk.com/docs/sdk/Titanium.Android.Activity.md#requestedOrientation) to
specify that the system should use its default rules for determining the best
orientation.
### SCREEN_ORIENTATION_USER
- Type: Number
- Platforms: Android
- Permission: read-only
Use with [requestedOrientation](https://titaniumsdk.com/docs/sdk/Titanium.Android.Activity.md#requestedOrientation) to
specify that the system should use the user's preferred orientation.
### SHOW_AS_ACTION_ALWAYS
- Type: Number
- Platforms: Android
- Since: Titanium SDK 3.0.0
- Permission: read-only
Always show this item as an action button in the action bar.
Use with the MenuItem's [Titanium.Android.MenuItem.showAsAction](https://titaniumsdk.com/docs/sdk/Titanium.Android.MenuItem.md#showAsAction) property.
### SHOW_AS_ACTION_COLLAPSE_ACTION_VIEW
- Type: Number
- Platforms: Android
- Since: Titanium SDK 3.0.0
- Permission: read-only
The action view can collapse to a normal menu item.
Use with the MenuItem's [Titanium.Android.MenuItem.showAsAction](https://titaniumsdk.com/docs/sdk/Titanium.Android.MenuItem.md#showAsAction) property.
### SHOW_AS_ACTION_IF_ROOM
- Type: Number
- Platforms: Android
- Since: Titanium SDK 3.0.0
- Permission: read-only
Show this item as an action button if the system decides there is room for it.
Use with the MenuItem's [Titanium.Android.MenuItem.showAsAction](https://titaniumsdk.com/docs/sdk/Titanium.Android.MenuItem.md#showAsAction) property.
### SHOW_AS_ACTION_NEVER
- Type: Number
- Platforms: Android
- Since: Titanium SDK 3.0.0
- Permission: read-only
Never display this item as an action button in the action bar.
Use with the MenuItem's [Titanium.Android.MenuItem.showAsAction](https://titaniumsdk.com/docs/sdk/Titanium.Android.MenuItem.md#showAsAction) property.
### SHOW_AS_ACTION_WITH_TEXT
- Type: Number
- Platforms: Android
- Since: Titanium SDK 3.0.0
- Permission: read-only
When this item is in the action bar, always show it with a text label.
Use with the MenuItem's [Titanium.Android.MenuItem.showAsAction](https://titaniumsdk.com/docs/sdk/Titanium.Android.MenuItem.md#showAsAction) property.
### START_NOT_STICKY
- Type: Number
- Platforms: Android
- Permission: read-only
A Service start mode indicating that if the host application is stopped by Android, the service should not be restarted automatically.
Use as a `startMode` value in the options object passed to
[createServiceIntent](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#createServiceIntent).
### START_REDELIVER_INTENT
- Type: Number
- Platforms: Android
- Permission: read-only
A Service start mode indicating that if the host application is stopped by Android, the service should be restarted automatically and the original Intent re-sent.
Use as a `startMode` value in the options object passed to
[createServiceIntent](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#createServiceIntent).
### STREAM_ALARM
- Type: Number
- Platforms: Android
- Permission: read-only
Use with [audioStreamType](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#audioStreamType) to
request that the alarm stream type for notifications be used.
### STREAM_DEFAULT
- Type: Number
- Platforms: Android
- Permission: read-only
Use with [audioStreamType](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#audioStreamType) to request that the
default stream type for notifications be used.
### STREAM_MUSIC
- Type: Number
- Platforms: Android
- Permission: read-only
Use with [audioStreamType](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#audioStreamType) to
request that the music stream type for notifications be used.
### STREAM_NOTIFICATION
- Type: Number
- Platforms: Android
- Permission: read-only
Use with [audioStreamType](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#audioStreamType) to request that the
notification stream type for notifications be used.
### STREAM_RING
- Type: Number
- Platforms: Android
- Permission: read-only
Use with [audioStreamType](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#audioStreamType) to request that the
ring stream type for notifications be used.
### STREAM_SYSTEM
- Type: Number
- Platforms: Android
- Permission: read-only
Use with [audioStreamType](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#audioStreamType) to request that the
system stream type for notifications be used.
### STREAM_VOICE_CALL
- Type: Number
- Platforms: Android
- Permission: read-only
Use with [audioStreamType](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#audioStreamType) to request that the
voice call stream type for notifications be used.
### TILE_STATE_ACTIVE
- Type: Number
- Platforms: Android
- Since: Titanium SDK 7.0.0
- Permission: read-only
QuickSettings tile is active.
The Tile is in enabled state and the user can interact with it.
### TILE_STATE_INACTIVE
- Type: Number
- Platforms: Android
- Since: Titanium SDK 7.0.0
- Permission: read-only
QuickSettings tile is inactive.
The Tile is in disabled state, but the user can interact with it.
### TILE_STATE_UNAVAILABLE
- Type: Number
- Platforms: Android
- Since: Titanium SDK 7.0.0
- Permission: read-only
QuickSettings tile is unavailble.
For some reason the Tile is not avaialable to the user and will have no click action.
### URI_INTENT_SCHEME
- Type: Number
- Platforms: Android
- Permission: read-only
The URI scheme used for intent URIs.
### VISIBILITY_PRIVATE
- Type: Number
- Platforms: Android
- Since: Titanium SDK 3.6.0
- Permission: read-only
Shows basic information about the notification.
Use with the [Titanium.Android.Notification.visibility](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#visibility) property.
Only the application name and icon appear in the lock screen with the message: "Contents hidden".
See also: [Notification.VISIBILITY_PRIVATE in the Android API Reference](https://developer.android.com/reference/android/app/Notification.html#VISIBILITY_PRIVATE).
### VISIBILITY_PUBLIC
- Type: Number
- Platforms: Android
- Since: Titanium SDK 3.6.0
- Permission: read-only
Shows the notification's full content on the lockscreen. This is the system default if visibility is left unspecified.
Use with the [Titanium.Android.Notification.visibility](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#visibility) property.
See also: [Notification.VISIBILITY_PUBLIC in the Android API Reference](https://developer.android.com/reference/android/app/Notification.html#VISIBILITY_PUBLIC).
### VISIBILITY_SECRET
- Type: Number
- Platforms: Android
- Since: Titanium SDK 3.6.0
- Permission: read-only
Shows the most minimal information of the notification on the lockscreen.
Use with the [Titanium.Android.Notification.visibility](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#visibility) property.
See also: [Notification.VISIBILITY_SECRET in the Android API Reference](https://developer.android.com/reference/android/app/Notification.html#VISIBILITY_SECRET).
### WAKE_LOCK_ACQUIRE_CAUSES_WAKEUP
- Type: Number
- Platforms: Android
- Since: Titanium SDK 6.2.0
- Permission: read-only
Turn the screen on when the wake lock is acquired.
Use with the [Titanium.Android.Notification.wakeLock](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#wakeLock) property.
See also: [PowerManager.ACQUIRE_CAUSES_WAKEUP in the Android API Reference](https://developer.android.com/reference/android/os/PowerManager.html#ACQUIRE_CAUSES_WAKEUP).
### WAKE_LOCK_FULL
- Type: Number
- Platforms: Android
- Since: Titanium SDK 6.2.0
- Permission: read-only
Ensures that the screen and keyboard backlight are on at full brightness.
Use with the [Titanium.Android.Notification.wakeLock](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#wakeLock) property.
See also: [PowerManager.FULL_WAKE_LOCK in the Android API Reference](https://developer.android.com/reference/android/os/PowerManager.html#FULL_WAKE_LOCK).
### WAKE_LOCK_ON_AFTER_RELEASE
- Type: Number
- Platforms: Android
- Since: Titanium SDK 6.2.0
- Permission: read-only
When this wake lock is released, poke the user activity timer so the screen stays on for a little longer.
Use with the [Titanium.Android.Notification.wakeLock](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#wakeLock) property.
See also: [PowerManager.ON_AFTER_RELEASE in the Android API Reference](https://developer.android.com/reference/android/os/PowerManager.html#ON_AFTER_RELEASE).
### WAKE_LOCK_PARTIAL
- Type: Number
- Platforms: Android
- Since: Titanium SDK 6.2.0
- Permission: read-only
Ensures that the CPU is running; the screen and keyboard backlight will be allowed to go off.
Use with the [Titanium.Android.Notification.wakeLock](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#wakeLock) property.
See also: [PowerManager.PARTIAL_WAKE_LOCK in the Android API Reference](https://developer.android.com/reference/android/os/PowerManager.html#PARTIAL_WAKE_LOCK).
### WAKE_LOCK_SCREEN_BRIGHT
- Type: Number
- Platforms: Android
- Since: Titanium SDK 6.2.0
- Permission: read-only
Ensures that the screen is on at full brightness; the keyboard backlight will be allowed to go off.
Use with the [Titanium.Android.Notification.wakeLock](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#wakeLock) property.
See also: [PowerManager.SCREEN_BRIGHT_WAKE_LOCK in the Android API Reference](https://developer.android.com/reference/android/os/PowerManager.html#SCREEN_BRIGHT_WAKE_LOCK).
### WAKE_LOCK_SCREEN_DIM
- Type: Number
- Platforms: Android
- Since: Titanium SDK 6.2.0
- Permission: read-only
Ensures that the screen is on (but may be dimmed); the keyboard backlight will be allowed to go off.
Use with the [Titanium.Android.Notification.wakeLock](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md#wakeLock) property.
See also: [PowerManager.SCREEN_DIM_WAKE_LOCK in the Android API Reference](https://developer.android.com/reference/android/os/PowerManager.html#SCREEN_DIM_WAKE_LOCK).
## Methods
### createBigPictureStyle
- Platforms: Android
- Since: Titanium SDK 5.4.0
Creates and returns an instance of [Titanium.Android.BigPictureStyle](https://titaniumsdk.com/docs/sdk/Titanium.Android.BigPictureStyle.md).
Parameters:
- `parameters` (Dictionary, optional): Properties to set on a new object, including any defined by [Titanium.Android.BigPictureStyle](https://titaniumsdk.com/docs/sdk/Titanium.Android.BigPictureStyle.md) except those marked not-creation or read-only.
Returns: Titanium.Android.BigPictureStyle
### createBigTextStyle
- Platforms: Android
- Since: Titanium SDK 5.4.0
Creates and returns an instance of [Titanium.Android.BigTextStyle](https://titaniumsdk.com/docs/sdk/Titanium.Android.BigTextStyle.md).
Parameters:
- `parameters` (Dictionary, optional): Properties to set on a new object, including any defined by [Titanium.Android.BigTextStyle](https://titaniumsdk.com/docs/sdk/Titanium.Android.BigTextStyle.md) except those marked not-creation or read-only.
Returns: Titanium.Android.BigTextStyle
### createBroadcastIntent
- Platforms: Android
- Since: Titanium SDK 3.2.0
Create an `Intent` to be used in a broadcast.
Parameters:
- `parameters` (Dictionary, optional): Properties to set on the new object, including any defined by [Titanium.Android.Intent](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md), except those marked not-creation or read-only.
Returns: Titanium.Android.Intent
### createBroadcastReceiver
- Platforms: Android
- Since: Titanium SDK 3.1.0
Creates and returns an instance of [Titanium.Android.BroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.BroadcastReceiver.md).
Parameters:
- `parameters` (Dictionary, optional): Properties to set on a new object, including any defined by [Titanium.Android.BroadcastReceiver](https://titaniumsdk.com/docs/sdk/Titanium.Android.BroadcastReceiver.md) except those marked not-creation or read-only.
Returns: Titanium.Android.BroadcastReceiver
### createIntent
- Platforms: Android
- Since: Titanium SDK 1.5
Creates and returns an instance of [Titanium.Android.Intent](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md).
Parameters:
- `parameters` (Dictionary, optional): Properties to set on a new object, including any defined by [Titanium.Android.Intent](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md) except those marked not-creation or read-only.
Returns: Titanium.Android.Intent
### createIntentChooser
- Platforms: Android
Creates an activity chooser intent, used to allow the user to select a target activity
for an intent.
Use this method when the user wants to take an action that could use any one of a
number of applications. For example, when sending a plain text message, the user
may choose to send a text message, send an email, or post to a social network.
You pass in an [Intent](https://titaniumsdk.com/docs/sdk/Titanium.Android.Intent.md) representing the action being taken,
and a title for the chooser.
The method returns another intent, representing the chooser, which can be used to
start an activity. See the code example for details on how to display the chooser.
For more information, see the official Android documentation for
[Intent.ACTION_CHOOSER](https://developer.android.com/reference/android/content/Intent.html#ACTION_CHOOSER)
Parameters:
- `intent` (Titanium.Android.Intent): The intent to display a chooser for.
- `title` (String): Title to display on the chooser.
Returns: Titanium.Android.Intent
Example: Using a Chooser
The following example uses an activity chooser to send a plain text message.
``` js
var intent = Ti.Android.createIntent( {
action: Ti.Android.ACTION_SEND,
type: 'text/plain'
});
intent.putExtra(Ti.Android.EXTRA_SUBJECT, 'This is the subject.');
intent.putExtra(Ti.Android.EXTRA_TEXT, 'This is some text to send.')
var chooser = Ti.Android.createIntentChooser(intent, 'Send Message');
var activity = Ti.Android.currentActivity.startActivity(chooser);
```
### createNotification
- Platforms: Android
- Since: Titanium SDK 1.5
Creates and returns an instance of [Titanium.Android.Notification](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md).
Parameters:
- `parameters` (Dictionary, optional): Properties to set on a new object, including any defined by [Titanium.Android.Notification](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md) except those marked not-creation or read-only.
Returns: Titanium.Android.Notification
### createNotificationChannel
- Platforms: Android
- Since: Titanium SDK 7.0.0
Creates and returns an instance of [Titanium.Android.NotificationChannel](https://titaniumsdk.com/docs/sdk/Titanium.Android.NotificationChannel.md).
Parameters:
- `parameters` (Dictionary, optional): Properties to set on a new object, including any defined by [Titanium.Android.NotificationChannel](https://titaniumsdk.com/docs/sdk/Titanium.Android.NotificationChannel.md) except those marked not-creation or read-only.
Returns: Titanium.Android.NotificationChannel
### createPendingIntent
- Platforms: Android
Creates a [PendingIntent](https://titaniumsdk.com/docs/sdk/Titanium.Android.PendingIntent.md) to be used inside a
[Notification](https://titaniumsdk.com/docs/sdk/Titanium.Android.Notification.md).
If `FLAG_NO_CREATE` is specified and no matching pending intent exists, returns
`null`.
Parameters:
- `parameters` (Dictionary, optional): Properties to set on the new object, including any defined by [Titanium.Android.PendingIntent](https://titaniumsdk.com/docs/sdk/Titanium.Android.PendingIntent.md), except those marked not-creation or read-only.
Returns: Titanium.Android.PendingIntent
### createQuickSettingsService
- Platforms: Android
- Since: Titanium SDK 7.0
Creates and returns an instance of [Titanium.Android.QuickSettingsService](https://titaniumsdk.com/docs/sdk/Titanium.Android.QuickSettingsService.md).
Parameters:
- `parameters` (Dictionary, optional): Properties to set on a new object, including any defined by [Titanium.Android.QuickSettingsService](https://titaniumsdk.com/docs/sdk/Titanium.Android.QuickSettingsService.md) except those marked not-creation or read-only.
Returns: Titanium.Android.QuickSettingsService
### createRemoteViews
- Platforms: Android
- Since: Titanium SDK 1.6
Creates and returns an instance of [Titanium.Android.RemoteViews](https://titaniumsdk.com/docs/sdk/Titanium.Android.RemoteViews.md).
Parameters:
- `parameters` (Dictionary, optional): Properties to set on a new object, including any defined by [Titanium.Android.RemoteViews](https://titaniumsdk.com/docs/sdk/Titanium.Android.RemoteViews.md) except those marked not-creation or read-only.
Returns: Titanium.Android.RemoteViews
### createService
- Platforms: Android
Create a [Titanium.Android.Service](https://titaniumsdk.com/docs/sdk/Titanium.Android.Service.md) so you can start/stop it and listen for events from it.
Parameters:
- `intent` (Titanium.Android.Intent): An `Intent` created with [createServiceIntent](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#createServiceIntent), which specifies the service to be instantiated.
Returns: Titanium.Android.Service
### createServiceIntent
- Platforms: Android
Create an `Intent` to be used to start a service.
Parameters:
- `options` (ServiceIntentOptions): Options for the Service.
Returns: Titanium.Android.Intent
### hasPermission
- Platforms: Android
- Since: Titanium SDK 5.4.0
Returns `true` if the app has permission access.
Parameters:
- `permission` (String | Array): The permission to check for access. This can be any of the constants listed here with dangerous protection level [here](https://developer.android.com/reference/android/Manifest.permission.html). For example, `android.permission.WRITE_CONTACTS`. Since Titanium 6.1.0, the method will also accept `Array[String](https://titaniumsdk.com/docs/sdk/Global.String.md)`
Returns: Boolean
### isServiceRunning
- Platforms: Android
Check on state of Service.
Parameters:
- `intent` (Titanium.Android.Intent): An `Intent` created with [createServiceIntent](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#createServiceIntent), which specifies the service to check.
Returns: Boolean
### registerBroadcastReceiver
- Platforms: Android
- Since: Titanium SDK 3.1.0
Registers broadcast receiver for the given actions.
Parameters:
- `broadcastReceiver` (Titanium.Android.BroadcastReceiver): The broadcast receiver to register and handle the broadcast.
- `actions` (Array): The actions that the broadcast reciever will handle
### requestPermissions
- Platforms: Android
- Since: Titanium SDK 5.4.0
Request for permission access.
Parameters:
- `permissions` (String | Array): The permission(s) to request for access. This can be any of the constants listed here with dangerous protection level [here](https://developer.android.com/reference/android/Manifest.permission.html). Normal protection permissions are automatically enabled if they are included in the manifest. An example of a dangerous protection permission would be `android.permission.WRITE_CONTACTS`. The requested permission(s) MUST also be included in the Android Manifest. Besides this, there are also requestPermission methods that are ready for commonly used situations. These methods are [Titanium.Calendar.requestCalendarPermissions](https://titaniumsdk.com/docs/sdk/Titanium.Calendar.md#requestCalendarPermissions), [Titanium.Contacts.requestContactsPermissions](https://titaniumsdk.com/docs/sdk/Titanium.Contacts.md#requestContactsPermissions), [Titanium.Filesystem.requestStoragePermissions](https://titaniumsdk.com/docs/sdk/Titanium.Filesystem.md#requestStoragePermissions), [Titanium.Geolocation.requestLocationPermissions](https://titaniumsdk.com/docs/sdk/Titanium.Geolocation.md#requestLocationPermissions) and [Titanium.Media.requestCameraPermissions](https://titaniumsdk.com/docs/sdk/Titanium.Media.md#requestCameraPermissions). Since Titanium 6.1.0, the method will also accept a String. Any requests where permissions are already granted will yield a successful callback.
- `callback` (Callback, optional): Function to call upon user decision to grant access. Optional on SDK 10, as this method will return a `Promise`, which may be used to handle the result.
Returns: Promise - On SDK 10+, this method will return a `Promise` whose resolved value is equivalent to that passed to the optional callback argument.
### startService
- Platforms: Android
Starts a simple service.
Parameters:
- `intent` (Titanium.Android.Intent): An `Intent` created with [createServiceIntent](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#createServiceIntent), which specifies the service to start.
### stopService
- Platforms: Android
Stop a simple service that was started with `startService`.
Parameters:
- `intent` (Titanium.Android.Intent): An `Intent` created with [createServiceIntent](https://titaniumsdk.com/docs/sdk/Titanium.Android.md#createServiceIntent), which specifies the service to stop.
### unregisterBroadcastReceiver
- Platforms: Android
- Since: Titanium SDK 3.1.0
Unregisters a broadcast receiver.
Parameters:
- `broadcastReceiver` (Titanium.Android.BroadcastReceiver): The broadcast receiver to unregister.
## Inherited members
7 members are inherited. Each is documented on the type that declares it.
- [Titanium.Proxy](https://titaniumsdk.com/docs/sdk/12.5.0/Titanium.Proxy.md): `addEventListener`, `apiName`, `applyProperties`, `bubbleParent`, `fireEvent`, `lifecycleContainer`, `removeEventListener`
---
- This corpus documents Titanium SDK 13.4.1. Anything here that does not name a version describes 13.4.1.
- Titanium is maintained by TiDev. The Appcelerator toolchain is retired: there is no `appc` CLI, no Appcelerator Studio and no hosted build service. The supported CLI is `titanium` on npm, invoked as `ti`.