Blackbe;rry JAVA DEVELOPMENT ENVIRONMENT - - MULTIMEDIA

BlackBerry Java Development

Environment

Multimedia Development Guide

BlackBerry Java Development Environment Multimedia Development Guide

Last modified: 14 July 2008

Part number: 13697641

At the time of publication, this documentation is based on the BlackBerry Java Development Environment version 4.3.1.

Send us your comments on product documentation: https://www.blackberry.com/DocsFeedback.

exclusive properties of Research In Motion Limited. RIM, Research In Motion, BlackBerry, “Always On, Always Connected” and the “envelope in

motion” symbol are registered with the U.S. Patent and Trademark Office and may be pending or registered in other countries.

Bluetooth is a trademark of Bluetooth SIG. Java is a trademarks of Sun Microsystems, Inc. Plazmic is a trademark of Plazmic Inc. All other

brands, product names, company names, trademarks and service marks are the properties of their respective owners.All other brands, product

names, company names, trademarks and service marks are the properties of their respective owners.

The BlackBerry smartphone and other devices and/or associated software are protected by copyright, international treaties, and various

patents, including one or more of the following U.S. patents: 6,278,442; 6,271,605; 6,219,694; 6,075,470; 6,073,318; D445,428; D433,460;

D416,256. Other patents are registered or pending in the U.S. and in various countries around the world. Visit www.rim.com/patents for a list

of RIM (as hereinafter defined) patents.

This documentation including all documentation incorporated by reference herein such as documentation provided or made available at

www.blackberry.com/go/docs is provided or made accessible "AS IS" and "AS AVAILABLE" and without condition, endorsement, guarantee,

representation, or warranty of any kind by Research In Motion Limited and its affiliated companies ("RIM") and RIM assumes no responsibility

for any typographical, technical, or other inaccuracies, errors, or omissions in this documentation. In order to protect RIM proprietary and

confidential information and/or trade secrets, this documentation may describe some aspects of RIM technology in generalized terms. RIM

reserves the right to periodically change information that is contained in this documentation; however, RIM makes no commitment to provide

any such changes, updates, enhancements, or other additions to this documentation to you in a timely manner or at all.

This documentation might contain references to third-party sources of information, hardware or software, products or services including

components and content such as content protected by copyright and/or third-party web sites (collectively the "Third Party Products and

Services"). RIM does not control, and is not responsible for, any Third Party Products and Services including, without limitation the content,

accuracy, copyright compliance, compatibility, performance, trustworthiness, legality, decency, links, or any other aspect of Third Party

Products and Services. The inclusion of a reference to Third Party Products and Services in this documentation does not imply endorsement by

RIM of the Third Party Products and Services or the third party in any way.

EXCEPT TO THE EXTENT SPECIFICALLY PROHIBITED BY APPLICABLE LAW IN YOUR JURISDICTION, ALL CONDITIONS, ENDORSEMENTS,

GUARANTEES, REPRESENTATIONS, OR WARRANTIES OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY

CONDITIONS, ENDORSEMENTS, GUARANTEES, REPRESENTATIONS OR WARRANTIES OF DURABILITY, FITNESS FOR A PARTICULAR

PURPOSE OR USE, MERCHANTABILITY, MERCHANTABLE QUALITY, NON-INFRINGEMENT, SATISFACTORY QUALITY, OR TITLE, OR

ARISING FROM A STATUTE OR CUSTOM OR A COURSE OF DEALING OR USAGE OF TRADE, OR RELATED TO THE DOCUMENTATION OR

ITS USE, OR PERFORMANCE OR NON-PERFORMANCE OF ANY SOFTWARE, HARDWARE, SERVICE, OR ANY THIRD PARTY PRODUCTS AND

SERVICES REFERENCED HEREIN, ARE HEREBY EXCLUDED. YOU MAY ALSO HAVE OTHER RIGHTS THAT VARY BY STATE OR PROVINCE.

SOME JURISDICTIONS MAY NOT ALLOW THE EXCLUSION OR LIMITATION OF IMPLIED WARRANTIES AND CONDITIONS. TO THE EXTENT

PERMITTED BY LAW, ANY IMPLIED WARRANTIES OR CONDITIONS RELATING TO THE DOCUMENTATION TO THE EXTENT THEY CANNOT

BE EXCLUDED AS SET OUT ABOVE, BUT CAN BE LIMITED, ARE HEREBY LIMITED TO NINETY (90) DAYS FROM THE DATE YOU FIRST

ACQUIRED THE DOCUMENTATION OR THE ITEM THAT IS THE SUBJECT OF THE CLAIM.

TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW IN YOUR JURISDICTION, IN NO EVENT SHALL RIM BE LIABLE FOR ANY TYPE

OF DAMAGES RELATED TO THIS DOCUMENTATION OR ITS USE, OR PERFORMANCE OR NON-PERFORMANCE OF ANY SOFTWARE,

HARDWARE, SERVICE, OR ANY THIRD PARTY PRODUCTS AND SERVICES REFERENCED HEREIN INCLUDING WITHOUT LIMITATION ANY

OF THE FOLLOWING DAMAGES: DIRECT, CONSEQUENTIAL, EXEMPLARY, INCIDENTAL, INDIRECT, SPECIAL, PUNITIVE, OR AGGRAVATED

DAMAGES, DAMAGES FOR LOSS OF PROFITS OR REVENUES, FAILURE TO REALIZE ANY EXPECTED SAVINGS, BUSINESS INTERRUPTION,

LOSS OF BUSINESS INFORMATION, LOSS OF BUSINESS OPPORTUNITY, OR CORRUPTION OR LOSS OF DATA, FAILURES TO TRANSMIT

OR RECEIVE ANY DATA, PROBLEMS ASSOCIATED WITH ANY APPLICATIONS USED IN CONJUNCTION WITH RIM PRODUCTS OR

SERVICES, DOWNTIME COSTS, LOSS OF THE USE OF RIM PRODUCTS OR SERVICES OR ANY PORTION THEREOF OR OF ANY AIRTIME

SERVICES, COST OF SUBSTITUTE GOODS, COSTS OF COVER, FACILITIES OR SERVICES, COST OF CAPITAL, OR OTHER SIMILAR

PECUNIARY LOSSES, WHETHER OR NOT SUCH DAMAGES WERE FORESEEN OR UNFORESEEN, AND EVEN IF RIM HAS BEEN ADVISED OF

THE POSSIBILITY OF SUCH DAMAGES.

TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW IN YOUR JURISDICTION, RIM SHALL HAVE NO OTHER OBLIGATION, DUTY,

OR LIABILITY WHATSOEVER IN CONTRACT, TORT, OR OTHERWISE TO YOU INCLUDING ANY LIABILITY FOR NEGLIGENCE OR STRICT

LIABILITY.

THE LIMITATIONS, EXCLUSIONS, AND DISCLAIMERS HEREIN SHALL APPLY: (A) IRRESPECTIVE OF THE NATURE OF THE CAUSE OF

ACTION, DEMAND, OR ACTION BY YOU INCLUDING BUT NOT LIMITED TO BREACH OF CONTRACT, NEGLIGENCE, TORT, STRICT LIABILITY

OR ANY OTHER LEGAL THEORY AND SHALL SURVIVE A FUNDAMENTAL BREACH OR BREACHES OR THE FAILURE OF THE ESSENTIAL

PURPOSE OF THIS AGREEMENT OR OF ANY REMEDY CONTAINED HEREIN; AND (B) TO RIM AND ITS AFFILIATED COMPANIES, THEIR

SUCCESSORS, ASSIGNS, AGENTS, SUPPLIERS (INCLUDING AIRTIME SERVICE PROVIDERS), AUTHORIZED RIM DISTRIBUTORS (ALSO

INCLUDING AIRTIME SERVICE PROVIDERS) AND THEIR RESPECTIVE DIRECTORS, EMPLOYEES, AND INDEPENDENT CONTRACTORS.

IN ADDITION TO THE LIMITATIONS AND EXCLUSIONS SET OUT ABOVE, IN NO EVENT SHALL ANY DIRECTOR, EMPLOYEE, AGENT,

DISTRIBUTOR, SUPPLIER, INDEPENDENT CONTRACTOR OF RIM OR ANY AFFILIATES OF RIM HAVE ANY LIABILITY ARISING FROM OR

RELATED TO THE DOCUMENTATION.

Prior to subscribing for, installing, or using any Third Party Products and Services, it is your responsibility to ensure that your airtime service

provider has agreed to support all of their features. Installation or use of Third Party Products and Services with RIM's products and services

may require one or more patent, trademark, copyright, or other licenses in order to avoid infringement or violation of third party rights. You are

solely responsible for determining whether to use Third Party Products and Services and if any third party licenses are required to do so. If

required you are responsible for acquiring them. You should not install or use Third Party Products and Services until all necessary licenses

have been acquired. Any Third Party Products and Services that are provided with RIM's products and services are provided as a convenience

to you and are provided "AS IS" with no express or implied conditions, endorsements, guarantees, representations, or warranties of any kind by

RIM and RIM assumes no liability whatsoever, in relation thereto. Your use of Third Party Products and Services shall be governed by and

subject to you agreeing to the terms of separate licenses and other agreements applicable thereto with third parties, except to the extent

expressly covered by a license or other agreement with RIM.

The terms of use of any RIM product or service are set out in a separate license or other agreement with RIM applicable thereto. NOTHING IN

THIS DOCUMENTATION IS INTENDED TO SUPERSEDE ANY EXPRESS WRITTEN AGREEMENTS OR WARRANTIES PROVIDED BY RIM FOR

PORTIONS OF ANY RIM PRODUCT OR SERVICE OTHER THAN THIS DOCUMENTATION.

Published in Canada

Research In Motion Limited

295 Phillip Street

Waterloo, ON N2L 3W8

Canada

Research In Motion UK Limited

200 Bath Road

Slough, Berkshire SL1 3XE

United Kingdom

Contents

1Working with multimedia in a BlackBerry Application.................................................................................. 7

BlackBerry Applications and multimedia.......................................................................................................7

2Using audio and video in a BlackBerry Application.......................................................................................9

Accessing stored media ................................................................................................................................... 9

Access media on a BlackBerry smartphone........................................................................................... 9

Access media on a microSD card ............................................................................................................9

Playing media in the BlackBerry Browser ..................................................................................................... 9

Play audio in the BlackBerry Browser .................................................................................................... 9

Play a video in the BlackBerry Browser.................................................................................................10

Playing media in the media application.......................................................................................................10

Start the media application with or without content..........................................................................10

Streaming data from a remote source to the media application .......................................................11

Creating a BlackBerry Application that plays media files.........................................................................15

Change the state of a Player .................................................................................................................. 17

Play media in a BlackBerry Application ................................................................................................17

Receive and send media application events ........................................................................................19

Create different kinds of players...........................................................................................................20

Record audio on a BlackBerry smartphone................................................................................................. 24

Send audio to a Bluetooth enabled headset...............................................................................................26

3Using SVG content in a BlackBerry Application...........................................................................................29

Using SVG content .........................................................................................................................................29

Download SVG content..................................................................................................................................29

Display SVG content from the Plazmic Media Engine version 4.2 ..................................................29

Play SVG content.....................................................................................................................................30

Listen for events related to SVG content..............................................................................................31

Code sample: Manage events when an application downloads SVG content............................... 32

Create a custom connection to SVG content...................................................................................... 33

4Working with images from the camera...........................................................................................................35

Creating an image with the camera............................................................................................................. 35

Start the camera from a BlackBerry Application................................................................................35

Receive notification of file system events................................................................................................... 35

Detect when an image is added or removed in the file system........................................................35

Retrieving an image from the file system ................................................................................................... 37

Retrieve an image from memory on a BlackBerry device.................................................................. 37

Retrieve an image from a microSD card .............................................................................................. 37

Moving an image in the file system ............................................................................................................. 37

Move an image within the same directory of the file system ........................................................... 37

Move an image to a different directory of the file system ................................................................ 37

Deleting an image from the file system ...................................................................................................... 38

Delete an image from memory on a BlackBerry device.....................................................................38

Delete an image from a microSD card .................................................................................................39

5Working with images ..........................................................................................................................................41

Drawing and positioning images...................................................................................................................41

Using images...................................................................................................................................................43

Use unprocessed images........................................................................................................................43

Use encoded images...............................................................................................................................43

6Code samples ......................................................................................................................................................45

Code sample: Retrieving and displaying SVG content .............................................................................45

Code sample: Implementing a listener to download SVG content .........................................................46

Code sample: Implementing a custom connection to SVG content .......................................................48

Code sample: Using an unprocessed image to recreate an encoded image.........................................50

Code sample: Drawing a new bitmap using an existing bitmap ..............................................................51

Working with multimedia in a BlackBerry

Application

BlackBerry Applications and multimedia

You can create a BlackBerry® Application that plays media in the BlackBerry® Browser, or plays media in the

media application on the BlackBerry smartphone. You can also create a BlackBerry Application that is a media

application. You can create a BlackBerry Application that is a media application and plays binary SVG content. You

can create an application that records audio or sends audio to a Bluetooth® enabled headset.

For more information about media types that the BlackBerry smartphone supports, visit www.blackberry.com/

btsc/support to read knowledge base article KB05482.

BlackBerry Applications and multimedia

BlackBerry Java Development Environment Multimedia Development Guide

Using audio and video in a BlackBerry

Application

Accessing stored media

You can create a BlackBerry® Application that uses the Connector class and FileConnection interface to access

media stored on the BlackBerry smartphone or a microSD card.

Access media on a BlackBerry smartphone

>InvokeConnector.open(). Pass the following parameters: the file protocol and the location of the media file

on the BlackBerry® smartphone.

FileConnection fconn = (FileConnection)Connector.open("file:///store/home/user/audio/

newfile.mp3");

Access media on a microSD card

>InvokeConnector.open(). Pass the following parameters: the file protocol and the location of the media file

on the microSD card.

FileConnection fconn = (FileConnection)Connector.open("file:///SDCard/music/newfile.mp3");

Playing media in the BlackBerry Browser

A BlackBerry® Application can use the methods of the Browser class and BrowserSession class to play media in

the BlackBerry® Browser.

Play audio in the BlackBerry Browser

1. Invoke Browser.getDefaultSession().

BrowserSession soundclip = Browser.getDefaultSession();

Accessing stored media

Playing media in the BlackBerry Browser

Playing media in the media application

Creating a BlackBerry Application that plays media files

Record audio on a BlackBerry smartphone

Send audio to a Bluetooth enabled headset

BlackBerry Java Development Environment Multimedia Development Guide

2. Invoke BrowserSession.displaypage().

soundclip.displayPage("file:///SDCard/BlackBerry/music/yourFile.mp3");

Play a video in the BlackBerry Browser

1. Invoke Browser.getDefaultSession().

BrowserSession soundclip = Browser.getDefaultSession();

2. Invoke BrowserSession.displaypage().

soundclip.displayPage("file:///SDCard/BlackBerry/Video/soccergame.avi");

Playing media in the media application

On the BlackBerry® smartphones that include the media application, a BlackBerry Application can use the

javax.microedition.content and net.rim.device.api.content packages to start the media application

with or without content.

Start the media application with or without content

1. Import the javax.microedition.content package into your application code.

Import javax.microedition.content;

2. Invoke Registry.getRegistry(). Pass the following parameter: the classname parameter which is the

name of the class in the application that extends javax.microedition.midlet.MIDlet,

net.rim.device.api.system.Application, or net.rim.device.api.ui.UiApplication. Store a

reference to the returned object in a Registry object.

Registry reg = Registry.getRegistry(String classname);

3. Perform one of the following tasks:

4. To start the media application, invoke Registry.invoke(Invocation invocation). Pass the following

parameter: an Invocation object.

reg.invoke(invocation)

Task Steps

Start the media application

with no content.

> Create a new instance of an Invocation object. Store a reference to the object in an Invocation

object.

Invocation invocation = new Invocation(null, null,

BlackBerryContentHandler.ID_MEDIA_CONTENT_HANDLER);

Start the media application

with content.

> Create a new instance of an Invocation object. Use a media type supported by the media

application as a parameter, and store a reference to the object in an Invocation object.

Invocation invocation = new Invocation(file://...);

Autres manuels pour JAVA DEVELOPMENT ENVIRONMENT - - MULTIMEDIA - DEVELOPMENT...

Ce manuel convient aux modèles suivants

Table des matières

Autres manuels Blackbe;rry Logiciel

Blackbe;rry

Blackbe;rry JAVA DEVELOPMENT ENVIRONMENT - - FEATURE AND... Guide d'installation

Blackbe;rry

Blackbe;rry Amazon MP3 Mode d’emploi

Blackbe;rry

Blackbe;rry Windows Live Messenger for BlackBerry Smartphones... Mode d’emploi

Blackbe;rry

Blackbe;rry CLIENT FOR IBM LOTUS SAMETIME Manuel utilisateur

Blackbe;rry

Blackbe;rry JAVA DEVELOPMENT ENVIRONMENT Mode d’emploi

Blackbe;rry

Blackbe;rry S-MIME SUPPORT PACKAGE VERSION 4.1 - Mode d’emploi

Blackbe;rry

Blackbe;rry CLIENT FOR IBM LOTUS SAMETIME - V2.5 Manuel utilisateur

Blackbe;rry

Blackbe;rry ICQ - MISE EN ROUTE Manuel utilisateur

Blackbe;rry

Blackbe;rry TICKETMASTER - LEARN MORE Manuel utilisateur

Blackbe;rry

Blackbe;rry YAHOO! MESSENGER FOR SMARTPHONES Manuel utilisateur

Blackbe;rry

Blackbe;rry INTERNET SERVICE - FEATURE AND TECHNICAL OVERVIEW... Manuel utilisateur

Blackbe;rry

Blackbe;rry JAVA DEVELOPMENT ENVIRONMENT - - FUNDAMENTALS... Manuel utilisateur

Blackbe;rry

Blackbe;rry PROFESSIONAL SOFTWARE FOR MICROSOFT EXCHANGE Mode d’emploi

Blackbe;rry

Blackbe;rry PROFESSIONAL SOFTWARE FOR IBM LOTUS DOMINO - - RELEASE... Mode d’emploi

Blackbe;rry

Blackbe;rry MYSPACE - VERWENDEN DES BROWSERS AUF IHREM... Manuel utilisateur

Blackbe;rry

Blackbe;rry JAVA DEVELOPMENT ENVIRONMENT Manuel utilisateur

Blackbe;rry

Blackbe;rry PRD-10459-005 - Enterprise Server For Novell... Manuel de l'opérateur

Blackbe;rry

Blackbe;rry CLIENT FOR IBM LOTUS SAMETIME - S V.2.5.20 Mode d’emploi

Blackbe;rry

Blackbe;rry TWITTER FOR SMARTPHONES - BETA V1.0 Manuel utilisateur

Blackbe;rry

Blackbe;rry MAIL - - HELP Manuel utilisateur

Blackbe;rry

Blackbe;rry ENTERPRISE SOLUTION SECURITY - ENFORCING ENCRYPTION OF INTERNAL AND EXTERNAL FILE SYSTEMS ON ... Manuel utilisateur

Blackbe;rry

Blackbe;rry AIM service Mode d’emploi

Blackbe;rry

Blackbe;rry GOOGLE TALK FOR BLACKBERRY SMARTPHONES 2.5 - RELEASE... Mode d’emploi

Blackbe;rry

Blackbe;rry AH0Q2ML - Lotus Domino Utility Server... Manuel utilisateur

Manuels Logiciel populaires d'autres marques

COMPRO

COMPRO COMPROFM Manuel utilisateur

Muratec

Muratec OFFICEBRIDGE ONLINE Manuel utilisateur

Oracle

Oracle Contact Center Anywhere 8.1 Manuel utilisateur

Adobe

Adobe 65007312 - Photoshop Lightroom Manuel

Avaya

Avaya NULL One-X for RIM Blackberry Manuel utilisateur

HP ProLiant BL420c Manuel utilisateur

PS Audio

PS Audio PowerPlay Manuel du propriétaire

Brady

Brady LOCKOUT PRO 3.0 Manuel de service

Avaya

Avaya Interaction Center Manuel utilisateur

Texas Instruments

Texas Instruments TI-83 Plus Silver Edition Manuel

Novell

Novell GROUPWISE 8 - INTERNET AGENT Manuel utilisateur

Oracle

Oracle Application 9i Manuel utilisateur

Acer

Acer RDM Manuel utilisateur

Canon

Canon Vixia HF21 Manuel utilisateur

Canon

Canon ZR950 Manuel utilisateur

Samsung

Samsung Auto Backup Manuel utilisateur

Polycom

Polycom Vortex EF2201 Instructions d'installation et d'utilisation

Brocade Communications Systems

Brocade Communications Systems Brocade 8/12c Manuel utilisateur

Blackbe;rry JAVA DEVELOPMENT ENVIRONMENT - - MULTIMEDIA - DEVELOPMENT... Manuel utilisateur

Manuels Logiciel populaires d'autres marques