rim:permit element

Syntax

<rim:permissions>
    <rim:permit>permission string</rim:permit>
</rim:permissions>

Description

The <rim:permit> element specifies permission access to various features in a BlackBerry WebWorks app (for example, accessing the GPS location or the camera).

Parent elements

<rim:permissions>

Child elements

None

Occurrences

One or more

Permissions

You can specify access to the following features:

Feature Permission
Camera

use_camera

Allows this app to take pictures, record video, and use the camera's flash.

Device information

read_device_identifying_information

Allows this app to access device identifiers such as serial number and PIN.

GPS location

read_geolocation

Allows this app to access the GPS location of the device.

Microphone

record_audio

Allows this app to record sound using the microphone.

Shared files

access_shared

Allows this app to access pictures, music, documents, and other files stored on the device, at a remote storage provider, on a media card, or in the cloud.

Example: Specifying permissions

The following example demonstrates how to set the permissions for reading and writing files, recording audio, accessing camera data, and push.

<rim:permissions>
    <rim:permit>access_shared</rim:permit>
    <rim:permit>record_audio</rim:permit>
    <rim:permit>use_camera</rim:permit>
</rim:permissions>

Last modified: 2013-08-29