MACROMEDIA FLASH MX PROFESSIONAL 2004 - FLASH LITE 1.1... Manuale di istruzioni

Macromedia Flash Lite 1.1 Authoring Guidelines

Trademarks

Add Life to the Web, Afterburner, Aftershock, Andromedia, Allaire, Animation PowerPack, Aria, Attain, Authorware,

Authorware Star, Backstage, Bright Tiger, Clustercats, ColdFusion, Contribute, Design In Motion, Director, Dream Templates,

Dreamweaver, Drumbeat 2000, EDJE, EJIPT, Extreme 3D, Fireworks, Flash, Flash Lite, Flex, Fontographer, FreeHand,

Generator, HomeSite, JFusion, JRun, Kawa, Know Your Site, Knowledge Objects, Knowledge Stream, Knowledge Track,

LikeMinds, Lingo, Live Effects, MacRecorder Logo and Design, Macromedia, Macromedia Action!, Macromedia Breeze,

Macromedia Flash, Macromedia M Logo and Design, Macromedia Spectra, Macromedia xRes Logo and Design, MacroModel,

Made with Macromedia, Made with Macromedia Logo and Design, MAGIC Logo and Design, Mediamaker, Movie Critic,

Open Sesame!, Roundtrip, Roundtrip HTML, Shockwave, Sitespring, SoundEdit, Titlemaker, UltraDev, Web Design 101, what

the web can be, and Xtra are either registered trademarks or trademarks of Macromedia, Inc. 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 Macromedia, Inc. 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 Macromedia, and Macromedia 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. Macromedia provides these links only as a convenience, and the inclusion of the link does not imply that Macromedia

endorses or accepts any responsibility for the content on those third-party sites.

Speech compression and decompression technology licensed from Nellymoser, Inc. (www.nellymoser.com).

Sorenson™ Spark™ video compression and decompression technology licensed from

Sorenson Media, Inc.

Apple Disclaimer

APPLE COMPUTER, INC. MAKES NO WARRANTIES, EITHER EXPRESS OR IMPLIED, REGARDING THE

ENCLOSED COMPUTER SOFTWARE PACKAGE, ITS MERCHANTABILITY OR ITS FITNESS FOR ANY

PARTICULAR PURPOSE. THE EXCLUSION OF IMPLIED WARRANTIES IS NOT PERMITTED BY SOME STATES.

THE ABOVE EXCLUSION MAY NOT APPLY TO YOU. THIS WARRANTY PROVIDES YOU WITH SPECIFIC

LEGAL RIGHTS. THERE MAY BE OTHER RIGHTS THAT YOU MAY HAVE WHICH VARY FROM STATE TO

STATE.

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

Macromedia, Inc.

First Edition: June 2004

Macromedia, Inc.

600 Townsend St.

San Francisco, CA 94103

CONTENTS

CHAPTER 1: Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Using Macromedia Flash Lite 1.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Getting started . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Installing the Flash MX Professional 2004 7.0.1 update . . . . . . . . . . . . . . . . . . . 8

Installing the FlashLite1_1.dll (FlashLite1_1.dmg on the Mac) file . . . . . . . . . . 8

Installing the FlashLite1_1.xml file. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Installing the configuration file. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Supported Devices. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

CHAPTER 2: Optimizing Content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Navigation and key events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Fonts and text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Device fonts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Alias text support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Alias Text button . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Alias text rendered in Flash MX Professional 2004 . . . . . . . . . . . . . . . . . . . . . . 12

Pixel fonts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

ActionScript and properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Sound . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Network access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

SWF file size and memory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Performance optimization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Animation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

Bitmap graphics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

Bitmap versus vector graphics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Vector graphics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Optimizing ActionScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Device speed and frames per second . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Development checklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

CHAPTER 3: Working with Sound . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Audio formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Event sound . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Streaming sound . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Embedding sound . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Compound sound . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

4 Contents

Adding a Sound Bundle File to a Flash document . . . . . . . . . . . . . . . . . . . . . . . . . 23

CHAPTER 4: ActionScript Enhancements for Flash Lite 1.1 . . . . . . . . . . . . . . . . . 25

New ActionScript functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

FSCommand() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

FSCommand2() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Platform capabilities and variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

_capCompoundSound . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

_capEmail. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

_capMMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

_capSMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

_capStreamSound. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

$version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

_capMFi. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

_capMIDI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

_capSMAF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

_capLoadData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

_cap4WayKeyAS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

New ActionScript properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

scroll. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

maxscroll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

CHAPTER 5: New FSCommand and FSCommand2 commands . . . . . . . . . . . . 29

General commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

URL Encoding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Escape . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Unescape . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Input text fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

SetInputTextType(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Controlling Flash playback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Key configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Player operation commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Platform integration commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Date and time. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Volume. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

Vibrate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Power . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

Network information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Device user settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

Device and player identification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

CHAPTER 6: Creating Content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

Flash Lite 1.1 publish settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

Manually change settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

Creating a publish profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

Creating a simple movie for Flash Lite 1.1 (no sound). . . . . . . . . . . . . . . . . . . . . . 48

Adding sound to your Flash Lite 1.1 application . . . . . . . . . . . . . . . . . . . . . . . . . . 49

Contents 5

CHAPTER 7: Testing Content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

Testing considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

Using the optional configuration file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

CHAPTER 8: Development Kit Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

CHAPTER 9: Resources and Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

Let us know about your application. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

Web resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

Books . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

Discussion groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

APPENDIX A: Supported ActionScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

APPENDIX B: Supported ActionScript Properties . . . . . . . . . . . . . . . . . . . . . . . . 71

APPENDIX C: Warning and Error Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

Flash authoring tool warning and error messages. . . . . . . . . . . . . . . . . . . . . . . . . . 75

6 Contents

CHAPTER 1

Introduction

Macromedia Flash Lite Authoring Guidelines for covers tips, techniques, and sample code for

developing Macromedia Flash content for mobile phones using Macromedia Flash Lite 1.1.

Running Macromedia Flash Lite 1.1 on mobile phones allows users to view and interact with a

wide range of Flash content, such as games, informational guides, and dynamically updated

applications.

In addition to the information described in this guide, the developer kit includes numerous

examples and sample code to help clarify some of the ideas and concepts presented.

Using Macromedia Flash Lite 1.1

Macromedia Flash Player is broadly distributed on a variety of platforms, from Windows,

Macintosh, and UNIX-based desktop computers, to mobile phones, PDAs, and set-top boxes.

The Macromedia Flash Player application is approximately 500 KB, depending on the CPU. This

and its runtime memory requirements make it too large for most mobile phones. Therefore,

Macromedia created a new version of Flash Player called Macromedia Flash Lite, designed for

consumer devices, including mobile phones. For a new generation of mobile phones, an updated

version has been created, Flash Lite 1.1.

Macromedia Flash Lite 1.1 for the mobile phones lets Flash designers, developers, and content

providers quickly create engaging content for mobile phones using the ActionScript scripting

language, drawing tools, and templates.

Getting started

To create content for mobile phones, you must have the following items on your computer:

•The latest version of Macromedia Flash MX Professional 2004 (7.0.1)

•The new FlashLite1_1.dll (FlashLite1_1.dmg on the Mac) file for testing Flash applications in

the Flash Lite 1.1 authoring environment

•The new FlashLite1_1.xml file for publishing Flash Lite 1.1 SWF files

•The DevicesMsg.cfg configuration file for customizing the features that are supported in

Flash Lite 1.1.

8 Chapter 1: Introduction

Installing the Flash MX Professional 2004 7.0.1 update

To export Flash Lite 1.1 contents for mobile phones correctly, you need to have the latest version

of Macromedia Flash MX Professional 2004 (7.0.1). You can download the updater program

from the Macromedia website: www.macromedia.com/support/flash/downloads.html.

Installing the FlashLite1_1.dll (FlashLite1_1.dmg on the Mac) file

The FlashLite1_1.dll (FlashLite1_1 on the Mac) file is part of the Flash Lite 1.1 Authoring

Updater. This DLL is to be used to test content when you select Test Movie to validate your

content. This new DLL is used when Flash Lite 1.1 is selected as the Flash version to publish to

(using the publish setting interface). Copy the appropriate file to the following location:

•Windows:

C:\Program Files\Macromedia\Flash MX 2004\language\Configuration\Players

•Mac OS X:

Macintosh HD::Applications:Macromedia Flash MX 2004:Configuration:Players

Installing the FlashLite1_1.xml file

To author content using the FSCommand and the new FSCommand2 ActionScript, copy the

FlashLite1_1.xml file, which is available in the Installs folder of the CDK, into the following

location:

•Windows:

C:\Program Files\Macromedia\Flash MX 2004\language\Configuration\Players

•Mac OS X:

Macintosh HD::Applications:Macromedia Flash MX 2004:Configuration:Players

Installing the configuration file

The Flash Lite 1.1 Test Movie command allows users to customize the features that are supported

in Flash Player. From the Flash Lite 1.1 Authoring Updater, copy the DeviceMsg.cfg

configuration file into the following location:

•Windows 2000/ WindowsXP:

C:\Documents and Settings\user name\Local Settings\Application Data\Macromedia\

Flash MX 2004\language\Configuration\

•Windows 98(SE):

C:\Windows\Profiles\user name\Application Data\Macromedia\Flash MX 2004\

language\Configuration\

•Macintosh:

Macintosh HD::Users:user name:Library:Application Support:Macromedia:Flash MX 2004:

language:Configuration:

Supported Devices 9

Supported Devices

For details about mobile phones that support Flash Lite functionality, see the Macromedia

Developer Center web site at www.macromedia.com/devnet/devices/.

10 Chapter 1: Introduction

Questo manuale è adatto per i seguenti modelli

Indice

Altri manuali MACROMEDIA Software

MACROMEDIA

MACROMEDIA DREAMWEAVER 8 Manuale utente

MACROMEDIA

MACROMEDIA COLDFUSION MX 61 - CONFIGURING AND ADMINISTERING COLDFUSION... Guida

MACROMEDIA

MACROMEDIA FLASH 8-EXTENDING FLASH Manuale utente

MACROMEDIA

MACROMEDIA FLASH MX 2004-FLASH JAVASCRIPT DICTIONARY Manuale utente

MACROMEDIA

MACROMEDIA DIRECTOR MX 2004-GETTING STARTED WITH... Manuale utente

MACROMEDIA

MACROMEDIA DIRECTOR MX-LINGO DICTIONARY Manuale utente

MACROMEDIA

MACROMEDIA FLASH 8-LEARNING FLASH LITE 1.X ACTIONSCRIPT Manuale utente

MACROMEDIA

MACROMEDIA 38028779 - Macromedia Dreamweaver - Mac Istruzioni per l'installazione e il funzionamento

MACROMEDIA

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

MACROMEDIA

MACROMEDIA FLASH MEDIA SERVER 2-CLIENT-SIDE ACTIONSCRIPT LANGUAGE REFERENCE FOR FLASH MEDIA SERVER... Manuale di servizio

MACROMEDIA

MACROMEDIA COLDFUSION MX-CLUSTERCATS Istruzioni per il montaggio

MACROMEDIA

MACROMEDIA DREAMWEAVER 8 Manuale utente

MACROMEDIA

MACROMEDIA FIREWORKS 2-USING FIREWORKS Istruzioni per il montaggio

MACROMEDIA

MACROMEDIA FLASH 8-COMPONENTS LANGUAGE Manuale di servizio

MACROMEDIA

MACROMEDIA DREAMWEAVER MX 2004-EXTENDING DREAMWEAVER Manuale utente

MACROMEDIA

MACROMEDIA COLDFUSION 4.5-DEVELOPING WEB Manuale utente

MACROMEDIA

MACROMEDIA FLASH 8-USING FLASH Istruzioni per il montaggio

MACROMEDIA

MACROMEDIA DREAMWEAVER MX 2004-DREAMWEAVER API Manuale di servizio

MACROMEDIA

MACROMEDIA CONTRIBUTE-USING CONTRIBUTE Istruzioni per il montaggio

MACROMEDIA

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

MACROMEDIA

MACROMEDIA COLDFUSION MX 61-CFML Manuale di servizio

MACROMEDIA

MACROMEDIA COLFUSION MX 7-MIGRATING APPLICATIONS TO COLDFUSION MX... Manuale utente

MACROMEDIA

MACROMEDIA BREEZE 5 Manuale dell'operatore

MACROMEDIA

MACROMEDIA FLASH MX 2004-DATA Istruzioni operative

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