Flash Lite Authoring Guidelines for the i-mode Service by NTT DoCoMo 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, Macromedia, Macromedia Action!, 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, 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, servicemarks, or tradenames of Macromedia, Inc. or other entities and may be registered in certain jurisdictions including internationally. This guide contains links to third-party Web sites 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 Web site 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. i-mode, the i-mode logo, NTT DoCoMo, and DoCoMo are trademarks or registered trademarks of NTT DoCoMo, Inc. NTT DoCoMo and Other Third-Party Information 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. Copyright © 2003 Macromedia, Inc. All rights reserved. This manual may not be copied, photocopied, reproduced, translated, or converted to any electronic or machine-readable form in whole or in part without prior written approval of Macromedia, Inc. Acknowledgments Director: Erick Vera Producer: Barbara Nelson Writing: Paul Goldman Editing: Lisa Stanziano Print Design and Production: Adam Barnett First Edition: March 2003 Macromedia, Inc. 600 Townsend St. San Francisco, CA 94103 CONTENTS CHAPTER 1: Introduction ............................................. 5 About the i-mode service by NTT DoCoMo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Getting started . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 CHAPTER 2: Developing Content ...................................... 7 Navigation and key events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 i-mode compatible HTML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 ActionScript and properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 Sound . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Network access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Screen size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Movie size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Performance Optimization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Interactive versus Inline content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 CHAPTER 3: Sound . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 15 15 16 18 Embedding sound in Flash Lite movies for i-mode phones . . . . . . . . . . . . . . . . . . MFi sound substitution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Associating an MFi sound file with an ActionScript sound symbol . . . . . . . . . . Accessing sound on main and movie clip Timelines . . . . . . . . . . . . . . . . . . . . . CHAPTER 4: Testing Content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 DoCoMo's i-mode HTML Simulator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 APPENDIX A: Supported ActionScript APPENDIX B: Supported Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 APPENDIX C: Warning and Error Messages . APPENDIX D: References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 Macromedia websites. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 3 4 Contents CHAPTER 1 Introduction Macromedia has created a new profile of the Flash Player called Macromedia® FlashTM Lite, designed for consumer mobile devices, including phones for the i-mode service by NTT DoCoMo. This format is designed to run optimally on devices with limited memory, processor speed, and display area. Content created for Flash Lite is most similar to Flash Player 4 content. The Macromedia Flash MX Professional 2004 User Guide for Flash Lite describes, in general, tools and guidelines for authors creating Flash Lite movies. This document contains authoring information specific to creating movies for i-mode phones. About the i-mode service by NTT DoCoMo The i-mode service by NTT DoCoMo is a mobile phone service in Japan that provides its customers with both voice and comprehensive data services. With an i-mode phone, users can exchange i-mode e-mail and obtain information from i-mode menu sites and i-mode compatible Internet sites. The i-mode phone contains a browser that displays i-mode compatible HTML web pages. Beginning with the 505i phones, you can view Macromedia Flash Lite movies from the i-mode browser. You can also use the phones' My Picture and Standby Screen applications to view Flash Lite movies. Although a number of manufacturers produce 505i phones, all of them support the same Flash Lite functionality. Getting started To create Flash Lite movies for i-mode phones, you need to install Macromedia Flash MX Professional 2004, available from the Macromedia website. (See Appendix D, "References," on page 47, for links to the Macromedia website.) . Read the Macromedia Flash MX Professional 2004 User Guide for Flash Lite for an overview of Flash Lite and basic authoring information. To test your completed Flash Lite movies for i-mode phones, you should obtain the i-mode HTML Simulator from the DoCoMo website. (See Appendix D, "References," on page 47.) The Simulator is an application tool that emulates the operation of an i-mode phone and allows you to test the validity of Flash Lite movies. Though useful, the Simulator is no substitute for testing on actual i-mode phones--only testing on actual phones will give you a true picture of your Flash Lite movie's performance. 5 6 Chapter 1: Introduction CHAPTER 2 Developing Content Starting with the 505i phones, the i-mode service by NTT DoCoMo supports the ability to view Flash Lite movies. The same Flash Lite functionality is available on all 505i phones, regardless of manufacturer. This chapter describes considerations for creating Flash Lite movies that run on imode phones, from general functionality to performance and size constraints. The 505i phones support Flash Lite in both English and Japanese. However, there are a few exceptions to the standard Flash Lite specification. To review the standard specification, see the Macromedia Flash MX Professional 2004 User Guide for Flash Lite. The exceptions to the standard are detailed in this document. Navigation and key events Flash Lite for i-mode uses three keys for navigation: Up, Down, and Select. The Left and Right keys are reserved for the i-mode browser. These three keys correspond to the Shift+Tab, Tab, and Enter keys on the desktop versions of the Flash Player. The keys 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, *, and # are also available. These correspond to the same keys on the desktop versions of the Flash Player. You can attach ActionScript to these keys and the Enter key as you would normally in Flash. ActionScript attached to other keys is ignored. Text and fonts Flash Lite includes support for both device and embedded fonts. You can use embedded fonts to give you more control over the design of your movie, but doing so increases the SWF file size. Using the device font for text limits you to a single font, but helps keep your file size small. When using device fonts, Flash Lite limits special text formatting for dynamic text fields to justification (left, center, right) and color. Formatting options such as superscript, subscript, kerning, bold, and italic are not supported. Flash Lite does not support input text fields--input text fields are not selectable and cannot be used to enter text. 7 Emoji i-mode phones support special pictographic characters called Emoji. The following characters are examples of Emoji: These are encoded by replacing characters in the standard Shift-JIS table. As long as the phone's font supports Emoji encoded as standard Shift-JIS characters, Flash Lite can display them. When authoring using Flash, you first need to ensure that you have Shift-JIS fonts installed on your desktop authoring system. You also need to select a Shift-JIS font for the text fields in which you want to display Emoji characters. Note: The phone's font set controls the color and appearance of Emoji characters. For further information about Emoji, see Appendix D, "References," on page 47. i-mode compatible HTML i-mode browsers can directly run Flash Lite movies, or movies can be embedded in i-mode compatible HTML web pages. The i-mode compatible HTML specification is based on a subset of HTML 2.0, HTML 3.2, and HTML 4.0 specifications that DoCoMo extended with tags and attributes for special use on mobile phones. As an example, extensions include the tel URL protocol, which is used to link to a phone number and let users initiate a phone call. For information on i-mode compatible HTML, see Appendix D, "References," on page 47. ActionScript and properties Flash Lite for i-mode supports most Flash 4 ActionScript commands. The following are notable exceptions: · Use the add operator instead of the & command to concatenate strings. · Button mouse events such as dragOver, dragOut, and releaseOutside cannot be used to trigger ActionScript attached to buttons. However, in addition to keypress events, the events and rollOut can be used to trigger ActionScript when attached to buttons and accessed through key-based navigation. Draggable movie clip functions and properties (for example: startDrag, stopDrag, and _dropTarget properties) are not supported. Use the eq operator to compare strings and the == operator for numeric comparison. URL encoding must be done manually using ActionScript. The escape() ActionScript function is not a Flash 4 function and is not available in Flash Lite. The fscommand() function is not supported. The default Quality level for Flash Lite during playback is medium and there is no support for bitmap smoothing. press, release, rollOver, · · · · · 8 Chapter 2: Developing Content · The getURL() function can only be called once per keypress, and can only be used for the · and tel protocols. Only the first getURL() call in a keypress statement block is executed; all subsequent getURL() calls in the same block are ignored. A button action can be assigned to launch an e-mail composition window with the address, subject, and body text fields already populated. There are two methods to do this. Method 1 can be used for either Shift-JIS or English character encoding, while method 2 only supports English character encoding. http, mailto, https Method 1 Set variables for each of the desired parameters, for example: on (release, keyPress "#") { subject = "email subject"; body = "email body"; getURL("mailto:somebody@anywhere.com", "", "GET"); } Method 2 Define each ...