Deprecated: Use the invocation framework APIs instead.
Synopsis:
#include <bps/navigator.h>
BPS_API int navigator_invoke(const char *url,
char **err)
Arguments:
- url
-
The URI to invoke.
- err
-
If this function fails, and if err is not null, it will be set to a short description of the error. The caller must free this buffer using bps_free().
Library:
libbps (For the qcc command, use the -l bps option to link against this library)
Description:
Deprecated:
The use of navigator_invoke() has been deprecated in BlackBerry 10. Use the invocation framework APIs from navigator_invoke.h instead.
The navigator_invoke() function sends a navigator invoke request to display the contents of the specified URI in the navigator.
When you specify an application URI, the URI also indicates the context that you want to open the application in. For example, to open the camera app, you can call navigator_invoke() with an argument of camera://
The following sections list the application URIs that you can use when you call navigator_invoke(). Note: Spaces or line breaks have been inserted in the URIs before the & in query strings for readability purposes and should not be passed into navigator_invoke().
BlackBerry World- appworld://myworld - Opens BlackBerry World storefront and loads the My World screen
- appworld://content/12345 - Opens BlackBerry World and loads the Application Details screen for the content with content ID 12345. This is the preferred format to invoke BlackBerry World content
- appworld://search/s=searchterm - Searches BlackBerry World and returns all items that match searchterm, organized by category
Browser- http://URL - Opens the browser and displays the content at the specified URL
- https://URL - Opens the browser and displays the content at the specified URL
Camera- camera:// - Opens the camera in the last mode used
Calendar- calendar:// - Opens the calendar
- calendar://showEvent?accountId=account_ID &eventId=event_ID - Opens the calendar and displays the event with the specified event ID
- calendar://editEvent?accountId=account_ID &eventId=event_ID - Opens the calendar and displays the edit screen for the event with the specified event ID
- calendar://newEvent?accountId=account_ID &dateStart=YYYY-MM-DD HH:MM:SS &dateEnd=YYYY-MM-DD HH:MM:SS &attd=comma_delimited_list_of_email_addresses &subj=subject &loc=location &body=body_of_message - Opens the calendar and displays the new event screen with the specified event properties (for example, start date, end date, and so on) pre-populated. All properties are optional and must be URL encoded
Maps- maps:// - Opens BlackBerry Maps and displays the current location
Music- music://albums - Opens the music application and displays the Albums screen
- music://artists - Opens the music application and displays the Artists screen
- music://file_URL - Opens the music application and plays the specified file
- music://genres - Opens the music application and displays the Genres screen
- music://playlists - Opens the music application and displays the Playlists screen
- music://songs - Opens the music application and displays the All Songs screen
Photos- photos:// - Opens the pictures application in the default view
Videos- videos://library - Opens the videos application and displays the Library tab
- videos://recorded - Opens the videos application and displays the Recorded Videos tab
- videos://file_URL - Opens the videos application and plays the specified file
Settings- settings://about - Displays the About screen
- settings://wifi - Displays the Wi-Fi screen
- settings://softwareupdate - Displays the Software Updates screen
- settings://bluetooth - Displays the Bluetooth screen
- settings://tethering - Displays the Internet Tethering screen
- settings://sound - Displays the Sounds screen
- settings://storage - Displays the Storage and Access screen
- settings://sharing - Displays the Media Sharing screen
- settings://security - Displays the Security screen
- settings://language - Displays the Language and Input screen
- settings://language/keyboard - Displays the Keyboard screen
- settings://datetime - Displays the Date and Time screen
- settings://pim - Displays the PIM Account screen
- settings://pim/listAccounts - Displays the PIM Account screen
- settings://pim/defaultAccounts - Displays the PIM Default Accounts screen
- settings://pim/createAccount - Displays the PIM New Account screen
- settings://pim/showAccount?id=account_ID - Displays the PIM Edit Account screen for the specified account ID (e.g., jim@email.com)
Returns:
BPS_SUCCESS upon success, BPS_FAILURE upon failure with a short description of the error in err.