# Titanium.Android
The top-level Android module.
# 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).
Starting with Android 13 you have to use more granular media permissions. Check the official documentation (opens new window).
Make sure to add e.g. <uses-permission android:name="android.permission.READ_MEDIA_IMAGES"/>
to your tiapp.xml too.
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' ];
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
# apiName READONLY
The name of the API that this proxy corresponds to.
The value of this property is the fully qualified name of the API. For example, Titanium.UI.Button
returns Ti.UI.Button
.
# bubbleParent
Indicates if the proxy will bubble an event to its parent.
Some proxies (most commonly views) have a relationship to other proxies, often established by the add() method. For example, for a button added to a window, a click event on the button would bubble up to the window. Other common parents are table sections to their rows, table views to their sections, and scrollable views to their views. Set this property to false to disable the bubbling to the proxy's parent.
Default: true
# currentActivity READONLY
References the top-most window's activity.
# lifecycleContainer
The Window or TabGroup whose Activity lifecycle should be triggered on the proxy.
If this property is set to a Window or TabGroup, then the corresponding Activity lifecycle event callbacks will also be called on the proxy. Proxies that require the activity lifecycle will need this property set to the appropriate containing Window or TabGroup.
# rootActivity READONLY
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
# addEventListener
Adds the specified callback as an event listener for the named event.
Parameters
Name | Type | Description |
---|---|---|
name | String | Name of the event. |
callback | Callback<Titanium.Event> | Callback function to invoke when the event is fired. |
Returns
- Type
- void
# applyProperties
Applies the properties to the proxy.
Properties are supplied as a dictionary. Each key-value pair in the object is applied to the proxy such that myproxy[key] = value.
Parameters
Name | Type | Description |
---|---|---|
props | Dictionary | A dictionary of properties to apply. |
Returns
- Type
- void
# createBigPictureStyle
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
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
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
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
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
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
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
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
Creates a Titanium.Android.PendingIntent to be used inside a Titanium.Android.Notification.
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
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
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
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 |
Returns
# createServiceIntent
Create an Intent
to be used to start a service.
Parameters
Name | Type | Description |
---|---|---|
options | ServiceIntentOptions | Options for the Service. |
Returns
# fireEvent
Fires a synthesized event to any registered listeners.
Parameters
Name | Type | Description |
---|---|---|
name | String | Name of the event. |
event | Dictionary | A dictionary of keys and values to add to the Titanium.Event object sent to the listeners. |
Returns
- Type
- void
# hasPermission
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, Since Titanium 6.1.0, the method will also accept |
Returns
- Type
- Boolean
# isServiceRunning
Check on state of Service.
Parameters
Name | Type | Description |
---|---|---|
intent | Titanium.Android.Intent | An |
Returns
- Type
- Boolean
# registerBroadcastReceiver
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
# removeEventListener
Removes the specified callback as an event listener for the named event.
Multiple listeners can be registered for the same event, so the
callback
parameter is used to determine which listener to remove.
When adding a listener, you must save a reference to the callback function in order to remove the listener later:
var listener = function() { Ti.API.info("Event listener called."); }
window.addEventListener('click', listener);
To remove the listener, pass in a reference to the callback function:
window.removeEventListener('click', listener);
Parameters
Name | Type | Description |
---|---|---|
name | String | Name of the event. |
callback | Callback<Titanium.Event> | Callback function to remove. Must be the same function passed to |
Returns
- Type
- void
# requestPermissions
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 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 |
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
Starts a simple service.
Parameters
Name | Type | Description |
---|---|---|
intent | Titanium.Android.Intent | An |
Returns
- Type
- void
# stopService
Stop a simple service that was started with startService
.
Parameters
Name | Type | Description |
---|---|---|
intent | Titanium.Android.Intent | An |
Returns
- Type
- void
# unregisterBroadcastReceiver
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
Pick an activity given an intent.
Use with the 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.
# ACTION_POWER_CONNECTED
External power has been connected to the device.
Pass to the registerBroadcastReceiver method to listen to the system broadcast.
See Intent.ACTION_POWER_CONNECTED in the Android API Reference.
# ACTION_POWER_DISCONNECTED
External power has been disconnected from the device.
Pass to the registerBroadcastReceiver method to listen to the system broadcast.
See Intent.ACTION_POWER_DISCONNECTED in the Android API Reference.
# ACTION_POWER_USAGE_SUMMARY
Show power usage information to the user.
Use with the action property to create an Activity Intent.
See Intent.ACTION_POWER_USAGE_SUMMARY in the Android API Reference.
# ACTION_PROVIDER_CHANGED
Content provider published new events or items.
Pass to the registerBroadcastReceiver method to listen to the system broadcast.
See Intent.ACTION_PROVIDER_CHANGED in the Android API Reference.
# ACTION_REBOOT
Device rebooted.
Only used by the system.
See Intent.ACTION_REBOOT in the Android API Reference.
# ACTION_RUN
Run the data.
Use with the action property to create an Activity Intent.
See Intent.ACTION_RUN in the Android API Reference.
# ACTION_SCREEN_OFF
Sent when the device goes to sleep and becomes non-interactive.
Pass to the registerBroadcastReceiver method to listen to the system broadcast.
See Intent.ACTION_SCREEN_OFF in the Android API Reference.
# ACTION_SCREEN_ON
Sent when the device wakes up and becomes interactive.
Pass to the registerBroadcastReceiver method to listen to the system broadcast.
See Intent.ACTION_SCREEN_ON in the Android API Reference.
# ACTION_SEARCH
Perform a search.
Use with the action property to create an Activity Intent.
See Intent.ACTION_SEARCH in the Android API Reference.
# ACTION_SEARCH_LONG_PRESS
Start action associated with long pressing on the search key.
Use with the action property to create an Activity Intent.
See Intent.ACTION_SEARCH_LONG_PRESS in the Android API Reference.
# ACTION_SEND
Deliver data to another activity.
Use with the action property to create an Activity Intent.
See Intent.ACTION_SEND in the Android API Reference.
# ACTION_SEND_MULTIPLE
Deliver multiple data to another activity.
Use with the action property to create an Activity Intent.
See Intent.ACTION_SEND_MULTIPLE in the Android API Reference.
# ACTION_SENDTO
Deliver data to the recipient specified by the Intent's data
property.
Use with the action property to create an Activity Intent.
See Intent.ACTION_SENDTO in the Android API Reference.
# ACTION_SET_WALLPAPER
Show settings for choosing the system wallpaper.
Use with the action property to create an Activity Intent.
See Intent.ACTION_SET_WALLPAPER in the Android API Reference.
# ACTION_SHUTDOWN
Device is shutting down.
Pass to the registerBroadcastReceiver method to listen to the system broadcast.
See Intent.ACTION_SHUTDOWN in the Android API Reference.
# ACTION_SYNC
Perform data synchronization.
Use with the action property to create an Activity Intent.
See Intent.ACTION_SYNC in the Android API Reference.
# ACTION_SYSTEM_TUTORIAL
Start the platform-defined tutorial.
Use with the action property to create an Activity Intent.
See Intent.ACTION_SYSTEM_TUTORIAL in the Android API Reference.
# ACTION_TIME_CHANGED
The time was set.
Pass to the registerBroadcastReceiver method to listen to the system broadcast.
See Intent.ACTION_TIME_CHANGED in the Android API Reference.
# ACTION_TIME_TICK
The current time changed. Sent every minute.
Pass to the registerBroadcastReceiver method to listen to the system broadcast.
See Intent.ACTION_TIME_TICK in the Android API Reference.
# ACTION_UID_REMOVED
A user ID was removed from the system.
Pass to the registerBroadcastReceiver method to listen to the system broadcast.
See Intent.ACTION_UID_REMOVED in the Android API Reference.
# ACTION_USER_PRESENT
Sent when the user is present after device wakes up.
Pass to the registerBroadcastReceiver method to listen to the system broadcast.
See Intent.ACTION_USER_PRESENT in the Android API Reference.
# ACTION_VIEW
Display data to the user.
Use with the action property to create an Activity Intent.
See Intent.ACTION_VIEW in the Android API Reference.
# ACTION_VOICE_COMMAND
Start voice command.
Use with the action property to create an Activity Intent.
See Intent.ACTION_VOICE_COMMAND in the Android API Reference.
# ACTION_WALLPAPER_CHANGED
The current system wallpaper has changed.
Pass to the registerBroadcastReceiver method to listen to the system broadcast.
See Intent.ACTION_WALLPAPER_CHANGED in the Android API Reference.
# ACTION_WEB_SEARCH
Perform a web search.
Use with the action property to create an Activity Intent.
See Intent.ACTION_WEB_SEARCH in the Android API Reference.
# CATEGORY_ALARM
Notification category indicating an alarm or timer.
Use with the category property.
See Notification.CATEGORY_ALARM in the Android API Reference.
# CATEGORY_ALTERNATIVE
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 method to set a category.
See Intent.CATEGORY_ALTERNATIVE in the Android API Reference.
# CATEGORY_BROWSABLE
Activity can browse the Internet.
Pass to the Intent's 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.
# CATEGORY_CALL
Notification category indicating an incoming call (voice or video) or similar synchronous communication request.
Use with the category property.
See Notification.CATEGORY_CALL in the Android API Reference.
# CATEGORY_DEFAULT
Activity should be used as the default action to perform on a piece of data.
Pass to the Intent's addCategory method to set a category.
See Intent.CATEGORY_DEFAULT in the Android API Reference.
# CATEGORY_DEVELOPMENT_PREFERENCE
Activity is in the development preference panel.
Pass to the Intent's addCategory method to set a category.
See Intent.CATEGORY_DEVELOPMENT_PREFERENCE in the Android API Reference.
# CATEGORY_EMAIL
Notification category indicating an asynchronous bulk message (email).
Use with the category property.
See Notification.CATEGORY_EMAIL in the Android API Reference.
# CATEGORY_EMBED
Activity can run inside a parent activity.
See Intent.CATEGORY_EMBED in the Android API Reference.
# CATEGORY_ERROR
Notification category indicating an error in background operation or authentication status.
Use with the category property.
See Notification.CATEGORY_ERROR in the Android API Reference.
# CATEGORY_EVENT
Notification category indicating a calendar event.
Use with the category property.
See Notification.CATEGORY_EVENT in the Android API Reference.
# CATEGORY_FRAMEWORK_INSTRUMENTATION_TEST
To be used as test code for framework instrumentation tests.
See Intent.CATEGORY_FRAMEWORK_INSTRUMENTATION_TEST in the Android API Reference.
# CATEGORY_HOME
Home activity, the first activity that is displayed when the device boots.
Pass to the Intent's addCategory method to set a category.
See Intent.CATEGORY_HOME in the Android API Reference.
# CATEGORY_INFO
Provides information about the package it is in.
Pass to the Intent's addCategory method to set a category.
See Intent.CATEGORY_INFO in the Android API Reference.
# CATEGORY_LAUNCHER
Activity is in the device's launcher.
Pass to the Intent's addCategory method to set a category.
See Intent.CATEGORY_LAUNCHER in the Android API Reference.
# CATEGORY_MESSAGE
Notification category indicating an incoming direct message (SMS, instant message, etc.).
Use with the category property.
See Notification.CATEGORY_MESSAGE in the Android API Reference.
# CATEGORY_MONKEY
This activity may be exercised by the monkey or other automated test tools.
See Intent.CATEGORY_MONKEY in the Android API Reference.
# CATEGORY_OPENABLE
Activity can open raw file://
or scheme://
URIs.
See Intent.CATEGORY_OPENABLE in the Android API Reference.
# CATEGORY_PREFERENCE
This activity is a preference panel.
Pass to the Intent's addCategory method to set a category.
See Intent.CATEGORY_PREFERENCE in the Android API Reference.
# CATEGORY_PROGRESS
Notification category indicating the progress of a long-running background operation.
Use with the category property.
See Notification.CATEGORY_PROGRESS in the Android API Reference.
# CATEGORY_PROMO
Notification category indicating a promotion or advertisement.
Use with the category property.
See Notification.CATEGORY_PROMO in the Android API Reference.
# CATEGORY_RECOMMENDATION
Notification category indicating a specific, timely recommendation for a single thing.
Use with the category property.
See Notification.CATEGORY_RECOMMENDATION in the Android API Reference.
# CATEGORY_SAMPLE_CODE
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.
# CATEGORY_SELECTED_ALTERNATIVE
Activity should be considered as an alternative selection action to the data the user has currently selected.
Pass to the Intent's addCategory method to set a category.
See Intent.CATEGORY_SELECTED_ALTERNATIVE in the Android API Reference.
# CATEGORY_SERVICE
Notification category for a running background service.
Use with the category property.
See Notification.CATEGORY_SERVICE in the Android API Reference.
# CATEGORY_SOCIAL
Notification category for a social network or sharing update.
Use with the category property.
See Notification.CATEGORY_SOCIAL in the Android API Reference.
# CATEGORY_STATUS
Notification category indicating ongoing information about device or contextual status.
Use with the category property.
See Notification.CATEGORY_STATUS in the Android API Reference.
# CATEGORY_TAB
Activity to be used in a tab activity.
Pass to the Intent's addCategory method to set a category.
See Intent.CATEGORY_TAB in the Android API Reference.
# CATEGORY_TEST
To be used as a test (not part of the normal user experience).
Pass to the Intent's addCategory method to set a category.
See Intent.CATEGORY_TEST in the Android API Reference.
# CATEGORY_TRANSPORT
Notification category indicating media transport control for playback.
Use with the category property.
See Notification.CATEGORY_TRANSPORT in the Android API Reference.
# CATEGORY_UNIT_TEST
To be used as a unit test (run through the Test Harness).
See Intent.CATEGORY_UNIT_TEST in the Android API Reference.
# DEFAULT_ALL
Use all default settings for a notification; see defaults.
See Notification.DEFAULT_ALL in the Android API Reference.
# DEFAULT_LIGHTS
Use the default light settings for a notification; see defaults.
See Notification.DEFAULT_LIGHTS in the Android API Reference.
# DEFAULT_SOUND
Use the default sound settings for a notification; see defaults.
See Notification.DEFAULT_SOUND in the Android API Reference.
# DEFAULT_VIBRATE
Use the default vibration settings for a notification; see defaults.
See Notification.DEFAULT_VIBRATE in the Android API Reference.
# EXTRA_ALARM_COUNT
Integer indicating how many pending alarms are being delivered with the intent.
See Intent.EXTRA_ALARM_COUNT in the Android API Reference.
# EXTRA_BCC
String array containing e-mail addresses for blind carbon copying.
See Intent.EXTRA_BCC in the Android API Reference.
# EXTRA_CC
String array containing e-mail addresses for carbon copying.
See Intent.EXTRA_CC in the Android API Reference.
# EXTRA_DATA_REMOVED
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.
# EXTRA_DONT_KILL_APP
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.
# EXTRA_EMAIL
String array containing e-mail addresses.
See Intent.EXTRA_EMAIL in the Android API Reference.
# EXTRA_INTENT
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.
# EXTRA_KEY_EVENT
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.
# EXTRA_PHONE_NUMBER
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.
# EXTRA_REPLACING
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.
# EXTRA_SHORTCUT_ICON
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.
# EXTRA_SHORTCUT_ICON_RESOURCE
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.
# EXTRA_SHORTCUT_INTENT
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.
# EXTRA_SHORTCUT_NAME
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.
# EXTRA_STREAM
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.
# EXTRA_SUBJECT
Subject line of a message.
See Intent.EXTRA_SUBJECT in the Android API Reference.
# EXTRA_TEMPLATE
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.
# EXTRA_TEXT
Corresponds to the Android Intent.EXTRA_TEXT
constant.
See Intent.EXTRA_TEXT in the Android API Reference.
# EXTRA_TITLE
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.
# EXTRA_UID
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.
# FILL_IN_ACTION
Not used.
See Intent.FILL_IN_ACTION in the Android API Reference.
# FILL_IN_CATEGORIES
Not used.
See Intent.FILL_IN_CATEGORIES in the Android API Reference.
# FILL_IN_COMPONENT
Not used.
See Intent.FILL_IN_COMPONENT in the Android API Reference.
# FILL_IN_PACKAGE
Not used.
See Intent.FILL_IN_PACKAGE in the Android API Reference.
# FLAG_ACTIVITY_BROUGHT_TO_FRONT
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.
# FLAG_ACTIVITY_CLEAR_TOP
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.
# FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET
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.
# FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS
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.
# FLAG_ACTIVITY_FORWARD_RESULT
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.
# FLAG_ACTIVITY_LAUNCHED_FROM_HISTORY
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.
# FLAG_ACTIVITY_MULTIPLE_TASK
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.
# FLAG_ACTIVITY_NEW_TASK
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.
# FLAG_ACTIVITY_NO_ANIMATION
Prevent transition animation.
Bitwise-OR the constant with the Intent's flags
property.
See Intent.FLAG_ACTIVITY_NO_ANIMATION in the Android API Reference.
# FLAG_ACTIVITY_NO_HISTORY
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.
# FLAG_ACTIVITY_NO_USER_ACTION
Disables the onUserLeaveHint() callback.
Bitwise-OR the constant with the Intent's flags
property.
See Intent.FLAG_ACTIVITY_NO_USER_ACTION in the Android API Reference.
# FLAG_ACTIVITY_PREVIOUS_IS_TOP
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.
# FLAG_ACTIVITY_REORDER_TO_FRONT
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.
# FLAG_ACTIVITY_RESET_TASK_IF_NEEDED
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.
# FLAG_ACTIVITY_SINGLE_TOP
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.
# FLAG_AUTO_CANCEL
Cancel the notification when it is clicked by the user.
Use with flags.
See also: Notification.FLAG_AUTO_CANCEL in the Android API Reference.
# FLAG_CANCEL_CURRENT
Cancel the current pending intent before creating a new one.
Use with the flags property.
See PendingIntent.FLAG_CANCEL_CURRENT in the Android API Reference.
# FLAG_DEBUG_LOG_RESOLUTION
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.
# FLAG_FROM_BACKGROUND
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.
# FLAG_GRANT_READ_URI_PERMISSION
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.
# FLAG_GRANT_WRITE_URI_PERMISSION
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.
# FLAG_IMMUTABLE
Pending intent should be immutable.
Use with the flags property.
See PendingIntent.FLAG_IMMUTABLE in the Android API Reference.
# FLAG_INSISTENT
Repeat audio until the notification is cancelled or the notification window is opened.
Use with flags.
See also: Notification.FLAG_INSISTENT in the Android API Reference.
# FLAG_MUTABLE
Pending intent should be mutable.
Use with the flags property.
See PendingIntent.FLAG_MUTABLE in the Android API Reference.
# FLAG_NO_CLEAR
Do not cancel the notification when the user clicks the Clear All button.
Use with flags.
See also: Notification.FLAG_NO_CLEAR in the Android API Reference.
# FLAG_NO_CREATE
If the current intent does not exist, do not create it.
Use with the flags property.
See PendingIntent.FLAG_NO_CREATE in the Android API Reference.
# FLAG_ONE_SHOT
The pending intent can only be used once.
Use with the flags property.
See PendingIntent.FLAG_ONE_SHOT in the Android API Reference.
# FLAG_ONGOING_EVENT
Specifies that a notification is in reference to something that is ongoing, like a phone call.
Use with flags.
See also: Notification.FLAG_ONGOING_EVENT in the Android API Reference.
# FLAG_ONLY_ALERT_ONCE
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 flags.
See also: Notification.FLAG_ONLY_ALERT_ONCE in the Android API Reference.
# FLAG_RECEIVER_REGISTERED_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.
# FLAG_SHOW_LIGHTS
Use LED lights to alert the user to the notification.
Use with flags.
See also: Notification.FLAG_SHOW_LIGHTS in the Android API Reference.
# FLAG_UPDATE_CURRENT
If the current pending intent already exists, only update the current intent's extra data.
Use with the flags property.
See PendingIntent.FLAG_UPDATE_CURRENT in the Android API Reference.
# FOREGROUND_SERVICE_TYPE_CAMERA
Allows the camera to be used while the app is in the background.
This constant is passed to the foregroundNotify method.
To use this constant, you must also set your <service/>
element to the
foregroundServieType
attribute value as shown below.
<ti:app>
<android>
<services>
<service url="<YourService.js>" android:foregroundServiceType="camera"/>
</services>
</android>
</ti:app>
See Google's ServiceInfo.FOREGROUND_SERVICE_TYPE_CAMERA documentation for more details.
# FOREGROUND_SERVICE_TYPE_CONNECTED_DEVICE
Allows connecting to Android Auto, bluetooth, TV or other devices while app is in the background.
This constant is passed to the foregroundNotify method.
To use this constant, you must also set your <service/>
element to the
foregroundServieType
attribute value as shown below.
<ti:app>
<android>
<services>
<service url="<YourService.js>" android:foregroundServiceType="connectedDevice"/>
</services>
</android>
</ti:app>
See Google's ServiceInfo.FOREGROUND_SERVICE_TYPE_CONNECTED_DEVICE documentation for more details.
# FOREGROUND_SERVICE_TYPE_LOCATION
Allows accessing location from the GPS, map, etc. while the app is in the background.
This constant is passed to the foregroundNotify method.
To use this constant, you must also set your <service/>
element to the
foregroundServieType
attribute value as shown below.
<ti:app>
<android>
<services>
<service url="<YourService.js>" android:foregroundServiceType="location"/>
</services>
</android>
</ti:app>
See Google's ServiceInfo.FOREGROUND_SERVICE_TYPE_LOCATION documentation for more details.
# FOREGROUND_SERVICE_TYPE_MANIFEST
A special value indicates to use all types set in manifest file.
This constant is passed to the foregroundNotify method.
See Google's ServiceInfo.FOREGROUND_SERVICE_TYPE_MANIFEST documentation for more details.
# FOREGROUND_SERVICE_TYPE_MEDIA_PLAYBACK
Allows music, video, news or other media playback while the app is in the background.
This constant is passed to the foregroundNotify method.
To use this constant, you must also set your <service/>
element to the
foregroundServieType
attribute value as shown below.
<ti:app>
<android>
<services>
<service url="<YourService.js>" android:foregroundServiceType="mediaPlayback"/>
</services>
</android>
</ti:app>
See Google's ServiceInfo.FOREGROUND_SERVICE_TYPE_MEDIA_PLAYBACK documentation for more details.
# FOREGROUND_SERVICE_TYPE_MEDIA_PROJECTION
Allows managing a media projection session for screen recording or taking screenshots while app is in the background.
This constant is passed to the foregroundNotify method.
To use this constant, you must also set your <service/>
element to the
foregroundServieType
attribute value as shown below.
<ti:app>
<android>
<services>
<service url="<YourService.js>" android:foregroundServiceType="mediaProjection"/>
</services>
</android>
</ti:app>
See Google's ServiceInfo.FOREGROUND_SERVICE_TYPE_MEDIA_PROJECTION documentation for more details.
# FOREGROUND_SERVICE_TYPE_MICROPHONE
Allows the microphone to be used while the app is in the background.
This constant is passed to the foregroundNotify method.
To use this constant, you must also set your <service/>
element to the
foregroundServieType
attribute value as shown below.
<ti:app>
<android>
<services>
<service url="<YourService.js>" android:foregroundServiceType="microphone"/>
</services>
</android>
</ti:app>
See Google's ServiceInfo.FOREGROUND_SERVICE_TYPE_MICROPHONE documentation for more details.
# FOREGROUND_SERVICE_TYPE_NONE
The default foreground service type.
This constant is passed to the foregroundNotify method.
See Google's ServiceInfo.FOREGROUND_SERVICE_TYPE_NONE documentation for more details.
# FOREGROUND_SERVICE_TYPE_PHONE_CALL
Allows ongoing phone call or video conferencing access while the app is in the background.
This constant is passed to the foregroundNotify method.
To use this constant, you must also set your <service/>
element to the
foregroundServieType
attribute value as shown below.
<ti:app>
<android>
<services>
<service url="<YourService.js>" android:foregroundServiceType="phoneCall"/>
</services>
</android>
</ti:app>
See Google's ServiceInfo.FOREGROUND_SERVICE_TYPE_PHONE_CALL documentation for more details.
# IMPORTANCE_DEFAULT
Used with Titanium.Android.NotificationChannel to specify an importance level.
# IMPORTANCE_HIGH
Used with Titanium.Android.NotificationChannel to specify an importance level.
# IMPORTANCE_LOW
Used with Titanium.Android.NotificationChannel to specify an importance level.
# IMPORTANCE_MAX
Used with Titanium.Android.NotificationChannel to specify an importance level.
# IMPORTANCE_MIN
Used with Titanium.Android.NotificationChannel to specify an importance level.
# IMPORTANCE_NONE
Used with Titanium.Android.NotificationChannel to specify an importance level.
# IMPORTANCE_UNSPECIFIED
Used with Titanium.Android.NotificationChannel to specify an importance level.
# NAVIGATION_MODE_STANDARD
Standard Action Bar navigation mode.
Use with the navigationMode property. Note: NAVIGATION_MODE_STANDARD has been deprecated in API level 21 and up.
# NAVIGATION_MODE_TABS
Action Bar tab navigation mode.
Use with the navigationMode property. Note: NAVIGATION_MODE_TABS has been deprecated in API level 21 and up.
# PENDING_INTENT_FOR_ACTIVITY DEPRECATED
DEPRECATED SINCE 2.0.0
Not used.
# PENDING_INTENT_FOR_BROADCAST DEPRECATED
DEPRECATED SINCE 2.0.0
Not used.
# PENDING_INTENT_FOR_SERVICE DEPRECATED
DEPRECATED SINCE 2.0.0
Not used.
# PENDING_INTENT_MAX_VALUE DEPRECATED
DEPRECATED SINCE 2.0.0
Not used.
# PRIORITY_DEFAULT
Default priority if it does not fit into another priority category.
Use with the priority property.
See also: Notification.PRIORITY_DEFAULT in the Android API Reference.
# PRIORITY_HIGH
Use for high priority notifications like real-time chat messages.
Use with the priority property.
See also: Notification.PRIORITY_HIGH in the Android API Reference.
# PRIORITY_LOW
Use for low priority notifications like software updates.
Use with the priority property.
See also: Notification.PRIORITY_LOW in the Android API Reference.
# PRIORITY_MAX
Use for urgent or time-critical notifications, for example, turn-by-turn directions or emergency alerts.
Use with the priority property.
See also: Notification.PRIORITY_MAX in the Android API Reference.
# PRIORITY_MIN
Use for expired events.
Use with the 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.
# RESULT_CANCELED
Used with setResult to specify that an activity was canceled.
# RESULT_FIRST_USER
Used with setResult to specify a user-defined result.
User-defined result constants values start at RESULT_FIRST_USER
.
# SCREEN_ORIENTATION_BEHIND
Use with requestedOrientation to specify the activity should run in the same orientation as the activity behind it in the activity stack.
# SCREEN_ORIENTATION_LANDSCAPE
Use with requestedOrientation to specify a landscape screen orientation.
# SCREEN_ORIENTATION_NOSENSOR
Use with requestedOrientation to specify that the sensor should be ignored and the display should not rotate.
# SCREEN_ORIENTATION_PORTRAIT
Use with requestedOrientation to specify a portrait screen orientation.
# SCREEN_ORIENTATION_SENSOR
Use with requestedOrientation to specify that orientation should be determined by the orientation sensor.
# SCREEN_ORIENTATION_UNSPECIFIED
Use with requestedOrientation to specify that the system should use its default rules for determining the best orientation.
# SCREEN_ORIENTATION_USER
Use with requestedOrientation to specify that the system should use the user's preferred orientation.
# SHOW_AS_ACTION_ALWAYS
Always show this item as an action button in the action bar.
Use with the MenuItem's showAsAction property.
# SHOW_AS_ACTION_COLLAPSE_ACTION_VIEW
The action view can collapse to a normal menu item.
Use with the MenuItem's showAsAction property.
# SHOW_AS_ACTION_IF_ROOM
Show this item as an action button if the system decides there is room for it.
Use with the MenuItem's showAsAction property.
# SHOW_AS_ACTION_NEVER
Never display this item as an action button in the action bar.
Use with the MenuItem's showAsAction property.
# SHOW_AS_ACTION_WITH_TEXT
When this item is in the action bar, always show it with a text label.
Use with the MenuItem's showAsAction property.
# START_NOT_STICKY
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.
# START_REDELIVER_INTENT
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.
# STREAM_ALARM
Use with audioStreamType to request that the alarm stream type for notifications be used.
# STREAM_DEFAULT
Use with audioStreamType to request that the default stream type for notifications be used.
# STREAM_MUSIC
Use with audioStreamType to request that the music stream type for notifications be used.
# STREAM_NOTIFICATION
Use with audioStreamType to request that the notification stream type for notifications be used.
# STREAM_RING
Use with audioStreamType to request that the ring stream type for notifications be used.
# STREAM_SYSTEM
Use with audioStreamType to request that the system stream type for notifications be used.
# STREAM_VOICE_CALL
Use with audioStreamType to request that the voice call stream type for notifications be used.
# TILE_STATE_ACTIVE
QuickSettings tile is active.
The Tile is in enabled state and the user can interact with it.
# TILE_STATE_INACTIVE
QuickSettings tile is inactive.
The Tile is in disabled state, but the user can interact with it.
# TILE_STATE_UNAVAILABLE
QuickSettings tile is unavailble.
For some reason the Tile is not avaialable to the user and will have no click action.
# VISIBILITY_PRIVATE
Shows basic information about the notification.
Use with the 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.
# VISIBILITY_PUBLIC
Shows the notification's full content on the lockscreen. This is the system default if visibility is left unspecified.
Use with the visibility property.
See also: Notification.VISIBILITY_PUBLIC in the Android API Reference.
# VISIBILITY_SECRET
Shows the most minimal information of the notification on the lockscreen.
Use with the visibility property.
See also: Notification.VISIBILITY_SECRET in the Android API Reference.
# WAKE_LOCK_ACQUIRE_CAUSES_WAKEUP
Turn the screen on when the wake lock is acquired.
Use with the wakeLock property.
See also: PowerManager.ACQUIRE_CAUSES_WAKEUP in the Android API Reference.
# WAKE_LOCK_FULL
Ensures that the screen and keyboard backlight are on at full brightness.
Use with the wakeLock property.
See also: PowerManager.FULL_WAKE_LOCK in the Android API Reference.
# WAKE_LOCK_ON_AFTER_RELEASE
When this wake lock is released, poke the user activity timer so the screen stays on for a little longer.
Use with the wakeLock property.
See also: PowerManager.ON_AFTER_RELEASE in the Android API Reference.
# WAKE_LOCK_PARTIAL
Ensures that the CPU is running; the screen and keyboard backlight will be allowed to go off.
Use with the wakeLock property.
See also: PowerManager.PARTIAL_WAKE_LOCK in the Android API Reference.
# WAKE_LOCK_SCREEN_BRIGHT
Ensures that the screen is on at full brightness; the keyboard backlight will be allowed to go off.
Use with the wakeLock property.
See also: PowerManager.SCREEN_BRIGHT_WAKE_LOCK in the Android API Reference.
# WAKE_LOCK_SCREEN_DIM
Ensures that the screen is on (but may be dimmed); the keyboard backlight will be allowed to go off.
Use with the wakeLock property.
See also: PowerManager.SCREEN_DIM_WAKE_LOCK in the Android API Reference.