<permission>

(Optional) The privileges (also known as capabilities, user actions, or actions) the application requests from the OS

Parent elements:

<qnx>, <configuration>

Child elements:

None.

Description:

The <permission> element specifies the privileges (also known as capabilities, user actions, or actions) the application requests from the OS.

Content:

A PCDATA value representing the permissions granted to your application. The following identifiers specify the user permissions that can be granted to an application:

Permission for functionality Permission element value Permission description
Automatic Input Control _sys_inject_events Allows the app to simulate touchscreen gestures and keys being pressed on a keyboard.
BlackBerry Messenger bbm_connect Allows the app to connect to BlackBerry Messenger (BBM). This permission also allows the app to view contact lists and user profiles, invite BBM contacts to download the app, initiate BBM chats and share content from within the app, and stream data between apps in real time.
Calendar access_pimdomain_calendars Allows the app to access the calendar on the device. This permission includes viewing, adding, and deleting calendar appointments.
Camera use_camera Allows the app to access any of the data coming from cameras on the device. This permission allows an app to take pictures, record video, and use the flash on the device.
Contacts access_pimdomain_contacts Allows the app to access to the contacts stored on the device. This permission includes viewing, creating, and deleting contacts on the device and SIM card.
Control Notification Settings access_notifiy_settings_control Allows the app to modify global notification settings. Apps only have permission to read their own notification settings.
Device Identifying Information read_device_identifying_information Allows the app to access unique device identifiers such as the PIN and serial number. This permission also allows you to access SIM card information on the device.
Email and PIN Messages access_pimdomain_messages Allows the app to access the email and PIN messages stored on the device. This access includes viewing, creating, sending, and deleting messages.
Gamepad use_gamepad

Indicates that the app supports gamepad functionality. This permission also indicates that your app has official gamepad support in the BlackBerry World storefront.

GPS Location (Deprecated) read_geolocation Deprecated. Instead, use the Location (access_location_services) permission. This permission previously allowed access to the current GPS location of the device.
Internet access_internet Allows the app to use an internet connection from a Wi-Fi, wired, or other connection. This permissions is required to access a destination that is not local on the user's device.
Location access_location_services Allows the app to access the device's current location and access locations saved on the device. This permission includes access to geolocation, geofencing, cell tower information, Wi-Fi data, and Cascades Places.
Microphone record_audio Allows the app to access the audio stream from the microphone on the device.
Narrow Swipe Up narrow_landscape_exit Allows the app, within a landscape orientation (typically games), to use the corner regions for menus and virtual game pads. This permission reduces the region of the home swipe up gesture to occur only in the middle edge of the bottom of the bezel instead of a full-length swipe. Use this permission to prevent the app from inadvertently going into the background when the corner regions are swiped.
Notebooks access_pimdomain_notebooks Allows the app to access the content stored in the notebooks on the device. This permission includes adding and deleting entries and content from notebooks.
Phone access_phone Allows the app to determine when a user is on a phone call. This access also allows an app to access the phone number assigned to the device and send DTMF (Dual Tone Multi-Frequency) tones.
Phone Control control_phone Allows the app to combine two calls together, end a call, and use the dial pad during a call.
Post Notifications post_notification Allows the app to post notifications. This permission does not require the user grant your app access and is granted by the OS when requested.
Push _sys_use_consumer_push Allows the app to use BlackBerry Push Service with BlackBerry Internet Service. This permission allows an app to receive and request push messages. To use the Push Service with the BlackBerry Internet Service, you must register with BlackBerry. When you register, you receive a confirmation email message that contains information that the application needs to receive and request push messages. For more information about registering, see Push Service.

It is important to be aware that if you're using the Push Service with the BlackBerry Enterprise Server or the BlackBerry Device Service, you don't need to register with BlackBerry, and you must not add the Push permission for your app.

Run as Active Frame run_when_backgrounded Allows the app to perform background processing. Without this permission, the app will be stopped when the user switches focus to another app. Use this permission sparingly and only when your app must perform processing in the background.

This permission is useful for apps that play music or manage downloads. Apps that use this permission are rigorously reviewed for acceptance to the BlackBerry World storefront for their use of battery power on a device.

Run in Background _sys_run_headless Allows the app to perform certain tasks in the background without opening the app. Due to the potential for misuse of the functionality associated with this permission, apps that use this permission are rigorously reviewed for acceptance to BlackBerry World storefront.
Screen Capture use_camera_desktop Allows the app to take screen shots or videos of the user's screen. This permission also allows the app to share the user's screen.
Shared Files access_shared Allows the app to read and write the files that are shared between all apps on the device. This permission allows the app to access pictures, music, documents and other files that are stored on the user's device, at a remote storage provider, on a media card, or in the cloud.
Text Messages access_sms_mms Allows the app to access the text messages stored on the device. This access includes viewing, creating, sending, and deleting text messages.
User Contact Information read_personally_identifiable_information Allows the app to access user information on the device, such as the first name, last name, and BlackBerry ID username of the user currently associated with this device.

Attributes:

Name Description Values Default
system (Optional) Specifies the action is a system action and not a user action. The default value is false. Examples of system actions you can use are run_native (run the app using OS runtime) run_air_native (run the app using Adobe AIR runtime).

These actions are added implicitly to the BAR file manifest by the packager when it detects an application type that requires them.

true, false false

Example:

<qnx>
...
...
   <permission system="true">run_native</permission>
   <permission system="false">access_shared</permission>
   <permission system="false">record_audio</permission>
...
</qnx>
          
comments powered by Disqus