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:

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 ) );
  }
}

...