Genero Mobile common front calls

This section describes common front calls provided by all mobile front-ends.

This table shows the functions implemented by all mobile front-ends in the "mobile" module.

Table 1. Common mobile platform front-end functions
Function Name Description
ui.Interface.frontCall("mobile", "chooseContact",
   [], [result])
Lets the user choose a contact from the mobile device contact list and returns the vCard.
ui.Interface.frontCall("mobile", "choosePhoto",
   [], [path])
Lets the user select a picture from the mobile device's photo gallery and returns a picture identifier.
ui.Interface.frontCall("mobile", "chooseVideo",
  [], [path])
Lets the user select a video from the mobile device's video gallery and returns a video identifier.
ui.Interface.frontCall("mobile", "composeMail",
   [to, subject, content, cc, bcc, attachments ...],
   [result])
Invokes the user's default mail application for a new mail to send.
ui.Interface.frontCall("mobile", "composeSMS",
  [ recipients, content ],
  [ result ] )
Sends an SMS text to one or more phone numbers.
ui.Interface.frontCall("mobile", "connectivity",
   [], [result] )
Returns the type of network available for the mobile device.
ui.Interface.frontCall("mobile", "getGeolocation",
   [], [status, latitude, longitude] )
Returns the Global Positioning System (GPS) location of a mobile device.
ui.Interface.frontCall("mobile","getRemoteNotifications",
   [], [data] )
This front call retrieves push notification messages.
ui.Interface.frontCall("mobile", "importContact",
   [vcard], [result] )
Creates a new contact, or merges to an existing entry, the contact details passed in a vCard string.
ui.Interface.frontCall("mobile", "isForeground",
   [],  [result] )
Indicates if the mobile app is in foreground mode.
ui.Interface.frontCall("mobile", "newContact",
  [defaults],[vcard])
Opens contact input form to create a new entry in the contact database.
ui.Interface.frontCall("mobile","registerForRemoteNotifications",
   [], [registration-token] )
This front call registers a mobile device for push notifications.
ui.Interface.frontCall("mobile", "runOnServer",
   [ appurl, timeout ], [] )
Run an application from the Genero Application Server using the specified URL.
ui.Interface.frontCall("mobile", "scanBarCode",
   [], [code, type] )
Allow the user to scan a barcode with a mobile device
ui.Interface.frontCall("mobile", "takePhoto",
   [], [path] )
Lets the user take a picture with the mobile device and returns the corresponding picture identifier.
ui.Interface.frontCall("mobile", "takeVideo",
  [], [path])
Lets the user take a video with the mobile device and returns the corresponding video identifier.
ui.Interface.frontCall("mobile","unregisterFromRemoteNotifications",
   [], [] )
This front call unregisters the mobile device from push notifications.