Open user_grant Permissions
All the permissions in this topic are available to all applications and granted by the user.
This type of permissions must be declared in the application installation package and authorized by the user in a dialog box during the running of the application. The application has the permission only after the user has granted the permission.
NOTE "Enable via ACL" is not involved for permissions of the normal level.
Request Mode
The user_grant permissions are permissions granted by users. For details about how to request this type of permissions, see Declaring Permissions > Requesting User Authorization.
ohos.permission.ACCESS_BLUETOOTH
Allows an application to access Bluetooth and use Bluetooth capabilities, such as pairing and connecting to peripheral devices.
Permission level: normal
Authorization mode: user_grant
Valid since: 10
ohos.permission.MEDIA_LOCATION
Allows an application to access geographical locations in the user's media file.
Permission level: normal
Authorization mode: user_grant
Valid since: 7
ohos.permission.APP_TRACKING_CONSENT
Allows an application to read the open anonymous device identifier (OAID).
Permission level: normal
Authorization mode: user_grant
Valid since: 9
ohos.permission.ACTIVITY_MOTION
Allows an application to read the current workout status of the user, such as detecting whether the user is working out and recording the number of steps the user has taken.
Permission level: normal
Authorization mode: user_grant
Valid since: 7
ohos.permission.CAMERA
Allows an application to use the camera.
Permission level: normal
Authorization mode: user_grant
Valid since: 9
ohos.permission.DISTRIBUTED_DATASYNC
Allows the application data to be exchanged between devices.
Permission level: normal
Authorization mode: user_grant
Valid since: 7
ohos.permission.LOCATION_IN_BACKGROUND
Allows an application running in the background to obtain the device location.
For security purposes, this permission cannot be granted to applications in a dialog box. If an application needs this permission, direct the user to manually grant this permission on the Settings screen.
Procedure:
-
Declare permissions in the module.json5 file.
You must request the foreground location permission before requesting the background permission. Therefore, you must declare both the ohos.permission.LOCATION_IN_BACKGROUND permission and the foreground location permission. The foreground location permissions include the following:
-
Request the foreground location permission from the user through a pop-up window.
-
After the user grants the foreground location permissions, display a message to direct the user to go to the Settings screen to grant the ohos.permission.LOCATION_IN_BACKGROUND permission.
-
The permission is granted to the application if the user selects Always allow on the Settings screen.
Paths:
- Path 1: Settings > Privacy > Permission manager > Permissions > Location > Target application
- Path 2: Settings > Privacy > Permission manager > Apps > Target application > Location
Permission level: normal
Authorization mode: user_grant
Valid since: 7
ohos.permission.LOCATION
Allows an application to obtain the device location.
Prerequisites: This permission must be requested with ohos.permission.APPROXIMATELY_LOCATION together.
Permission level: normal
Authorization mode: user_grant
Valid since: 7
ohos.permission.APPROXIMATELY_LOCATION
Allows an application to obtain the approximate location information of a device.
Permission level: normal
Authorization mode: user_grant
Valid since: 9
ohos.permission.MICROPHONE
Allows an application to access the microphone.
Permission level: normal
Authorization mode: user_grant
Valid since: 8
ohos.permission.READ_CALENDAR
Allows an application to read Calendar data.
Permission level: normal
Authorization mode: user_grant
Valid since: 8
ohos.permission.WRITE_CALENDAR
Allows an application to add, remove, and modify Calendar events.
Permission level: normal
Authorization mode: user_grant
Valid since: 8
ohos.permission.READ_HEALTH_DATA
Allows an application to read the health data of the user.
Permission level: normal
Authorization mode: user_grant
Valid since: 7
ohos.permission.ACCESS_NEARLINK
Allows an application to use NearLink, such as device pairing and connecting to nearby devices.
Permission level: normal
Authorization mode: user_grant
Valid since: 12
ohos.permission.READ_WRITE_DOWNLOAD_DIRECTORY
Allows an application to access the Download directory and its subdirectories in the user directory.
Currently, this permission is available only to 2-in-1 device applications.
Permission level: system_basic for API version 11; normal for API version 12 and later
Authorization mode: user_grant
Valid since: 11
ohos.permission.READ_WRITE_DOCUMENTS_DIRECTORY
Allows an application to access the Documents directory and its subdirectories in the user directory.
Currently, this permission is available only to 2-in-1 device applications.
Permission level: system_basic for API version 11; normal for API version 12 and later
Authorization mode: user_grant
Valid since: 11
ohos.permission.READ_MEDIA
Allows an application to read media files from the user's external storage.
Permission level: normal
Authorization mode: user_grant
Valid since: 7
Deprecated from: 12
Substitute:
See the alternative solution of the Files permission group.
ohos.permission.WRITE_MEDIA
Allows an application to read media files from and write media files into the user's external storage.
Permission level: normal
Authorization mode: user_grant
Valid since: 7
Deprecated from: 12
Substitute: