MACROMEDIA FLASH 8-DEVELOPING FLASH LITE 2.X Manuale utente

Developing Flash Lite 2.x Applications

Trademarks

1 Step RoboPDF, ActiveEdit, ActiveTest, Authorware, Blue Sky Software, Blue Sky, Breeze, Breezo, Captivate, Central,

ColdFusion, Contribute, Database Explorer, Director, Dreamweaver, Fireworks, Flash, FlashCast, FlashHelp, Flash Lite,

FlashPaper, Flash Video Endocer, Flex, Flex Builder, Fontographer, FreeHand, Generator, HomeSite, JRun, MacRecorder,

Macromedia, MXML, RoboEngine, RoboHelp, RoboInfo, RoboPDF, Roundtrip, Roundtrip HTML, Shockwave, SoundEdit,

Studio MX, UltraDev, and WebHelp are either registered trademarks or trademarks of Adobe Systems Incorporated and may be

registered in the United States or in other jurisdictions including internationally. Other product names, logos, designs, titles,

words, or phrases mentioned within this publication may be trademarks, service marks, or trade names of Adobe Systems

Incorporated or other entities and may be registered in certain jurisdictions including internationally.

Third-Party Information

This guide contains links to third-party websites that are not under the control of Adobe Systems Incorporated, and Adobe

Systems Incorporated is not responsible for the content on any linked site. If you access a third-party website mentioned in this

guide, then you do so at your own risk. Adobe Systems Incorporated provides these links only as a convenience, and the inclusion

of the link does not imply that Adobe Systems Incorporated endorses or accepts any responsibility for the content on those third-

party sites.

Sorenson™ Spark™ video compression and decompression technology licensed from

Sorenson Media, Inc.

Fraunhofer-IIS/Thomson Multimedia: MPEG Layer-3 audio compression technology licensed by Fraunhofer IIS and Thomson

Multimedia (http://www.iis.fhg.de/amm/)

Independent JPEG Group: This software is based in part on the work of the Independent JPEG Group.

Nellymoser, Inc.: Speech compression and decompression technology licensed by Nellymoser, Inc. (http:www.nellymoser.com).

Reserved. http://www.on2.com.

Visual SourceSafe is a registered trademark or trademark of Microsoft Corporation in the United States and/or other countries.

reproduced, translated, or converted to any electronic or machine-readable form in whole or in part without written

approval from Adobe Systems Incorporated. Notwithstanding the foregoing, the owner or authorized user of a valid copy

of the software with which this manual was provided may print out one copy of this manual from an electronic version of

this manual for the sole purpose of such owner or authorized user learning to use such software, provided that no part of

this manual may be printed out, reproduced, distributed, resold, or transmitted for any other purposes, including,

without limitation, commercial purposes, such as selling copies of this documentation or providing paid-for support

services.

Acknowledgments

Project Management: Mary Leigh Burke

Writing: Tim Statler

Managing Editor: Rosana Francescato

Editing: Linda Adler, Geta Carson, Mary Ferguson, Mary Kraemer

Production Management: Adam Barnett, Kristin Conradi

Localization: Luciano Arruda and Masayo Noda

Media Design and Production: Yuriko Ando, Aaron Begley, Paul Benkman. John Francis, Geeta Karmarkar, Paul Rangel,

Arena Reed, Mario Reynoso

Special thanks to Lisa Friendly, Bonnie Loo, Erick Vera, the beta testers, and the entire Flash Lite engineering and QA teams.

First Edition: January 2006

Adobe Systems Incorporated

601 Townsend St.

San Francisco, CA 94103

Contents

Chapter 1: Flash Lite 2.x Overview . . . . . . . . . . . . . . . . . . . . . . . . . . 5

About Flash Lite 2.0 features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5

Flash Lite 2.0 new features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

About components in Flash Lite 2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9

Chapter 2: Creating Interactivity and Navigation . . . . . . . . . . . . . .11

About user interaction in Flash Lite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11

Keys supported by Flash Lite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Using default navigation in Flash Lite . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Handling key and button events (Flash Professional only) . . . . . . . . . 20

Chapter 3: Working with Text and Fonts . . . . . . . . . . . . . . . . . . . .33

About text in Flash Lite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Creating and formatting text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Using input text fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Font rendering methods in Flash Lite . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

Text field example application (Flash Professional only). . . . . . . . . . . 42

Creating scrolling text (Flash Professional only) . . . . . . . . . . . . . . . . . . 44

Chapter 4: Working with Sound, Video, and Images . . . . . . . . . .47

About sound in Flash Lite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .47

Using device sound (Flash Professional only) . . . . . . . . . . . . . . . . . . . . 48

Using native Flash sounds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

Using device video . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

Loading external images. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

Chapter 5: Optimizing Content for Performance and Memory . . 71

Performance optimization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

Device speed and frames per second . . . . . . . . . . . . . . . . . . . . . . . . . . . .75

Optimizing ActionScript performance . . . . . . . . . . . . . . . . . . . . . . . . . . . .76

4Contents

Chapter 6: Testing Flash Lite Content

(Flash Professional Only) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

Overview of Flash Lite testing features (Flash Professional only) . . . 81

Testing features not supported by the Flash Lite emulator . . . . . . . . . 84

Using the Flash Lite emulator (Flash Professional only). . . . . . . . . . . . 84

Flash Lite error and warning messages (Flash Professional only) . . . 92

Selecting test devices and Flash Lite content type

(Flash Professional only) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94

Flash Lite content types (Flash Professional only) . . . . . . . . . . . . . . . . 97

Flash Lite platform capabilities (Flash Professional only) . . . . . . . . . .101

About playing a device video in the emulator . . . . . . . . . . . . . . . . . . . . 106

Appendix A: Warning and Error Messages

(Flash Professional Only) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107

Flash Lite emulator error and information messages (Flash Professional

only) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .117

CHAPTER 1

Flash Lite 2.x Overview

Macromedia Flash Lite 2.0 is a version of Flash Player designed for devices. Flash Lite 2.0 is

based on Flash Player 7 and supports most—but not all—features in Flash Player 7. Flash Lite

2.0 also includes features specific to mobile development that are not available in Flash Player

7. For example, in Flash Lite 2.0 you can load device-specific media types (images, sounds,

video) that aren’t natively supported by Flash Lite. Flash Lite 2.0 also features device

integration features, such as the ability to make phone calls and send text messages, among

others. This chapter provides an overview of the new features in Flash Lite 2.0, and also

discusses those features in Flash Player 7 that Flash Lite 2.0 doesn’t support.

This chapter contains the following topics:

About Flash Lite 2.0 features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Flash Lite 2.0 new features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

About components in Flash Lite 2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

About Flash Lite 2.0 features

This section lists new features in Flash Lite 2.0, as well as those features available in Flash

Player 7 that are not supported by Flash Lite 2.0.

Flash Lite 2.0 includes the following new features, which are described more fully under

“Flash Lite 2.0 new features” on page 6.

■ActionScript 2.0

■Device video playback

■Local, persistent data storage (Flash Lite shared objects)

■Support for loading device-specific sound and image formats

■New system capabilities information

■Support for additional device keys, including QWERTY keyboard support and support

for up to 11 soft keys

■Rich text formatting (partial support)

6FlashLite2.xOverview

■Ability to control backlight duration and set custom focus rectangle color

■Support for ActionScript 2.0, which lets you use advanced programming techniques

including classes, interfaces, and strict data typing

■Synchronized device sound

■XML processing support

The following features in Flash Player 7 are not available in Flash Lite 2.0:

■Several ActionScript classes available in Flash Player 7 are unsupported or partially

supported in Flash Lite 2.0. For more information about available ActionScript, see

Introduction to Flash Lite ActionScript 2.x.

■Socket communication using the XMLSocket class

■Support for communication with Macromedia Flash Media Server

■Remote shared objects (local shared objects are partially supported)

■Native support for Flash Video (FLV) playback

■Support for Flash Application Protocol (the binary data communication protocol used by

Flash Remoting)

■Cascading Style Sheet (CSS) formatting with text fields

■Masking with device fonts

■Bitmap smoothing while rendering at high-quality

Flash Lite 2.0 new features

The previous versions of Flash Lite (Flash Lite 1.0 and Flash Lite 1.1) are based on Flash

Player 4. Flash Lite 2.0 is based on Flash Player 7 and supports most of the features available

in that version of Flash Player—including XML processing and ActionScript 2.0. Flash Lite

2.0 also provides several features not available in Flash Player 7 that are designed for mobile

applications. The rest of this section describes the new features in Flash Lite 2.0.

Flash Lite 2.0 ActionScript

Flash Lite 2.0 ActionScript is the scripting language used in Flash Lite 2.0 applications. It

shares some, but not all, of the ActionScript used in Flash Player 7. Flash Lite 2.0 also

includes several ActionScript additions and extensions that let you, for example, get

information about the device, make phone calls, or control the backlight duration.

Flash Lite 2.0 new features 7

You can use ActionScript 2.0 or ActionScript 1.0 syntax when you develop applications for

Flash Lite 2.0. ActionScript 2.0 provides authoring support for classes, interfaces, and strict

data typing. Using ActionScript 2.0 syntax lets the ActionScript compiler provide better

debugging information, and also encourages better program design.

For more information about learning Flash Lite 2.0 ActionScript, see the following books and

topics:

■Introduction to Flash Lite 2.x ActionScript

■Flash Lite 2.x ActionScript Language Reference

■Learning ActionScript 2.0 in Using Flash

Device video playback

Flash Lite 2.0 can play video in any format that’s supported natively by the target device. For

example, some devices record and playback video in the 3GP video format. Others support

AVI or MPEG video. During playback, Flash Lite passes the original video data to the device

to decode and render the data directly to the screen. You can incorporate video in your

application in any of the following ways:

■Bundle the original video data in the SWF file.

■Load an external video file from the device’s memory card, or over the network.

To control video playback in Flash Lite 2.0 you use the ActionScript Video object. First

available in Flash Player 6, the Video object in Flash Lite 2.0 has additional methods for

controlling video, as the Video.play() and Video.pause() methods. You can also use the

System.capabilities.videoMIMETypes array to determine what video formats a device

supports.

For more information about the Video object and using video in Flash Lite, see “Using device

video” on page 58.

Loading device-specific sound and image formats

In Flash Lite 2.0, you can load any image or sound file that’s in a format supported by the

device. To load external images, you use the loadMovie() global function, or the

MovieClip.loadMovie() method. For example, if the device supports the PNG file format,

then you could use the following code to load a PNG file from a web server into the movie

clip instance image_mc:

image_mc.loadMovie("http://www.macromedia.com/images/mobile.png");

8FlashLite2.xOverview

To load external sounds, you use the Sound.loadSound() method. In Flash Lite 2.0, you can

use this method to load any sound format that the device supports (for example, MIDI or

SMAF). External device sounds must fully load into memory before they can play.

As in Flash Lite 1.x, in Flash Lite 2.0 you can also play device sound that’s bundled in the

SWF file. For more information, see “Using bundled device sound” on page 48.

For more information about loading external images and sounds, see the following topics:

■“Loading external images” on page 68

■“Playing external device sounds” on page 53

Flash Lite shared objects

Flash Lite shared objects lets you save data persistently to the user’s device. For example, you

might use a shared object to save information between application sessions, such as user

preferences or game scores. You use the SharedObject class to read and write Flash Lite shared

objects. For more information about using Flash Lite shared objects, see the SharedObject

class in the Flash Lite 2.x ActionScript Language Reference.

Synchronized device sound

In previous versions of Flash Lite you could only synchronize native Flash sound to animation

in the timeline. But this was not possible with device sounds, which are played directly by the

device, rather than natively by Flash Lite. In Flash Lite 2.0, you can synchronize device sound

with the timeline using the new _forceframerate property. When this property is set to

true, Flash Lite drops frames as necessary from animation to maintain the frame rate

specified in the SWF file. For more information, see “About synchronizing device sounds with

animation” on page 54 and the _forceframerate property.

NOTE

The Flash Lite 2.0 implementation of shared objects does not allow multiple SWF files

to share the same data. Also, Flash Lite 2.0 does not support remote shared objects

with Macromedia Flash Media Server.

About components in Flash Lite 2.0 9

New text features

The following features related to text handling are new in Flash Lite 2.0:

■All text in Flash Lite 2.0 is Unicode based.

■Flash Lite 2.0 provides partial support for HTML formatting and the TextFormat

ActionScript class.

For more information about working with text fields in Flash Lite 2.0, see “Working with

Text and Fonts” on page 33.

Additional key support

Flash Lite 2.0 provides additional support for device keys, including support for QWERTY

keyboards, and up to 12 soft keys (including the standard left and right soft keys).

About components in Flash Lite 2.0

The components that install with Flash 8 and Flash Professional 8 (for example, DataGrid

and Accordion) were designed for use in Flash desktop applications. The memory

requirements and processing power that they require typically prohibit their use in Flash Lite

2.0 applications. Macromedia recommends that you don’t use the standard user interface

components in your Flash Lite applications.

10 Flash Lite 2.x Overview

Altri manuali per FLASH 8-DEVELOPING FLASH LITE 2.X

Questo manuale è adatto per i seguenti modelli

Indice

Altri manuali MACROMEDIA Software

MACROMEDIA

MACROMEDIA FLASH MX 2004-DATA Istruzioni operative

MACROMEDIA

MACROMEDIA CONTRIBUTE 3 - DEPLOYING AND PUBLISHING... Manuale utente

MACROMEDIA

MACROMEDIA COLFUSION MX 7-CFML Manuale di servizio

MACROMEDIA

MACROMEDIA DREAMWEAVER 8 Manuale utente

MACROMEDIA

MACROMEDIA BREEZE-FOR MEETING PARTICIPANTS Manuale utente

MACROMEDIA

MACROMEDIA BREEZE-MANAGING EXTERNAL BREEZE REPORTS Manuale utente

MACROMEDIA

MACROMEDIA DREAMWEAVER 8-EXTENDING DREAMWEAVER Manuale utente

MACROMEDIA

MACROMEDIA COLFUSION MX 7-CFML Manuale utente

MACROMEDIA

MACROMEDIA FLASH 8-FLASH Manuale di servizio

MACROMEDIA

MACROMEDIA FLASHLITE2 ACTIONSCRIPT-LANGUAGE Manuale di servizio

MACROMEDIA

MACROMEDIA COLDFUSION 5-CFML Manuale utente

MACROMEDIA

MACROMEDIA DIRECTOR MX 2004-USING DIRECTOR Istruzioni per il montaggio

MACROMEDIA

MACROMEDIA BREEZE-USING THE BREEZE PLUG-IN FOR MICROSOFT... Istruzioni per il montaggio

MACROMEDIA

MACROMEDIA FLASH MEDIA SERVER 2-DEVELOPING MEDIA Manuale utente

MACROMEDIA

MACROMEDIA DIRECTOR MX 2004-DIRECTOR SCRIPTING Manuale di servizio

MACROMEDIA

MACROMEDIA COLDFUSION 5-DEVELOPING Manuale utente

MACROMEDIA

MACROMEDIA COLDFUSION 5-CFML Manuale di servizio

MACROMEDIA

MACROMEDIA DREAMWEAVER MX 2004-EXTENDING DREAMWEAVER Manuale utente

MACROMEDIA

MACROMEDIA FLASH MEDIA SERVER 2-INSTALLING FLASH MEDIA SERVER... Manuale utente

MACROMEDIA

MACROMEDIA COLFUSION MX 7-GETTING STARTED BUILDING COLDFUSION... Manuale utente

MACROMEDIA

MACROMEDIA FLASH 8-LEARNING ACTIONSCRIPT 2.0 IN FLASH Manuale utente

MACROMEDIA

MACROMEDIA COLDFUSION 4.5-CFML LANGUAGE Manuale di servizio

MACROMEDIA

MACROMEDIA BREEZE-CLUSTERING BREEZE PRESENTATION... Manuale utente

MACROMEDIA

MACROMEDIA BREEZE-CLUSTERING BREEZE LIVE Manuale utente

Manuali Software popolari di altre marche

COMPRO

COMPRO COMPROFM Manuale utente

Muratec

Muratec OFFICEBRIDGE ONLINE Manuale utente

Oracle

Oracle Contact Center Anywhere 8.1 Manuale utente

Adobe

Adobe 65007312 - Photoshop Lightroom Manuale

Avaya

Avaya NULL One-X for RIM Blackberry Manuale utente

HP ProLiant BL420c Manuale utente

PS Audio

PS Audio PowerPlay Manuale del proprietario

Brady

Brady LOCKOUT PRO 3.0 Manuale di servizio

Avaya

Avaya Interaction Center Manuale utente

Texas Instruments

Texas Instruments TI-83 Plus Silver Edition Manuale

Novell

Novell GROUPWISE 8 - INTERNET AGENT Manuale utente

Oracle

Oracle Application 9i Manuale utente

Acer

Acer RDM Manuale utente

Canon

Canon Vixia HF21 Manuale utente

Canon

Canon ZR950 Manuale utente

Samsung

Samsung Auto Backup Manuale utente

Polycom

Polycom Vortex EF2201 Istruzioni per l'installazione e il funzionamento

Brocade Communications Systems

Brocade Communications Systems Brocade 8/12c Manuale utente