• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# Application Permission Groups
2
3<!--Kit: Ability Kit-->
4<!--Subsystem: Security-->
5<!--Owner: @xia-bubai-->
6<!--SE: @linshuqing; @hehehe-li-->
7<!--TSE: @leiyuqian-->
8
9## Usage Guidelines
10
11- It will be helpful if you understand [permission groups and permissions](app-permission-mgmt-overview.md#permission-groups-and-permissions) before requesting permission groups for your application.
12
13- A permission group is a logical grouping of related permissions. When a permission is requested, the members of the group are presented together in the user interface, making it easier for the user to manage permissions. If the user grants the permission, all the permissions in the permission group will be granted in a unified manner. For security purposes, the Location, Contacts, Call Logs, Phone, Messaging, and Calendar permission groups do not support unified authorization.
14
15  The following uses the Location and Camera permission groups as an example.
16
17  - When an application requests only the ohos.permission.APPROXIMATELY_LOCATION permission (belong to the Location permission group), a dialog box containing only the requested permission will be displayed to request user authorization.
18  - When an application requests the ohos.permission.APPROXIMATELY_LOCATION and ohos.permission.LOCATION permissions (belonging to the Location permission group), a dialog box containing only the requested permissions will be displayed to request user authorization.
19  - When an application requests ohos.permission.APPROXIMATELY_LOCATION (belonging to the Location permission group) and ohos.permission.CAMERA (belonging to the Camera permission group), two dialog boxes will be displayed to request the location and camera permissions, respectively.
20
21- The following lists the permission groups supported by the system. For details about the permissions, see [Open user_grant Permissions](permissions-for-all-user.md).
22
23## Location <!--Del-->Information<!--DelEnd-->
24
25- [ohos.permission.LOCATION_IN_BACKGROUND](permissions-for-all-user.md#ohospermissionlocation_in_background)
26
27- [ohos.permission.LOCATION](permissions-for-all-user.md#ohospermissionlocation)
28
29- [ohos.permission.APPROXIMATELY_LOCATION](permissions-for-all-user.md#ohospermissionapproximately_location)
30
31## Camera
32
33- [ohos.permission.CAMERA](permissions-for-all-user.md#ohospermissioncamera)
34
35## Microphone
36
37- [ohos.permission.MICROPHONE](permissions-for-all-user.md#ohospermissionmicrophone)
38
39## Contacts
40
41- [ohos.permission.READ_CONTACTS](restricted-permissions.md#ohospermissionread_contacts)
42
43- [ohos.permission.WRITE_CONTACTS](restricted-permissions.md#ohospermissionwrite_contacts)
44
45## Calendar
46
47- [ohos.permission.READ_CALENDAR](permissions-for-all-user.md#ohospermissionread_calendar)
48
49- [ohos.permission.WRITE_CALENDAR](permissions-for-all-user.md#ohospermissionwrite_calendar)
50
51<!--Del-->
52- [ohos.permission.READ_WHOLE_CALENDAR](permissions-for-system-apps-user.md#ohospermissionread_whole_calendar)
53
54- [ohos.permission.WRITE_WHOLE_CALENDAR](permissions-for-system-apps-user.md#ohospermissionwrite_whole_calendar)
55<!--DelEnd-->
56
57<!--RP1-->
58## Fitness
59
60- [ohos.permission.ACTIVITY_MOTION](permissions-for-all-user.md#ohospermissionactivity_motion)
61
62## Body Sensors
63
64- [ohos.permission.READ_HEALTH_DATA](permissions-for-all-user.md#ohospermissionread_health_data)
65<!--RP1End-->
66
67## Images and Videos
68
69- [ohos.permission.WRITE_IMAGEVIDEO](restricted-permissions.md#ohospermissionwrite_imagevideo)
70
71- [ohos.permission.READ_IMAGEVIDEO](restricted-permissions.md#ohospermissionread_imagevideo)
72
73- [ohos.permission.MEDIA_LOCATION](permissions-for-all-user.md#ohospermissionmedia_location)
74
75- [ohos.permission.SHORT_TERM_WRITE_IMAGEVIDEO](restricted-permissions.md#ohospermissionshort_term_write_imagevideo)
76
77## Music and Audio
78
79- [ohos.permission.WRITE_AUDIO](restricted-permissions.md#ohospermissionwrite_audio)
80
81- [ohos.permission.READ_AUDIO](restricted-permissions.md#ohospermissionread_audio)
82
83<!--RP2-->
84## Ad Tracking
85
86- [ohos.permission.APP_TRACKING_CONSENT](permissions-for-all-user.md#ohospermissionapp_tracking_consent)
87<!--RP2End-->
88
89<!--Del-->
90## Installed Bundle List
91
92- [ohos.permission.GET_INSTALLED_BUNDLE_LIST](permissions-for-system-apps-user.md#ohospermissionget_installed_bundle_list)
93<!--DelEnd-->
94
95<!--RP3-->
96## Multi-device Collaboration
97
98- [ohos.permission.DISTRIBUTED_DATASYNC](permissions-for-all-user.md#ohospermissiondistributed_datasync)
99
100## Bluetooth
101
102- [ohos.permission.ACCESS_BLUETOOTH](permissions-for-all-user.md#ohospermissionaccess_bluetooth)
103
104## NearLink
105
106- [ohos.permission.ACCESS_NEARLINK](permissions-for-all-user.md#ohospermissionaccess_nearlink)
107<!--RP3End-->
108
109<!--Del-->
110## Phone
111
112- [ohos.permission.ANSWER_CALL](permissions-for-system-apps-user.md#ohospermissionanswer_call)
113
114- [ohos.permission.MANAGE_VOICEMAIL](permissions-for-system-apps-user.md#ohospermissionmanage_voicemail)
115
116## Call Logs
117
118- [ohos.permission.READ_CALL_LOG](permissions-for-system-apps-user.md#ohospermissionread_call_log)
119
120- [ohos.permission.WRITE_CALL_LOG](permissions-for-system-apps-user.md#ohospermissionwrite_call_log)
121
122## Messaging
123
124- [ohos.permission.READ_CELL_MESSAGES](permissions-for-system-apps-user.md#ohospermissionread_cell_messages)
125
126- [ohos.permission.READ_MESSAGES](permissions-for-system-apps-user.md#ohospermissionread_messages)
127
128- [ohos.permission.RECEIVE_MMS](permissions-for-system-apps-user.md#ohospermissionreceive_mms)
129
130- [ohos.permission.RECEIVE_SMS](permissions-for-system-apps-user.md#ohospermissionreceive_sms)
131
132- [ohos.permission.RECEIVE_WAP_MESSAGES](permissions-for-system-apps-user.md#ohospermissionreceive_wap_messages)
133
134- [ohos.permission.SEND_MESSAGES](permissions-for-system-apps-user.md#ohospermissionsend_messages)
135<!--DelEnd-->
136
137## Pasteboard
138
139- [ohos.permission.READ_PASTEBOARD](restricted-permissions.md#ohospermissionread_pasteboard)
140
141## Screenshots
142
143- [ohos.permission.CUSTOM_SCREEN_CAPTURE](permissions-for-all-user.md#ohospermissioncustom_screen_capture)
144
145## Directory
146
147> **NOTE**
148> <br>The permissions are available only to 2-in-1 device applications.
149
150- [ohos.permission.READ_WRITE_DOWNLOAD_DIRECTORY](permissions-for-all-user.md#ohospermissionread_write_download_directory)
151
152- [ohos.permission.READ_WRITE_DESKTOP_DIRECTORY](restricted-permissions.md#ohospermissionread_write_desktop_directory)
153- [ohos.permission.READ_WRITE_DOCUMENTS_DIRECTORY](permissions-for-all-user.md#ohospermissionread_write_documents_directory)
154
155## Files<sup>(deprecated)</sup>
156
157> **NOTE**
158> This permission group is deprecated since API version 12.
159
160<!--Del-->
161- ohos.permission.READ_DOCUMENT
162
163- ohos.permission.WRITE_DOCUMENT
164<!--DelEnd-->
165- ohos.permission.READ_MEDIA
166
167- ohos.permission.WRITE_MEDIA
168
169**Alternative solution**:
170
171- To read or write images or videos in the media library:
172
173  - (Recommended) Use [Picker](../../media/medialibrary/photoAccessHelper-photoviewpicker.md) to read images and videos in the media library, and use the [SaveButton/authorization pop-up window](../../media/medialibrary/photoAccessHelper-savebutton.md) to save images and videos in the media library. This solution is recommended because the application does not need any permission.
174  - Request the restricted permission [ohos.permission.READ_IMAGEVIDEO](restricted-permissions.md#ohospermissionread_imagevideo) or [ohos.permission.WRITE_IMAGEVIDEO](restricted-permissions.md#ohospermissionwrite_imagevideo).
175
176- To read audio clips in the media library:
177
178  Request the restricted permission [ohos.permission.READ_AUDIO](restricted-permissions.md#ohospermissionread_audio) or [ohos.permission.WRITE_AUDIO](restricted-permissions.md#ohospermissionwrite_audio).
179
180- To read documents in **Files**:
181
182  Use the file Picker to read documents in **Files**. For details, see [Selecting Documents](../../file-management/select-user-file.md#selecting-documents) and [Saving Documents](../../file-management/save-user-file.md#saving-documents).
183