forked from tidev/titanium-sdk
-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathAndroid.yml
More file actions
2592 lines (2095 loc) · 109 KB
/
Android.yml
File metadata and controls
2592 lines (2095 loc) · 109 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
---
name: Titanium.Android
summary: The top-level Android module.
description: |
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 API reference](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 API reference](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](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](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 API reference](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](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](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 API reference](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 [exitOnClose](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 API reference](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](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. `<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:
``` 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);
}
});
```
extends: Titanium.Module
platforms: [android]
since: "1.5"
methods:
- name: createIntentChooser
summary: |
Creates an activity chooser intent, used to allow the user to select a target activity
for an intent.
description: |
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](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](https://developer.android.com/reference/android/content/Intent.html#ACTION_CHOOSER)
parameters:
- name: intent
summary: The intent to display a chooser for.
type: Titanium.Android.Intent
- name: title
summary: Title to display on the chooser.
type: String
returns:
type: Titanium.Android.Intent
examples:
- title: Using a Chooser
example: |
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);
```
- name: createPendingIntent
summary: |
Creates a [PendingIntent](Titanium.Android.PendingIntent) to be used inside a
[Notification](Titanium.Android.Notification).
description: |
If `FLAG_NO_CREATE` is specified and no matching pending intent exists, returns
`null`.
returns:
type: Titanium.Android.PendingIntent
parameters:
- name: parameters
summary: |
Properties to set on the new object, including any defined by
<Titanium.Android.PendingIntent>, except those marked not-creation or read-only.
type: Dictionary<Titanium.Android.PendingIntent>
optional: true
- name: createService
summary: Create a <Titanium.Android.Service> so you can start/stop it and listen for events from it.
returns:
type: Titanium.Android.Service
parameters:
- name: intent
summary: |
An `Intent` created with [createServiceIntent](Titanium.Android.createServiceIntent),
which specifies the service to be instantiated.
type: Titanium.Android.Intent
- name: createServiceIntent
summary: Create an `Intent` to be used to start a service.
returns:
type: Titanium.Android.Intent
parameters:
- name: options
summary: Options for the Service.
type: ServiceIntentOptions
- name: hasPermission
summary: Returns `true` if the app has permission access.
parameters:
- name: permission
summary: |
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>`
type: [String, Array<String>]
returns:
type: Boolean
since: "5.4.0"
- name: requestPermissions
summary: Request for permission access.
parameters:
- name: permissions
summary: |
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>, <Titanium.Contacts.requestContactsPermissions>,
<Titanium.Filesystem.requestStoragePermissions>, <Titanium.Geolocation.requestLocationPermissions> and <Titanium.Media.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.
type: [String, Array<String>]
- name: callback
summary: |
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.
type: Callback<RequestPermissionAccessResult>
optional: true
returns:
summary: 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>
since: "5.4.0"
- name: isServiceRunning
summary: Check on state of Service.
returns:
type: Boolean
parameters:
- name: intent
summary: |
An `Intent` created with [createServiceIntent](Titanium.Android.createServiceIntent),
which specifies the service to check.
type: Titanium.Android.Intent
- name: registerBroadcastReceiver
summary: Registers broadcast receiver for the given actions.
parameters:
- name: broadcastReceiver
summary: |
The broadcast receiver to register and handle the broadcast.
type: Titanium.Android.BroadcastReceiver
- name: actions
summary: |
The actions that the broadcast reciever will handle
type: Array<String>
since: "3.1.0"
- name: unregisterBroadcastReceiver
summary: Unregisters a broadcast receiver.
parameters:
- name: broadcastReceiver
summary: |
The broadcast receiver to unregister.
type: Titanium.Android.BroadcastReceiver
since: "3.1.0"
- name: startService
summary: Starts a simple service.
parameters:
- name: intent
summary: |
An `Intent` created with [createServiceIntent](Titanium.Android.createServiceIntent),
which specifies the service to start.
type: Titanium.Android.Intent
- name: stopService
summary: Stop a simple service that was started with `startService`.
parameters:
- name: intent
summary: |
An `Intent` created with [createServiceIntent](Titanium.Android.createServiceIntent),
which specifies the service to stop.
type: Titanium.Android.Intent
- name: createBroadcastIntent
summary: Create an `Intent` to be used in a broadcast.
returns:
type: Titanium.Android.Intent
parameters:
- name: parameters
summary: |
Properties to set on the new object, including any defined by
<Titanium.Android.Intent>, except those marked not-creation or read-only.
type: Dictionary<Titanium.Android.Intent>
optional: true
since: "3.2.0"
properties:
- name: ACTION_AIRPLANE_MODE_CHANGED
summary: User switched airplane mode on or off.
description: |
Pass to the <Titanium.Android.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).
type: String
permission: read-only
- name: ACTION_ALL_APPS
summary: List all applications.
description: |
Use with the <Titanium.Android.Intent.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).
type: String
permission: read-only
- name: ACTION_ANSWER
summary: Handle an incoming phone call.
description: |
Use with the <Titanium.Android.Intent.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).
type: String
permission: read-only
- name: ACTION_ATTACH_DATA
summary: Used to indicate that the data is an attachment.
description: |
Use with the <Titanium.Android.Intent.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).
type: String
permission: read-only
- name: ACTION_BATTERY_CHANGED
summary: Listen to battery state change status.
description: |
Pass to the <Titanium.Android.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](https://developer.android.com/reference/android/content/Intent.html#ACTION_BATTERY_CHANGED).
type: String
permission: read-only
- name: ACTION_BATTERY_LOW
summary: Indicates low battery condition on the device.
description: |
Pass to the <Titanium.Android.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](https://developer.android.com/reference/android/content/Intent.html#ACTION_BATTERY_LOW).
type: String
permission: read-only
- name: ACTION_BATTERY_OKAY
summary: Inidicates the battery is now okay after being low.
description: |
Pass to the <Titanium.Android.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](https://developer.android.com/reference/android/content/Intent.html#ACTION_BATTERY_OKAY).
type: String
permission: read-only
- name: ACTION_BOOT_COMPLETED
summary: Indicates the system has finished booting.
description: |
Pass to the <Titanium.Android.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
<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](https://developer.android.com/reference/android/content/Intent.html#ACTION_BOOT_COMPLETED).
type: String
permission: read-only
- name: ACTION_BUG_REPORT
summary: Show activity for reporting a bug.
description: |
Use with the <Titanium.Android.Intent.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).
type: String
permission: read-only
- name: ACTION_CALL
summary: Perform a call to someone specified by the `data` property.
description: |
Use with the <Titanium.Android.Intent.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).
type: String
permission: read-only
- name: ACTION_CALL_BUTTON
summary: User pressed the call button.
description: |
Use with the <Titanium.Android.Intent.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).
type: String
permission: read-only
- name: ACTION_CAMERA_BUTTON
summary: The camera button was pressed.
description: |
Pass to the <Titanium.Android.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).
type: String
permission: read-only
- name: ACTION_CHOOSER
summary: Display an activity chooser.
description: |
Use with the <Titanium.Android.Intent.action> property to create an Activity Chooser.
You can also create an activity chooser using the <Titanium.Android.createIntentChooser> method.
See [Intent.ACTION_CHOOSER in the Android API Reference](https://developer.android.com/reference/android/content/Intent.html#ACTION_CHOOSER).
type: String
permission: read-only
- name: ACTION_CLOSE_SYSTEM_DIALOGS
summary: User dismissed a temporary system dialog, such as the notification drawer or recent-app drawer.
description: |
Pass to the <Titanium.Android.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).
type: String
permission: read-only
- name: ACTION_CONFIGURATION_CHANGED
summary: The device's configuration changed.
description: |
Pass to the <Titanium.Android.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).
type: String
permission: read-only
- name: ACTION_CREATE_SHORTCUT
summary: Create a shortcut.
description: |
Use with the <Titanium.Android.Intent.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).
type: String
permission: read-only
- name: ACTION_DATE_CHANGED
summary: Date changed.
description: |
Pass to the <Titanium.Android.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).
type: String
permission: read-only
- name: ACTION_DEFAULT
summary: Default action, which is `Titanium.Android.ACTION_VIEW`
description: |
Use with the <Titanium.Android.Intent.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).
type: String
permission: read-only
- name: ACTION_DELETE
summary: Delete the data specified by the Intent's `data` property.
description: |
Use with the <Titanium.Android.Intent.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).
type: String
permission: read-only
- name: ACTION_DEVICE_STORAGE_LOW
summary: Indicates a low memory condition on the device.
description: |
Pass to the <Titanium.Android.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).
type: String
permission: read-only
- name: ACTION_DIAL
summary: Dial a number specified by the Intent's `data` property.
description: |
Use with the <Titanium.Android.Intent.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).
type: String
permission: read-only
- name: ACTION_EDIT
summary: Provide editable access to the data specified by the Intent's `data` property.
description: |
Use with the <Titanium.Android.Intent.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).
type: String
permission: read-only
- name: ACTION_GET_CONTENT
summary: Allow the user to select a particular kind of data specified by the Intent's `type` property.
description: |
Use with the <Titanium.Android.Intent.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).
type: String
permission: read-only
- name: ACTION_GTALK_SERVICE_CONNECTED
summary: GTalk connection has been established.
description: |
Pass to the <Titanium.Android.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).
type: String
permission: read-only
- name: ACTION_GTALK_SERVICE_DISCONNECTED
summary: GTalk connection has been disconnected.
description: |
Pass to the <Titanium.Android.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).
type: String
permission: read-only
- name: ACTION_HEADSET_PLUG
summary: A wired headset has been plugged in or unplugged.
description: |
Pass to the <Titanium.Android.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).
type: String
permission: read-only
- name: ACTION_INPUT_METHOD_CHANGED
summary: An input method has been changed.
description: |
Pass to the <Titanium.Android.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).
type: String
permission: read-only
- name: ACTION_INSERT
summary: Insert an empty item into the given container.
description: |
Use with the <Titanium.Android.Intent.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).
type: String
permission: read-only
- name: ACTION_INSERT_OR_EDIT
summary: Pick an existing item or insert an empty item, then edit it.
description: |
Use with the <Titanium.Android.Intent.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).
type: String
permission: read-only
- name: ACTION_MAIN
summary: Start as the main entry point.
description: |
Use with the <Titanium.Android.Intent.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).
type: String
permission: read-only
- name: ACTION_MANAGE_PACKAGE_STORAGE
summary: Indicates low memory condition notification acknowledged by user and package management should be started.
description: |
Pass to the <Titanium.Android.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).
type: String
permission: read-only
- name: ACTION_MEDIA_BAD_REMOVAL
summary: External media was removed from SD card slot, but mount point was not unmounted.
description: |
Pass to the <Titanium.Android.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).
type: String
permission: read-only
- name: ACTION_MEDIA_BUTTON
summary: The media button was pressed.
description: |
Pass to the <Titanium.Android.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).
type: String
permission: read-only
- name: ACTION_MEDIA_CHECKING
summary: External media is present and being disk-checked.
description: |
Pass to the <Titanium.Android.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).
type: String
permission: read-only
- name: ACTION_MEDIA_EJECT
summary: User has expressed the desire to remove the external storage media.
description: |
Pass to the <Titanium.Android.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).
type: String
permission: read-only
- name: ACTION_MEDIA_MOUNTED
summary: External media is present and mounted at its mount point.
description: |
Pass to the <Titanium.Android.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).
type: String
permission: read-only
- name: ACTION_MEDIA_NOFS
summary: External media is present, but is using an incompatible filesystem or is blank.
description: |
Pass to the <Titanium.Android.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).
type: String
permission: read-only
- name: ACTION_MEDIA_REMOVED
summary: External media has been removed.
description: |
Pass to the <Titanium.Android.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).
type: String
permission: read-only
- name: ACTION_MEDIA_SCANNER_FINISHED
summary: The media scanner has finished scanning a directory.
description: |
Pass to the <Titanium.Android.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).
type: String
permission: read-only
- name: ACTION_MEDIA_SCANNER_SCAN_FILE
summary: Request the media scanner to scan a file and add it to the media database.
description: |
Pass to the <Titanium.Android.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).
type: String
permission: read-only
- name: ACTION_MEDIA_SCANNER_STARTED
summary: The media scanner has started scanning a directory.
description: |
Pass to the <Titanium.Android.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).
type: String
permission: read-only
- name: ACTION_MEDIA_SHARED
summary: External media is unmounted because it is being shared via USB mass storage.
description: |
Pass to the <Titanium.Android.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).
type: String
permission: read-only
- name: ACTION_MEDIA_UNMOUNTABLE
summary: Corresponds to the Android `Intent.ACTION_MEDIA_UNMOUNTABLE` constant.
description: |
Pass to the <Titanium.Android.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).
type: String
permission: read-only
- name: ACTION_MEDIA_UNMOUNTED
summary: External media is present, but not mounted at its mount point.
description: |
Pass to the <Titanium.Android.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).
type: String
permission: read-only
- name: ACTION_NEW_OUTGOING_CALL
summary: An outgoing call is about to be placed.
description: |
Pass to the <Titanium.Android.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
<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](https://developer.android.com/reference/android/content/Intent.html#ACTION_NEW_OUTGOING_CALL).
type: String
permission: read-only
- name: ACTION_PACKAGE_ADDED
summary: A new application package has been installed on the device.
description: |
Pass to the <Titanium.Android.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).
type: String
permission: read-only
- name: ACTION_PACKAGE_CHANGED
summary: An existing application package has been changed.
description: |
Pass to the <Titanium.Android.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).
type: String
permission: read-only
- name: ACTION_PACKAGE_DATA_CLEARED
summary: The user has cleared the data of a package.
description: |
Pass to the <Titanium.Android.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).
type: String
permission: read-only
- name: ACTION_PACKAGE_REMOVED
summary: An existing application package has been removed from the device.
description: |
Pass to the <Titanium.Android.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).
type: String
permission: read-only
- name: ACTION_PACKAGE_REPLACED
summary: A new version of an application package has been installed, replacing an existing version that was previously installed.
description: |
Pass to the <Titanium.Android.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).
type: String
permission: read-only
- name: ACTION_PACKAGE_RESTARTED
summary: The user has restarted a package, and all of its processes have been killed.
description: |
Pass to the <Titanium.Android.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).
type: String
permission: read-only
- name: ACTION_PICK
summary: Pick an item from the directory indicated by the Intent's `data` property.
description: |
Use with the <Titanium.Android.Intent.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).
type: String
permission: read-only
- name: ACTION_PICK_ACTIVITY
summary: Pick an activity given an intent.
description: |
Use with the <Titanium.Android.Intent.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).
type: String
permission: read-only
- name: ACTION_POWER_CONNECTED
summary: External power has been connected to the device.
description: |
Pass to the <Titanium.Android.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).
type: String
permission: read-only
- name: ACTION_POWER_DISCONNECTED
summary: External power has been disconnected from the device.
description: |
Pass to the <Titanium.Android.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).
type: String
permission: read-only
- name: ACTION_POWER_USAGE_SUMMARY
summary: Show power usage information to the user.
description: |
Use with the <Titanium.Android.Intent.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).
type: String
permission: read-only
- name: ACTION_PROVIDER_CHANGED
summary: Content provider published new events or items.
description: |
Pass to the <Titanium.Android.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).
type: String
permission: read-only
- name: ACTION_REBOOT
summary: Device rebooted.
description: |
**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).
type: String
permission: read-only
- name: ACTION_RUN
summary: Run the data.
description: |
Use with the <Titanium.Android.Intent.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).
type: String
permission: read-only
- name: ACTION_SCREEN_OFF
summary: Sent when the device goes to sleep and becomes non-interactive.
description: |
Pass to the <Titanium.Android.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).
type: String
permission: read-only
- name: ACTION_SCREEN_ON
summary: Sent when the device wakes up and becomes interactive.
description: |
Pass to the <Titanium.Android.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).
type: String
permission: read-only
- name: ACTION_SEARCH
summary: Perform a search.
description: |
Use with the <Titanium.Android.Intent.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).
type: String
permission: read-only
- name: ACTION_SEARCH_LONG_PRESS
summary: Start action associated with long pressing on the search key.
description: |
Use with the <Titanium.Android.Intent.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).
type: String
permission: read-only
- name: ACTION_SEND
summary: Deliver data to another activity.
description: |
Use with the <Titanium.Android.Intent.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).
type: String
permission: read-only
- name: ACTION_SENDTO
summary: Deliver data to the recipient specified by the Intent's `data` property.
description: |
Use with the <Titanium.Android.Intent.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).
type: String
permission: read-only
- name: ACTION_SEND_MULTIPLE
summary: Deliver multiple data to another activity.
description: |
Use with the <Titanium.Android.Intent.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).
type: String
permission: read-only
- name: ACTION_SET_WALLPAPER
summary: Show settings for choosing the system wallpaper.
description: |
Use with the <Titanium.Android.Intent.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).
type: String
permission: read-only
- name: ACTION_SHUTDOWN
summary: Device is shutting down.
description: |
Pass to the <Titanium.Android.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).
type: String
permission: read-only
- name: ACTION_SYNC
summary: Perform data synchronization.
description: |
Use with the <Titanium.Android.Intent.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).
type: String
permission: read-only
- name: ACTION_SYSTEM_TUTORIAL
summary: Start the platform-defined tutorial.
description: |
Use with the <Titanium.Android.Intent.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).
type: String
permission: read-only
- name: ACTION_TIME_CHANGED
summary: The time was set.
description: |
Pass to the <Titanium.Android.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).
type: String
permission: read-only
- name: ACTION_TIME_TICK
summary: The current time changed. Sent every minute.
description: |
Pass to the <Titanium.Android.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).