Flash Lite User Guide
Trademarks Add Life to the Web, Afterburner, Aftershock, Andromedia, Allaire, Animation PowerPack, Aria, Attain, Authorware, Authorware Star, Backstage, Bright Tiger, Clustercats, ColdFusion, Design In Motion, Director, Dream Templates, Dreamweaver, Drumbeat 2000, EDJE, EJIPT, Extreme 3D, Fireworks, Flash, Fontographer, FreeHand, Generator, HomeSite, JFusion, JRun, Kawa, Know Your Site, Knowledge Objects, Knowledge Stream, Knowledge Track, LikeMinds, Lingo, Live Effects, MacRecorder Logo and Design, Macrome
CONTENTS CHAPTER 1: Introduction ............................................. 5 About using Macromedia Flash MX Professional 2004 to author Flash Lite content 5 CHAPTER 2: Getting Started . ......................................... 7 Flash Lite features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Navigation and key events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Text and fonts. . . . . . . . . . . . . . .
Contents
CHAPTER 1 Introduction Macromedia has created a new Flash Player version, called Macromedia® Flash™ Lite, that runs on a new class of consumer mobile devices. This format is designed to run optimally on devices with limited resources (memory, processor speed, display area). Content created for Flash Lite is most similar to Flash Player 4 content, with the primary exception of how sound is incorporated and played.
Chapter 1: Introduction
CHAPTER 2 Getting Started Flash Lite features This section describes, at a high level, the features and restrictions for authoring a Flash Lite compatible movie. For different target devices there may be further feature restrictions or enhancements. Please consult the appropriate authoring guidelines document for details. Navigation and key events Macromedia Flash Lite reserves certain keys for navigation. The exact keys depend on the specific device.
ActionScript functions and properties Macromedia does not guarantee that all Flash 4 ActionScript and properties will run on all devices. Consult the appropriate authoring guidelines document for details. The following general restrictions apply to using ActionScript when authoring for Flash Lite: • You use the add command to concatenate strings. • Button mouse events such as dragOver, dragOut, and releaseOutside cannot be used to • • • • • • • • • trigger ActionScript attached to buttons.
CHAPTER 3 Developing Content for Flash Lite This chapter describes the process of developing content for Flash Lite and the issues to be aware of when authoring Flash Lite compatible movies. The following tutorials are provided to help you accomplish the following tasks: • Creating a simple Flash Lite compatible movie (no sound) • Using the Device Sound feature in Flash MX Professional 2004 for simple sound substitution To author for Flash Lite (general process): 1 Launch Flash MX Professional 2004.
In the Version pop-up menu, select Flash Lite 1.0. ■ Click OK. After setting the Publish Settings to Flash Lite 1.0, you can see what Flash Lite ActionScript is supported in the Actions window. Open the Actions window (Window > Actions), click Index in the left pane and scroll down. ActionScript not supported in Flash Lite is highlighted in yellow. If you move your mouse over the highlighted text, a tooltip message appears letting you know what Flash version supports this ActionScript.
Testing Flash Lite compatible content Once you’ve set the publish settings for Flash Lite, Flash MX Professional 2004 test movie player can play any Flash Lite compatible content. When you select Control > Test Movie, new information, warning, and error messages specifically related to Flash Lite are displayed in a separate Output window: Example of messages displayed in the test movie player Output window.
4 If the button is not selected on the Stage, click it once. In the Actions panel (select Window > Development Panels > Actions if the panel is not visible), type the following: on (release) { getURL("http://www.macromedia.com", _top); } 5 Select Control > Test Movie. Flash MX Professional 2004 starts the test movie player. You can now interact with the movie. When you click the button, a browser window opens at http://www.macromedia.com. 6 Select File > Publish to save the SWF file as tutorial.swf.
9 Associate the proxy sound with the MySound.mid file by doing the following: ■ Select Window > Library and find the sound that you added earlier. Select the sound and right-click it to open the context menu. Select Properties from the context menu. The Sound Properties dialog box appears: In the Device sound option, use the file browser to find and select MySound.mid. ■ Click OK. 10 Select Control > Test Movie to start the Flash MX Professional 2004 Flash Lite 1.0 test movie player.
Chapter 3: Developing Content for Flash Lite
APPENDIX A Warning/Error Messages This appendix lists all the possible error messages that you might see when creating content for Flash Lite in general. They may not all apply for a specific deployment platform. Message Identifier Message Explanation SWFS016 Detected loadMovie will be ignored. The Flash player detected that the SWF movie contains a loadMovie ActionScript command, which is not supported by the specified device’s Flash Player.
Message Identifier Message SWFS021 _droptarget property not The Flash player detected that the SWF supported. movie contains a getProperty or setProperty ActionScript command referring to the _droptarget property, which is not supported by Flash Lite. No modifications will be made to the device-specific SWF file – this is just a warning. SWFS022 _highquality property not The Flash player detected that the SWF fully supported.
Message Identifier Message Explanation SWFS032 Detected FSComamnd - The Flash player detected that the SWF will be ignored. movie contains a FSCommand ActionScript command, which is not supported by the specified device’s Flash Player. No modifications will be made to the devicespecific SWF file – this is just a warning. SWFS033 Not enough memory to perform operation. The Flash player was unable to get enough memory to finish the operation SWFS034 Input Text Fields not supported.
Message Identifier Message Explanation SWFS040 UnCompressed Sound found. The Flash player detected that the SWF movie contains uncompressed sound. which is not supported by the specified device’s Flash Player. No modifications will be made to the device-specific SWF file - this is just a warning. SWFS041 ADPCM Sound found. The Flash player detected that the SWF movie contains ADPCM sound. which is not supported by the specified device’s Flash Player.
Message Identifier Message Explanation FTPE013 Text fields are not selectable. While testing the movie, an attempt was made to select a text field. Flash Lite for i-mode does not support Input text fields – they are rendered as non-selectable text fields. FTPA002 FSCommand is ignored. While testing the movie, a FSCommand ActionScript command was encountered. This command is not supported by the specified device’s Flash Player and will be ignored. FTPA003 loadVariables is ignored.
Message Identifier Message Explanation FTPA014 getURL is ignored. While testing the movie, a getURL Actionscript command was encountered. It will be ignored because specified device's Flash Player doesn't support it. FTPA015 The call to loadMovie for was ignored because there was more than one request per keypress. While testing the movie, multiple ActionScript loadMovie commands were called during a keypress event.
Message Identifier Message Explanation FTPS011 Only a single sound can be played at a time (no mixing). While testing the movie, a sound was started while another sound was already playing. Flash Lite does not support sound mixing, so the first sound will be stopped to allow the second sound to play. FTPS012 Event sound was ignored because it was not associated with a keypress. While testing the movie, an event sound was encountered outside of a keypress event.
Appendix A: Warning/Error Messages