# People Picker

For security reasons, a given app doesn't have permission to read contact records that weren't created by the app itself.

However, with the user's permission, your app may read contact data one record at a time using the People Picker, a cross-application API provided by the webOS Contacts app.

To let the user select a contact to act on, your app pushes the Contacts app's People Picker scene to the foreground. When the user taps a particular contact, the People Picker scene is popped and control is returned to the calling scene. When this happens, the `activate()` method of the calling scene is invoked, with the selected Person object passed as the sole parameter.

See also:

- Person schema

## Example

>     ...

>     MySceneAssistant.prototype.launchPeoplePicker = function() {
>       // We might call this method in response to a button tap.
>       this.controller.stageController.pushScene(
>           {
>               appId: "com.palm.app.contacts",
>               name: "list"
>           },
>           {
>               mode: "picker",
>               message: "Pick a person, any person..."
>           }
>       );
>     }

>     MySceneAssistant.prototype.activate: function( person ) {
>       if ( person ) {
>           // We have a param in the scene's activate() method, so we must be
>           // returning from People Picker.

>           // Here, we just log the object returned.
>           // In real life, you'll want to read specific info from the Person
>           // object returned.
>           // See the Contacts schema for details
>           console.log( JSON.stringify( person ) );
>       }
>     }

>     ...