# Titanium.Android

The top-level Android module.

Availability
1.5

# Overview

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 API.

For more information about the action bar, see the Titanium.Android.ActionBar.

# 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.

# 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 (opens new window) and Titanium.Android.BroadcastReceiver.

# 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.

# 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 (opens new window).

# 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.

For Android toast notifications (pop-up notifications sent while the application is in the foreground), see Titanium.UI.Notification.

# 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.

# 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 Titanium.UI.Window.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.

# 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 (opens new window).

In Titanium SDK, to support this, we have the Titanium.Android.requestPermissions method. It is used to request any permission you may need. An example of using it is shown below:

var permissions = [ 'android.permission.CAMERA', 'android.permission.READ_EXTERNAL_STORAGE', 'android.permission.WRITE_EXTERNAL_STORAGE' ];
Ti.Android.requestPermissions(permissions, function (e) {
    if (e.success) {
        Ti.API.info('SUCCESS');
    } else {
        Ti.API.info('ERROR: ' + e.error);
    }
});

# Properties

# currentActivity READONLY

Availability
1.5
currentActivity :Titanium.Android.Activity

References the top-most window's activity.


# currentService READONLY

Availability
1.5
currentService :Titanium.Android.Service

Service in the active context.


# rootActivity READONLY

Availability
8.0.0

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 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 property with the newly received intent.

# Methods

# createBigPictureStyle

Availability
5.4.0
createBigPictureStyle([parameters]) Titanium.Android.BigPictureStyle

Creates and returns an instance of Titanium.Android.BigPictureStyle.

Parameters

Name Type Description
parameters Dictionary<Titanium.Android.BigPictureStyle>

Properties to set on a new object, including any defined by Titanium.Android.BigPictureStyle except those marked not-creation or read-only.

Returns


# createBigTextStyle

Availability
5.4.0
createBigTextStyle([parameters]) Titanium.Android.BigTextStyle

Creates and returns an instance of Titanium.Android.BigTextStyle.

Parameters

Name Type Description
parameters Dictionary<Titanium.Android.BigTextStyle>

Properties to set on a new object, including any defined by Titanium.Android.BigTextStyle except those marked not-creation or read-only.

Returns


# createBroadcastIntent

Availability
3.2.0
createBroadcastIntent([parameters]) Titanium.Android.Intent

Create an Intent to be used in a broadcast.

Parameters

Name Type Description
parameters Dictionary<Titanium.Android.Intent>

Properties to set on the new object, including any defined by Titanium.Android.Intent, except those marked not-creation or read-only.

Returns


# createBroadcastReceiver

Availability
3.1.0
createBroadcastReceiver([parameters]) Titanium.Android.BroadcastReceiver

Creates and returns an instance of Titanium.Android.BroadcastReceiver.

Parameters

Name Type Description
parameters Dictionary<Titanium.Android.BroadcastReceiver>

Properties to set on a new object, including any defined by Titanium.Android.BroadcastReceiver except those marked not-creation or read-only.

Returns


# createIntent

Availability
1.5
createIntent([parameters]) Titanium.Android.Intent

Creates and returns an instance of Titanium.Android.Intent.

Parameters

Name Type Description
parameters Dictionary<Titanium.Android.Intent>

Properties to set on a new object, including any defined by Titanium.Android.Intent except those marked not-creation or read-only.

Returns


# createIntentChooser

Availability
1.5
createIntentChooser(intent, title) Titanium.Android.Intent

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 Titanium.Android.Intent 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

Parameters

Name Type Description
intent Titanium.Android.Intent

The intent to display a chooser for.

title String

Title to display on the chooser.

Returns


# createNotification

Availability
1.5
createNotification([parameters]) Titanium.Android.Notification

Creates and returns an instance of Titanium.Android.Notification.

Parameters

Name Type Description
parameters Dictionary<Titanium.Android.Notification>

Properties to set on a new object, including any defined by Titanium.Android.Notification except those marked not-creation or read-only.

Returns


# createNotificationChannel

Availability
7.0.0
createNotificationChannel([parameters]) Titanium.Android.NotificationChannel

Creates and returns an instance of Titanium.Android.NotificationChannel.

Parameters

Name Type Description
parameters Dictionary<Titanium.Android.NotificationChannel>

Properties to set on a new object, including any defined by Titanium.Android.NotificationChannel except those marked not-creation or read-only.

Returns


# createPendingIntent

Availability
1.5
createPendingIntent([parameters]) Titanium.Android.PendingIntent

If FLAG_NO_CREATE is specified and no matching pending intent exists, returns null.

Parameters

Name Type Description
parameters Dictionary<Titanium.Android.PendingIntent>

Properties to set on the new object, including any defined by Titanium.Android.PendingIntent, except those marked not-creation or read-only.

Returns


# createQuickSettingsService

Availability
7.0
createQuickSettingsService([parameters]) Titanium.Android.QuickSettingsService

Creates and returns an instance of Titanium.Android.QuickSettingsService.

Parameters

Name Type Description
parameters Dictionary<Titanium.Android.QuickSettingsService>

Properties to set on a new object, including any defined by Titanium.Android.QuickSettingsService except those marked not-creation or read-only.

Returns


# createRemoteViews

Availability
1.6
createRemoteViews([parameters]) Titanium.Android.RemoteViews

Creates and returns an instance of Titanium.Android.RemoteViews.

Parameters

Name Type Description
parameters Dictionary<Titanium.Android.RemoteViews>

Properties to set on a new object, including any defined by Titanium.Android.RemoteViews except those marked not-creation or read-only.

Returns


# createService

Availability
1.5
createService(intent) Titanium.Android.Service

Create a Titanium.Android.Service so you can start/stop it and listen for events from it.

Parameters

Name Type Description
intent Titanium.Android.Intent

An Intent created with createServiceIntent, which specifies the service to be instantiated.

Returns


# createServiceIntent

Availability
1.5
createServiceIntent(options) Titanium.Android.Intent

Create an Intent to be used to start a service.

Parameters

Name Type Description
options ServiceIntentOptions

Options for the Service.

Returns


# hasPermission

Availability
5.4.0
hasPermission(permission) Boolean

Returns true if the app has permission access.

Parameters

Name Type Description
permission String | Array<String>

The permission to check for access. This can be any of the constants listed here with dangerous protection level here. For example, android.permission.WRITE_CONTACTS.

Since Titanium 6.1.0, the method will also accept Array<String>

Returns

Type
Boolean

# isServiceRunning

Availability
1.5
isServiceRunning(intent) Boolean

Check on state of Service.

Parameters

Name Type Description
intent Titanium.Android.Intent

An Intent created with createServiceIntent, which specifies the service to check.

Returns

Type
Boolean

# registerBroadcastReceiver

Availability
3.1.0
registerBroadcastReceiver(broadcastReceiver, actions) void

Registers broadcast receiver for the given actions.

Parameters

Name Type Description
broadcastReceiver Titanium.Android.BroadcastReceiver

The broadcast receiver to register and handle the broadcast.

actions Array<String>

The actions that the broadcast reciever will handle

Returns

Type
void

# requestPermissions

Availability
5.4.0
requestPermissions(permissions[, callback]) Promise<RequestPermissionAccessResult>

Request for permission access.

Parameters

Name Type Description
permissions String | Array<String>

The permission(s) to request for access. This can be any of the constants listed here with dangerous protection level here. 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 requestCalendarPermissions, requestContactsPermissions, requestStoragePermissions, requestLocationPermissions and 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<RequestPermissionAccessResult>

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

On SDK 10+, this method will return a Promise whose resolved value is equivalent to that passed to the optional callback argument.

Type
Promise<RequestPermissionAccessResult>

# startService

Availability
1.5
startService(intent) void

Starts a simple service.

Parameters

Name Type Description
intent Titanium.Android.Intent

An Intent created with createServiceIntent, which specifies the service to start.

Returns

Type
void

# stopService

Availability
1.5
stopService(intent) void

Stop a simple service that was started with startService.

Parameters

Name Type Description
intent Titanium.Android.Intent

An Intent created with createServiceIntent, which specifies the service to stop.

Returns

Type
void

# unregisterBroadcastReceiver

Availability
3.1.0
unregisterBroadcastReceiver(broadcastReceiver) void

Unregisters a broadcast receiver.

Parameters

Name Type Description
broadcastReceiver Titanium.Android.BroadcastReceiver

The broadcast receiver to unregister.

Returns

Type
void

# Constants

# ACTION_AIRPLANE_MODE_CHANGED

Availability
1.5
ACTION_AIRPLANE_MODE_CHANGED :String

User switched airplane mode on or off.

Pass to the registerBroadcastReceiver method to listen to the system broadcast.

See Intent.ACTION_AIRPLANE_MODE_CHANGED in the Android API Reference.


# ACTION_ALL_APPS

Availability
1.5
ACTION_ALL_APPS :String

List all applications.

Use with the action property to create an Activity Intent.

See Intent.ACTION_ALL_APPS in the Android API Reference.


# ACTION_ANSWER

Availability
1.5
ACTION_ANSWER :String

Handle an incoming phone call.

Use with the action property to create an Activity Intent.

See Intent.ACTION_ANSWER in the Android API Reference.


# ACTION_ATTACH_DATA

Availability
1.5
ACTION_ATTACH_DATA :String

Used to indicate that the data is an attachment.

Use with the action property to create an Activity Intent.

See Intent.ACTION_ATTACH_DATA in the Android API Reference.


# ACTION_BATTERY_CHANGED

Availability
1.5
ACTION_BATTERY_CHANGED :String

Listen to battery state change status.

Pass to the registerBroadcastReceiver method to listen to the system broadcast.

Note that Titanium exposes battery monitoring using the Titanium.Platform API.

See Intent.ACTION_BATTERY_CHANGED in the Android API Reference.


# ACTION_BATTERY_LOW

Availability
1.5
ACTION_BATTERY_LOW :String

Indicates low battery condition on the device.

Pass to the registerBroadcastReceiver method to listen to the system broadcast.

Note that Titanium exposes battery monitoring using the Titanium.Platform API.

See Intent.ACTION_BATTERY_LOW in the Android API Reference.


# ACTION_BATTERY_OKAY

Availability
1.5
ACTION_BATTERY_OKAY :String

Inidicates the battery is now okay after being low.

Pass to the registerBroadcastReceiver method to listen to the system broadcast.

Note that Titanium exposes battery monitoring using the Titanium.Platform API.

See Intent.ACTION_BATTERY_OKAY in the Android API Reference.


# ACTION_BOOT_COMPLETED

Availability
1.5
ACTION_BOOT_COMPLETED :String

Indicates the system has finished booting.

Pass to the 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.

<ti:app>
    <android>
        <manifest>
            <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED"/>
        </manifest>
    </android>
</ti:app>

See Intent.ACTION_BOOT_COMPLETED in the Android API Reference.


# ACTION_BUG_REPORT

Availability
1.5
ACTION_BUG_REPORT :String

Show activity for reporting a bug.

Use with the action property to create an Activity Intent.

See Intent.ACTION_BUG_REPORT in the Android API Reference.


# ACTION_CALL

Availability
1.5
ACTION_CALL :String

Perform a call to someone specified by the data property.

Use with the action property to create an Activity Intent.

See Intent.ACTION_CALL in the Android API Reference.


# ACTION_CALL_BUTTON

Availability
1.5
ACTION_CALL_BUTTON :String

User pressed the call button.

Use with the action property to create an Activity Intent.

See Intent.ACTION_CALL_BUTTON in the Android API Reference.


# ACTION_CAMERA_BUTTON

Availability
1.5
ACTION_CAMERA_BUTTON :String

The camera button was pressed.

Pass to the registerBroadcastReceiver method to listen to the system broadcast.

See Intent.ACTION_CAMERA_BUTTON in the Android API Reference.


# ACTION_CHOOSER

Availability
1.5
ACTION_CHOOSER :String

Display an activity chooser.

Use with the action property to create an Activity Chooser.

You can also create an activity chooser using the createIntentChooser method.

See Intent.ACTION_CHOOSER in the Android API Reference.


# ACTION_CLOSE_SYSTEM_DIALOGS

Availability
1.5
ACTION_CLOSE_SYSTEM_DIALOGS :String

User dismissed a temporary system dialog, such as the notification drawer or recent-app drawer.

Pass to the registerBroadcastReceiver method to listen to the system broadcast.

See Intent.ACTION_CLOSE_SYSTEM_DIALOGS in the Android API Reference.


# ACTION_CONFIGURATION_CHANGED

Availability
1.5
ACTION_CONFIGURATION_CHANGED :String

The device's configuration changed.

Pass to the registerBroadcastReceiver method to listen to the system broadcast.

See Intent.ACTION_CONFIGURATION_CHANGED in the Android API Reference.


# ACTION_CREATE_SHORTCUT

Availability
1.5
ACTION_CREATE_SHORTCUT :String

Create a shortcut.

Use with the action property to create an Activity Intent.

See Intent.ACTION_CREATE_SHORTCUT in the Android API Reference.


# ACTION_DATE_CHANGED

Availability
1.5
ACTION_DATE_CHANGED :String

Date changed.

Pass to the registerBroadcastReceiver method to listen to the system broadcast.

See Intent.ACTION_DATE_CHANGED in the Android API Reference.


# ACTION_DEFAULT

Availability
1.5
ACTION_DEFAULT :String

Default action, which is Titanium.Android.ACTION_VIEW

Use with the action property to create an Activity Intent.

See Intent.ACTION_DEFAULT in the Android API Reference.


# ACTION_DELETE

Availability
1.5
ACTION_DELETE :String

Delete the data specified by the Intent's data property.

Use with the action property to create an Activity Intent.

See Intent.ACTION_DELETE in the Android API Reference.


# ACTION_DEVICE_STORAGE_LOW

Availability
1.5
ACTION_DEVICE_STORAGE_LOW :String

Indicates a low memory condition on the device.

Pass to the registerBroadcastReceiver method to listen to the system broadcast.

See Intent.ACTION_DEVICE_STORAGE_LOW in the Android API Reference.


# ACTION_DIAL

Availability
1.5
ACTION_DIAL :String

Dial a number specified by the Intent's data property.

Use with the action property to create an Activity Intent.

See Intent.ACTION_DIAL in the Android API Reference.


# ACTION_EDIT

Availability
1.5
ACTION_EDIT :String

Provide editable access to the data specified by the Intent's data property.

Use with the action property to create an Activity Intent.

See Intent.ACTION_EDIT in the Android API Reference.


# ACTION_GET_CONTENT

Availability
1.5
ACTION_GET_CONTENT :String

Allow the user to select a particular kind of data specified by the Intent's type property.

Use with the action property to create an Activity Intent.

See Intent.ACTION_GET_CONTENT in the Android API Reference.


# ACTION_GTALK_SERVICE_CONNECTED

Availability
1.5
ACTION_GTALK_SERVICE_CONNECTED :String

GTalk connection has been established.

Pass to the registerBroadcastReceiver method to listen to the system broadcast.

See Intent.ACTION_GTALK_SERVICE_CONNECTED in the Android API Reference.


# ACTION_GTALK_SERVICE_DISCONNECTED

Availability
1.5
ACTION_GTALK_SERVICE_DISCONNECTED :String

GTalk connection has been disconnected.

Pass to the registerBroadcastReceiver method to listen to the system broadcast.

See Intent.ACTION_GTALK_SERVICE_DISCONNECTED in the Android API Reference.


# ACTION_HEADSET_PLUG

Availability
1.5
ACTION_HEADSET_PLUG :String

A wired headset has been plugged in or unplugged.

Pass to the registerBroadcastReceiver method to listen to the system broadcast.

See Intent.ACTION_HEADSET_PLUG in the Android API Reference.


# ACTION_INPUT_METHOD_CHANGED

Availability
1.5
ACTION_INPUT_METHOD_CHANGED :String

An input method has been changed.

Pass to the registerBroadcastReceiver method to listen to the system broadcast.

See Intent.ACTION_INPUT_METHOD_CHANGED in the Android API Reference.


# ACTION_INSERT

Availability
1.5
ACTION_INSERT :String

Insert an empty item into the given container.

Use with the action property to create an Activity Intent.

See Intent.ACTION_INSERT in the Android API Reference.


# ACTION_INSERT_OR_EDIT

Availability
1.5
ACTION_INSERT_OR_EDIT :String

Pick an existing item or insert an empty item, then edit it.

Use with the action property to create an Activity Intent.

See Intent.ACTION_INSERT_OR_EDIT in the Android API Reference.


# ACTION_MAIN

Availability
1.5
ACTION_MAIN :String

Start as the main entry point.

Use with the action property to create an Activity Intent.

See Intent.ACTION_MAIN in the Android API Reference.


# ACTION_MANAGE_PACKAGE_STORAGE

Availability
1.5
ACTION_MANAGE_PACKAGE_STORAGE :String

Indicates low memory condition notification acknowledged by user and package management should be started.

Pass to the registerBroadcastReceiver method to listen to the system broadcast.

See Intent.ACTION_MANAGE_PACKAGE_STORAGE in the Android API Reference.


# ACTION_MEDIA_BAD_REMOVAL

Availability
1.5
ACTION_MEDIA_BAD_REMOVAL :String

External media was removed from SD card slot, but mount point was not unmounted.

Pass to the registerBroadcastReceiver method to listen to the system broadcast.

See Intent.ACTION_MEDIA_BAD_REMOVAL in the Android API Reference.


# ACTION_MEDIA_BUTTON

Availability
1.5
ACTION_MEDIA_BUTTON :String

The media button was pressed.

Pass to the registerBroadcastReceiver method to listen to the system broadcast.

See Intent.ACTION_MEDIA_BUTTON in the Android API Reference.


# ACTION_MEDIA_CHECKING

Availability
1.5
ACTION_MEDIA_CHECKING :String

External media is present and being disk-checked.

Pass to the registerBroadcastReceiver method to listen to the system broadcast.

See Intent.ACTION_MEDIA_CHECKING in the Android API Reference.


# ACTION_MEDIA_EJECT

Availability
1.5
ACTION_MEDIA_EJECT :String

User has expressed the desire to remove the external storage media.

Pass to the 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.


# ACTION_MEDIA_MOUNTED

Availability
1.5
ACTION_MEDIA_MOUNTED :String

External media is present and mounted at its mount point.

Pass to the registerBroadcastReceiver method to listen to the system broadcast.

See Intent.ACTION_MEDIA_MOUNTED in the Android API Reference.


# ACTION_MEDIA_NOFS

Availability
1.5
ACTION_MEDIA_NOFS :String

External media is present, but is using an incompatible filesystem or is blank.

Pass to the registerBroadcastReceiver method to listen to the system broadcast.

See Intent.ACTION_MEDIA_NOFS in the Android API Reference.


# ACTION_MEDIA_REMOVED

Availability
1.5
ACTION_MEDIA_REMOVED :String

External media has been removed.

Pass to the registerBroadcastReceiver method to listen to the system broadcast.

See Intent.ACTION_MEDIA_REMOVED in the Android API Reference.


# ACTION_MEDIA_SCANNER_FINISHED

Availability
1.5
ACTION_MEDIA_SCANNER_FINISHED :String

The media scanner has finished scanning a directory.

Pass to the registerBroadcastReceiver method to listen to the system broadcast.

See Intent.ACTION_MEDIA_SCANNER_FINISHED in the Android API Reference.


# ACTION_MEDIA_SCANNER_SCAN_FILE

Availability
1.5
ACTION_MEDIA_SCANNER_SCAN_FILE :String

Request the media scanner to scan a file and add it to the media database.

Pass to the registerBroadcastReceiver method to listen to the system broadcast.

See Intent.ACTION_MEDIA_SCANNER_SCAN_FILE in the Android API Reference.


# ACTION_MEDIA_SCANNER_STARTED

Availability
1.5
ACTION_MEDIA_SCANNER_STARTED :String

The media scanner has started scanning a directory.

Pass to the registerBroadcastReceiver method to listen to the system broadcast.

See Intent.ACTION_MEDIA_SCANNER_STARTED in the Android API Reference.


# ACTION_MEDIA_SHARED

Availability
1.5
ACTION_MEDIA_SHARED :String

External media is unmounted because it is being shared via USB mass storage.

Pass to the registerBroadcastReceiver method to listen to the system broadcast.

See Intent.ACTION_MEDIA_SHARED in the Android API Reference.


# ACTION_MEDIA_UNMOUNTABLE

Availability
1.5
ACTION_MEDIA_UNMOUNTABLE :String

Corresponds to the Android Intent.ACTION_MEDIA_UNMOUNTABLE constant.

Pass to the registerBroadcastReceiver method to listen to the system broadcast.

See Intent.ACTION_MEDIA_UNMOUNTABLE in the Android API Reference.


# ACTION_MEDIA_UNMOUNTED

Availability
1.5
ACTION_MEDIA_UNMOUNTED :String

External media is present, but not mounted at its mount point.

Pass to the registerBroadcastReceiver method to listen to the system broadcast.

See Intent.ACTION_MEDIA_UNMOUNTED in the Android API Reference.


# ACTION_NEW_OUTGOING_CALL

Availability
1.5
ACTION_NEW_OUTGOING_CALL :String

An outgoing call is about to be placed.

Pass to the 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.

<ti:app>
    <android>
        <manifest>
            <uses-permission android:name="android.permission.NEW_OUTGOING_CALL"/>
        </manifest>
    </android>
</ti:app>

See Intent.ACTION_NEW_OUTGOING_CALL in the Android API Reference.


# ACTION_PACKAGE_ADDED

Availability
1.5
ACTION_PACKAGE_ADDED :String

A new application package has been installed on the device.

Pass to the registerBroadcastReceiver method to listen to the system broadcast.

See Intent.ACTION_PACKAGE_ADDED in the Android API Reference.


# ACTION_PACKAGE_CHANGED

Availability
1.5
ACTION_PACKAGE_CHANGED :String

An existing application package has been changed.

Pass to the registerBroadcastReceiver method to listen to the system broadcast.

See Intent.ACTION_PACKAGE_CHANGED in the Android API Reference.


# ACTION_PACKAGE_DATA_CLEARED

Availability
1.5
ACTION_PACKAGE_DATA_CLEARED :String

The user has cleared the data of a package.

Pass to the registerBroadcastReceiver method to listen to the system broadcast.

See Intent.ACTION_PACKAGE_DATA_CLEARED in the Android API Reference.


# ACTION_PACKAGE_REMOVED

Availability
1.5
ACTION_PACKAGE_REMOVED :String

An existing application package has been removed from the device.

Pass to the registerBroadcastReceiver method to listen to the system broadcast.

See Intent.ACTION_PACKAGE_REMOVED in the Android API Reference.


# ACTION_PACKAGE_REPLACED

Availability
1.5
ACTION_PACKAGE_REPLACED :String

A new version of an application package has been installed, replacing an existing version that was previously installed.

Pass to the registerBroadcastReceiver method to listen to the system broadcast.

See Intent.ACTION_PACKAGE_REPLACED in the Android API Reference.


# ACTION_PACKAGE_RESTARTED

Availability
1.5
ACTION_PACKAGE_RESTARTED :String

The user has restarted a package, and all of its processes have been killed.

Pass to the registerBroadcastReceiver method to listen to the system broadcast.

See Intent.ACTION_PACKAGE_RESTARTED in the Android API Reference.


# ACTION_PICK

Availability
1.5
ACTION_PICK :String

Pick an item from the directory indicated by the Intent's data property.

Use with the action property to create an Activity Intent.

See Intent.ACTION_PICK in the Android API Reference.


# ACTION_PICK_ACTIVITY

Availability