net.rim.device.api.content
Class BlackBerryContentHandler

java.lang.Object
  extended by net.rim.device.api.content.BlackBerryContentHandler

public class BlackBerryContentHandler
extends Object

Provides Content Handler API (JSR 211) IDs which can be used for invoking RIM content handlers.

As defined by JSR 211, a content handler ID is a unique identifier for a content handler. These IDs can be used with the Invocation class to invoke a specific content handler, or with the Registry class to retrieve a specific ContentHandler class.

For more information and other uses for content handler IDs, please refer to the JSR 211 specification.

See Also:
JSR 211
Since:
BlackBerry API 4.3.0

Field Summary
static String ID_MEDIA_CONTENT_HANDLER
          ID for the Media content handler.
static String ID_SEND_AS_EMAIL_CONTENT_HANDLER
          ID for the 'Send As Email' content handler.
static String ID_SEND_AS_MMS_CONTENT_HANDLER
          ID for the 'Send As MMS' content handler.
static String ID_SEND_USING_BLUETOOTH_CONTENT_HANDLER
          ID for the 'Send Using Bluetooth' content handler.
static String MEDIA_ARGUMENT_CLOSE_AT_END_OF_MEDIA
          Argument that can be used to request Media Player to auto close at the end of Media.
static String MEDIA_ARGUMENT_VIEW_MEDIA
          Argument for Invocation objects intended for use with the Media content handler.
static String MEDIA_ARGUMENT_VIEW_MUSIC
          Argument for Invocation objects intended for use with the Media content handler.
static String MEDIA_ARGUMENT_VIEW_PICTURES
          Argument for Invocation objects intended for use with the Media content handler.
static String MEDIA_ARGUMENT_VIEW_PLAYLISTS
          Argument for Invocation objects intended for use with the Media content handler.
static String MEDIA_ARGUMENT_VIEW_PODCASTS
          Argument for Invocation objects intended for use with the Media content handler.
static String MEDIA_ARGUMENT_VIEW_PODCAST_TRACKS
          Argument for Invocation objects intended for use with the Media content handler.
static String MEDIA_ARGUMENT_VIEW_RINGTONES
          Argument for Invocation objects intended for use with the Media content handler.
static String MEDIA_ARGUMENT_VIEW_RINGTONE_TRACKS
          Argument for Invocation objects intended for use with the Media content handler.
static String MEDIA_ARGUMENT_VIEW_VIDEOS
          Argument for Invocation objects intended for use with the Media content handler.
static String MEDIA_ARGUMENT_VIEW_VOICENOTES
          Argument for Invocation objects intended for use with the Media content handler.
 
Method Summary
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 



Field Detail

ID_MEDIA_CONTENT_HANDLER

public static final String ID_MEDIA_CONTENT_HANDLER

ID for the Media content handler.

The Media content handler can be invoked to open media files which are supported by the handheld.

If you create an Invocation object and specify this ID and no other parameters, calling Registry.invoke() with that Invocation will start the Media application.

If this ID and if one of the MEDIA_ARGUMENT_VIEW_* constants is used in the arguments array of the Invocation, the Media application will be opened in the view specified.

If you specify a URL for that Invocation then the Media content handler will attempt to open the file specified by the URL.

See Also:
Constant Field Values
Since:
BlackBerry API 4.3.0

ID_SEND_AS_EMAIL_CONTENT_HANDLER

public static final String ID_SEND_AS_EMAIL_CONTENT_HANDLER
ID for the 'Send As Email' content handler.

This content handler can be invoked to make use of the 'Send As Email' functionality for local content such as audio, video, images, etc. as is found in the menu of the BlackBerry file explorer application.

If an Invocation object is created with this ID specified, the URI of the local content should be specified by calling Invocation.setURL(String).

Then calling Registry.invoke() will result in the Email compose screen being displayed with the specified content included as a file attachment.

See Also:
Constant Field Values
Since:
BlackBerry API 5.0.0

ID_SEND_AS_MMS_CONTENT_HANDLER

public static final String ID_SEND_AS_MMS_CONTENT_HANDLER
ID for the 'Send As MMS' content handler.

This content handler can be invoked to make use of the 'Send As MMS' functionality for local content such as audio, video, images, etc. as is found in the menu of the BlackBerry file explorer application.

If an Invocation object is created with this ID specified, the URI of the local content should be specified by calling Invocation.setURL(String).

Then calling Registry.invoke() will result in the MMS compose screen being displayed with the specified content included as a file attachment.

See Also:
Constant Field Values
Since:
BlackBerry API 5.0.0

ID_SEND_USING_BLUETOOTH_CONTENT_HANDLER

public static final String ID_SEND_USING_BLUETOOTH_CONTENT_HANDLER
ID for the 'Send Using Bluetooth' content handler.

This content handler is only available on devices that support Bluetooth.

This content handler can be invoked to make use of the 'Send Using Bluetooth' functionality for local content such as audio, video, images, etc. as is found in the menu of the BlackBerry file explorer application.

If an Invocation object is created with this ID specified, the URI of the local content should be specified by calling Invocation.setURL(String).

Then calling Registry.invoke() will result in the Send Using Bluetooth screens displayed to guide the user through the steps of sending the specified content via bluetooth.

See Also:
Constant Field Values
Since:
BlackBerry API 5.0.0

MEDIA_ARGUMENT_VIEW_MUSIC

public static final String MEDIA_ARGUMENT_VIEW_MUSIC
Argument for Invocation objects intended for use with the Media content handler.

Specifying this argument as one of the Strings in the arguments array passed to Invocation.setArgs() will result in the Media application being opened to view the music library when the Media content handler is invoked.

See Also:
Constant Field Values
Since:
BlackBerry API 4.7.0

MEDIA_ARGUMENT_VIEW_VIDEOS

public static final String MEDIA_ARGUMENT_VIEW_VIDEOS
Argument for Invocation objects intended for use with the Media content handler.

Specifying this argument as one of the Strings in the arguments array passed to Invocation.setArgs() will result in the Media application being opened to view the video library when the Media content handler is invoked.

See Also:
Constant Field Values
Since:
BlackBerry API 4.7.0

MEDIA_ARGUMENT_VIEW_RINGTONES

public static final String MEDIA_ARGUMENT_VIEW_RINGTONES
Argument for Invocation objects intended for use with the Media content handler.

Specifying this argument as one of the Strings in the arguments array passed to Invocation.setArgs() will result in the Media application being opened to view the list of ringtones when the Media content handler is invoked.

See Also:
Constant Field Values
Since:
BlackBerry API 4.7.0

MEDIA_ARGUMENT_VIEW_RINGTONE_TRACKS

public static final String MEDIA_ARGUMENT_VIEW_RINGTONE_TRACKS
Argument for Invocation objects intended for use with the Media content handler.

Specifying this argument as one of the Strings in the arguments array passed to Invocation.setArgs() will result in the Media application being opened to view the list of ringtone tracks when the Media content handler is invoked.

See Also:
Constant Field Values
Since:
BlackBerry API 6.0.0

MEDIA_ARGUMENT_VIEW_PODCASTS

public static final String MEDIA_ARGUMENT_VIEW_PODCASTS
Argument for Invocation objects intended for use with the Media content handler.

Specifying this argument as one of the Strings in the arguments array passed to Invocation.setArgs() will result in the Media application being opened to view the list of podcasts when the Media content handler is invoked.

See Also:
Constant Field Values
Since:
BlackBerry API 6.0.0

MEDIA_ARGUMENT_VIEW_PODCAST_TRACKS

public static final String MEDIA_ARGUMENT_VIEW_PODCAST_TRACKS
Argument for Invocation objects intended for use with the Media content handler.

Specifying this argument as one of the Strings in the arguments array passed to Invocation.setArgs() will result in the Media application being opened to view the list of podcast tracks when the Media content handler is invoked.

See Also:
Constant Field Values
Since:
BlackBerry API 6.0.0

MEDIA_ARGUMENT_VIEW_PICTURES

public static final String MEDIA_ARGUMENT_VIEW_PICTURES
Argument for Invocation objects intended for use with the Media content handler.

Specifying this argument as one of the Strings in the arguments array passed to Invocation.setArgs() will result in the Media application being opened to view the photo library when the Media content handler is invoked.

See Also:
Constant Field Values
Since:
BlackBerry API 4.7.0

MEDIA_ARGUMENT_VIEW_MEDIA

public static final String MEDIA_ARGUMENT_VIEW_MEDIA
Argument for Invocation objects intended for use with the Media content handler.

Specifying this argument as one of the Strings in the arguments array passed to Invocation.setArgs() will result in the Media application being opened to view the default media hub when the Media content handler is invoked.

See Also:
Constant Field Values
Since:
BlackBerry API 4.7.0

MEDIA_ARGUMENT_VIEW_VOICENOTES

public static final String MEDIA_ARGUMENT_VIEW_VOICENOTES
Argument for Invocation objects intended for use with the Media content handler.

Specifying this argument as one of the Strings in the arguments array passed to Invocation.setArgs() will result in the Media application being opened to view voice notes when the Media content handler is invoked.

See Also:
Constant Field Values
Since:
BlackBerry API 4.7.0

MEDIA_ARGUMENT_VIEW_PLAYLISTS

public static final String MEDIA_ARGUMENT_VIEW_PLAYLISTS
Argument for Invocation objects intended for use with the Media content handler.

Specifying this argument as one of the Strings in the arguments array passed to Invocation.setArgs() will result in the Media application being opened to view all playlists when the Media content handler is invoked.

See Also:
Constant Field Values
Since:
BlackBerry API 4.7.0

MEDIA_ARGUMENT_CLOSE_AT_END_OF_MEDIA

public static final String MEDIA_ARGUMENT_CLOSE_AT_END_OF_MEDIA
Argument that can be used to request Media Player to auto close at the end of Media. If not supplied, the default is to leave Media Player open.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0





Copyright 1999-2011 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Java is a trademark of Oracle America Inc. in the US and other countries.
Legal