Flash Lite Developer Guides for LG Phones%28V.1.3EN%29

Embed Size (px)

Citation preview

  • 8/6/2019 Flash Lite Developer Guides for LG Phones%28V.1.3EN%29

    1/20

    Flash Lite Developer Guides for LG Phones

    Version 1.3 - Jun 23th, 2009

    LGDN-FTD-FL-DG-V1.3EN

    LG Mobile Developer Network

    Mobile Communication CompanyMobile Handset R&D Center

  • 8/6/2019 Flash Lite Developer Guides for LG Phones%28V.1.3EN%29

    2/20

    Copyright

    2 Flash Lite Developer Guides for LG Phones

    Copyright

    Copyright 2008 LG Electronics Inc. All Rights Reserved.

    Though every care has been taken to ensure the accuracy of this document, LG Electronics Inc. cannot accept

    responsibility for any errors or omissions or for any loss occurred to any person, whether legal or natural, from

    acting, or refraining from action, as a result of the information contained herein. Information in this document is

    subject to change at any time without obligation to notify any person of such changes.

    LG Electronics Inc. may have patents or patent pending applications, trademarks copyrights or other intellectual

    property rights covering subject matter in this document. The furnishing of this document does not give the

    recipient or reader any license to these patents, trademarks copyrights or other intellectual property rights.

    No part of this document may be communicated, distributed, reproduced or transmitted in any form or by any

    means, electronic or mechanical or otherwise, for any purpose, without the prior written permission of LG

    Electronics Inc.

    The document is subject to revision without further notice.

    All brand names and product names mentioned in this document are trademarks or registered trademarks of

    their respective owners.

    Trademarks

    Adobe, the Adobe logo, Flash, the Flash logo, and Flash Lite are either registered trademarks or trademarks of

    Adobe Systems Incorporated in the United States and/or other countries.

    All other trademarks and copyrights are the property of their respective owners.

  • 8/6/2019 Flash Lite Developer Guides for LG Phones%28V.1.3EN%29

    3/20

    About This Document

    Flash Lite Developer Guides for LG Phones 3

    About This Document

    Revision History

    Version Date Comment

    1.0 2008-09-10 Initial Release

    1.1 2008-12-12 Flash Lite 2.0 & 3.0 Enabled Phone Features were updated

    1.2 2009-02-09Chapter 1 Flash Lite Enabled LG Phone Features was updated and Chapter

    2 Deploying SWF Files into LG Phone was added

    1.3 2009-06-23 The GR500 and the Flash Lite in wallpaper column was added in Chapter 1

    Purpose and Scope

    This Guide is intended to make it easier for developers to create Adobe Flash Lite applications for

    LG mobile phones equipped with Flash Lite.

    This Guide provides Flash Lite 1.1, 2.0 and 3.0 supported LG phone features, and provides guide on how

    to deploy SWF file into LG phones. Also, tips on how to optimize Flash Lite applications are described.

    Audience

    This Guide is designed for the developers with basic knowledge in Flash Lite. Thus, this guide assumes

    that the reader is knowledgeable of basic concepts and terminology about Flash Lite. If you feel that the

    contents of this guide difficult and require more detailed explanations, refer to the following references

    or other related books.

    References

    Refer to the following references for more information:

    Topic Reference

    Adobe Flash Lite product pagehttp://www.adobe.com/devnet/devices/flashlite.ht

    ml

    Introduction to Flash Lite 2.x and 3.0 ActionScript http://livedocs.adobe.com/flashlite/3.0/docs/help.html?content=Part3_Intro_FL_AS_1.html

    Developing Flash Lite 2.x and 3.0 Applicationhttp://livedocs.adobe.com/flashlite/3.0/docs/help.ht

    ml?content=Part2_Dev_Guide_1.html

    Flash Lite 2.x and 3.0 Action Script Language Referencehttp://livedocs.adobe.com/flashlite/3.0/docs/help.ht

    ml?content=Part4_API_Ref_1.html

    Adobe Mobile and Devices Developer Centerhttp://www.adobe.com/devnet/devices/flashlite.ht

    ml

    http://www.adobe.com/devnet/devices/flashlite.htmlhttp://www.adobe.com/devnet/devices/flashlite.htmlhttp://www.adobe.com/devnet/devices/flashlite.htmlhttp://livedocs.adobe.com/flashlite/3.0/docs/help.html?content=Part3_Intro_FL_AS_1.htmlhttp://livedocs.adobe.com/flashlite/3.0/docs/help.html?content=Part3_Intro_FL_AS_1.htmlhttp://livedocs.adobe.com/flashlite/3.0/docs/help.html?content=Part3_Intro_FL_AS_1.htmlhttp://livedocs.adobe.com/flashlite/3.0/docs/help.html?content=Part2_Dev_Guide_1.htmlhttp://livedocs.adobe.com/flashlite/3.0/docs/help.html?content=Part2_Dev_Guide_1.htmlhttp://livedocs.adobe.com/flashlite/3.0/docs/help.html?content=Part2_Dev_Guide_1.htmlhttp://livedocs.adobe.com/flashlite/3.0/docs/help.html?content=Part4_API_Ref_1.htmlhttp://livedocs.adobe.com/flashlite/3.0/docs/help.html?content=Part4_API_Ref_1.htmlhttp://livedocs.adobe.com/flashlite/3.0/docs/help.html?content=Part4_API_Ref_1.htmlhttp://www.adobe.com/devnet/devices/flashlite.htmlhttp://www.adobe.com/devnet/devices/flashlite.htmlhttp://www.adobe.com/devnet/devices/flashlite.htmlhttp://www.adobe.com/devnet/devices/flashlite.htmlhttp://www.adobe.com/devnet/devices/flashlite.htmlhttp://livedocs.adobe.com/flashlite/3.0/docs/help.html?content=Part4_API_Ref_1.htmlhttp://livedocs.adobe.com/flashlite/3.0/docs/help.html?content=Part4_API_Ref_1.htmlhttp://livedocs.adobe.com/flashlite/3.0/docs/help.html?content=Part2_Dev_Guide_1.htmlhttp://livedocs.adobe.com/flashlite/3.0/docs/help.html?content=Part2_Dev_Guide_1.htmlhttp://livedocs.adobe.com/flashlite/3.0/docs/help.html?content=Part3_Intro_FL_AS_1.htmlhttp://livedocs.adobe.com/flashlite/3.0/docs/help.html?content=Part3_Intro_FL_AS_1.htmlhttp://www.adobe.com/devnet/devices/flashlite.htmlhttp://www.adobe.com/devnet/devices/flashlite.html
  • 8/6/2019 Flash Lite Developer Guides for LG Phones%28V.1.3EN%29

    4/20

    Conventions

    4 Flash Lite Developer Guides for LG Phones

    Conventions

    Codes

    In this document, the following indications are used to explain the syntax of programming language and

    source code:

    Source code is indicated in Courier New. Function names are indicated inbold Courier New. Parameters are indicated in Courier New.

    Notes & Cautions

    Notes and cautions are used to emphasize information. The following samples describe when each is

    used.

    Note

    Note contains information about something that is helpful to you.

    Caution

    Caution contains important information about something that you should know.

    Definition of Terminology

    The following table defines the terminologies used in this document:

    Terminology Description

    OTA Over-The-Air

    MMS Multimedia Messaging Service

  • 8/6/2019 Flash Lite Developer Guides for LG Phones%28V.1.3EN%29

    5/20

    Organization

    Flash Lite Developer Guides for LG Phones 5

    Organization

    This document contains the following chapters:

    Chapter 1 Flash Lite Enabled LG Phone Features

    This chapter provides Flash Lite 1.1, 2.0 and 3.0 phone features supported on LG mobile devices.

    Chapter 2 Deploying SWF Files into LG Phone

    This chapter introduces the SWF file deployment methods and guide on how to use LG PC Suite tool to

    deploy SWF files into LG phones.

    Appendix A Optimization Tips

    This appendix A describes development steps for Flash Lite application performance optimization techniques.

  • 8/6/2019 Flash Lite Developer Guides for LG Phones%28V.1.3EN%29

    6/20

    Contents

    6 Flash Lite Developer Guides for LG Phones

    Contents

    1 Flash Lite Enabled LG Phone Features ......................................................................... 81.1 Flash Lite 1.1 Enabled Phone Features ..................................................................................................................................... 91.2 Flash Lite 2.0 Enabled Phone Features ..................................................................................................................................... 91.3 Flash Lite 3.0 Enabled Phone Features ................................................................................................................................... 10

    2 Deploying SWF Files into LG Phone ........................................................................... 112.1 SWF File Deployment Methods .................................................................................................................................................. 12

    2.1.1 Phone Directory ...................................................................................................................................................................... 122.1.2 SWF File Size Limitation ...................................................................................................................................................... 13

    2.2 Deploying SWF File Using LG PC Suite .................................................................................................................................. 142.2.1 Deployment Process ............................................................................................................................................................. 14

    A Optimization Tips ........................................................................................................... 17A.1 Problems ................................................................................................................................................................................................ 18A.2 Performance Considerations ........................................................................................................................................................ 19

    Index ...................................................................................................................................... 20

  • 8/6/2019 Flash Lite Developer Guides for LG Phones%28V.1.3EN%29

    7/20

    Tables

    Flash Lite Developer Guides for LG Phones 7

    Tables

    Table 1-1. Flash Lite 1.1 enabled phone features ........................................................................................................................ 9Table 1-2. Flash Lite 2.0 enabled phone features ........................................................................................................................ 9Table 1-3. Flash Lite 3.0 enabled phone features ..................................................................................................................... 10Table 2-1. SWF File Deployment Method ..................................................................................................................................... 12Table 2-2. SWF File Size Limitation .................................................................................................................................................. 13

  • 8/6/2019 Flash Lite Developer Guides for LG Phones%28V.1.3EN%29

    8/20

    1 Flash Lite Enabled LG PhoneFeatures

    This chapter provides Flash Lite 1.1, 2.0 and 3.0 phone features supported on LG mobile devices.

    Contents

    1.1 Flash Lite 1.1 Enabled Phone Features

    1.2 Flash Lite 2.0 Enabled Phone Features

    1.3 Flash Lite 3.0 Enabled Phone Features

  • 8/6/2019 Flash Lite Developer Guides for LG Phones%28V.1.3EN%29

    9/20

    Chapter 1 - Flash Lite Enabled LG Phone Features

    Flash Lite Developer Guides for LG Phones 9

    1.1 Flash Lite 1.1 Enabled Phone Features

    The features of Flash Lite 1.1 enabled LG mobile devices are as below:

    Table 1-1. Flash Lite 1.1 enabled phone features

    Region ModelFL

    versionLCD size

    Color

    depth

    Standalone

    player

    Browser

    inline

    playback

    Flash Lite

    in

    wallpaper

    Europe U400 1.1 240x320 32 bit Yes No No

    1.2 Flash Lite 2.0 Enabled Phone Features

    The features of Flash Lite 2.0 enabled LG mobile devices are as below:

    Table 1-2. Flash Lite 2.0 enabled phone features

    Region ModelFL

    versionLCD size

    Color

    depth

    Standalone

    player

    Browser

    inline

    playback

    Flash Lite

    in

    wallpaper

    Europe KC560 2.0 240x320 16 bit Yes No Yes

    Europe, C.

    South AmericaKF350 2.0 240x320 16 bit Yes No Yes

    Europe, C.

    South America,

    Middle East

    KF700 2.0 240x480 16 bit Yes Yes Yes

    Europe U830 2.0 176x220 16 bit Yes Yes No

    Europe KC970 2.0 240x320 16 bit Yes Yes No

    Europe KU990 2.0 240x400 16 bit Yes Yes Yes

    North America CB630 2.0 240x320 16 bit Yes Yes Yes

    Europe, AsiaKU970

    U9702.0 240x400 16 bit Yes Yes No

  • 8/6/2019 Flash Lite Developer Guides for LG Phones%28V.1.3EN%29

    10/20

    Chapter 1 - Flash Lite Enabled LG Phone Features

    10 Flash Lite Developer Guides for LG Phones

    1.3 Flash Lite 3.0 Enabled Phone Features

    The features of Flash Lite 3.x enabled LG mobile devices are as below:

    Table 1-3. Flash Lite 3.0 enabled phone features

    Region ModelFL

    versionLCD size

    Color

    depth

    Standalone

    player

    Browser

    inline

    playback

    Flash Lite

    in

    wallpaper

    Europe,

    C. South AmericaKM900 3.0 480x800 16 bit Yes Yes No

    Europe HB620 3.0 320x240 16 bit Yes Yes Yes

    Europe, Asia KB770 3.0 240x400 16 bit Yes No Yes

    Europe KS500 3.0 240x320 16 bit Yes Yes No

    Europe, C. South

    America, Middle

    East & Africa, CIS

    KF750

    KF7573.0 240x320 16 bit Yes Yes Yes

    Europe KC910 3.0 240x400 16 bit Yes Yes Yes

    Europe, AsiaGT500

    GT5053.0.4 240x400 16 bit Yes Yes No

    North America GR500 3.0 240x400 16 bit No Yes No

  • 8/6/2019 Flash Lite Developer Guides for LG Phones%28V.1.3EN%29

    11/20

    2 Deploying SWF Files into LGPhone

    This chapter introduces the SWF file deployment methods and guide on how to use LG PC Suite tool to

    deploy SWF files into LG phones.

    Contents

    2.1 SWF File Deployment Methods

    2.2 Deploying SWF File Using LG PC Suite

  • 8/6/2019 Flash Lite Developer Guides for LG Phones%28V.1.3EN%29

    12/20

    Chapter 2 - Deploying SWF Files into LG Phone

    12 Flash Lite Developer Guides for LG Phones

    2.1 SWF File Deployment Methods

    The following methods can be used to deploy SWF files into LG phones.

    OTA Provisioning (Web Download)

    Bluetooth

    LG PC Suite (USB Cable)

    Email Attachment

    MMS

    External Memory Card

    The following table shows SWF file deployment method supported by LG phones:

    Table 2-1. SWF File Deployment Method

    Deployment Method

    U400 U830

    KU990 KC970

    KB770 HB620

    KS500 KF700

    KC910 KF750

    GT500/GT505

    CB630 KC560 KF350 KM900

    OTA Provisioning

    Bluetooth

    LG PC Suite

    Email Attachment

    MMS

    External Memory Card

    2.1.1 Phone Directory

    To deploy SWF files into mobile phones, you must deploy the files into the correct folder in the device.

    In most LG phones, the standalone player is supposed to recognize SWF files those are located in the

    FlashContents folder or subfolders within them.

    Once the file is deployed, you can find the SWF file from My Files Flash Contentsmenu to view and

    select it. The standalone player will then open the SWF file for viewing.

    Note

    Most LG phones support this folder, while in some case the folder might be different. You must first

    check the folder and deploy SWF files into it.

  • 8/6/2019 Flash Lite Developer Guides for LG Phones%28V.1.3EN%29

    13/20

    Chapter 2 - Deploying SWF Files into LG Phone

    Flash Lite Developer Guides for LG Phones 13

    2.1.2 SWF File Size Limitation

    The size limitations of SWF files for each model are listed in the following table. When you deploy SWF

    files into LG phones, they must be less than the limitation in size.

    Table 2-2. SWF File Size Limitation

    100 KB 300 KB 500 KB

    U400, U830, KC970,

    CB630, KU990, HB620,

    KB770, KF700

    KC560, KF350, KS500,

    KF750, KC910,

    GT500/GT505

    KM900

  • 8/6/2019 Flash Lite Developer Guides for LG Phones%28V.1.3EN%29

    14/20

    Chapter 2 - Deploying SWF Files into LG Phone

    14 Flash Lite Developer Guides for LG Phones

    2.2 Deploying SWF File Using LG PC Suite

    LG phones support the following deployment tool that allows you to download and deploy SWF file on

    your target devices using a USB cable.

    LG PC Suite

    LG PC Suite is a Data Transfer Software Suite that helps you conveniently transfer data stored in a

    mobile phone to a PC, and from a PC back to a mobile phone. You can also download the latest version

    of LG PC Suite from the LG Mobile.com web site.

    Requirements

    The following hardware and software are needed to deploy SWF file using LG PC Suite:

    USB Data Cable

    LG PC Suite

    USB Driver: If the USB driver is not deployed into a PC, it will be deployed automatically when you

    deploy LG PC Suite.

    2.2.1 Deployment Process

    The deployment process of a SWF file using LG PC Suite is as follows:

    1. Connect a target phone to your PC using a USB data cable.

    2. Launch LG PC Suite deployed on the PC. If the Connection Wizard appears, select the connect

    method between the target phone and the PC and perform the user authentication process. The

    Connection Wizard then detects which phone is connected to the PC and the following window

    appears.

  • 8/6/2019 Flash Lite Developer Guides for LG Phones%28V.1.3EN%29

    15/20

    Chapter 2 - Deploying SWF Files into LG Phone

    Flash Lite Developer Guides for LG Phones 15

    3. If the target phone is successfully connected to the PC, the following window appears. Clck [Contents].

    4. Select your project folder that contains the SWF files in the PC Folder, then a list of SWF files in the

    folder is shown in the right panel of the window.

    Select the desired SWF file and select [To Phone] from top menu to deploy them. You can also drag

    and drop the selected SWF file into the right panel of the window.

  • 8/6/2019 Flash Lite Developer Guides for LG Phones%28V.1.3EN%29

    16/20

    Chapter 2 - Deploying SWF Files into LG Phone

    16 Flash Lite Developer Guides for LG Phones

    5. Deploying the SWF file starts and the following screens are displayed on the phone LCD.

    6. As deploying the SWF files are finished, the phone starts to read them.

    Once the SWF files are deployed, they can be used on the device.

  • 8/6/2019 Flash Lite Developer Guides for LG Phones%28V.1.3EN%29

    17/20

    A Optimization Tips

    This appendix A describes development steps for Flash Lite application performance optimization

    techniques.

    Contents

    A.1 Problems

    A.2 Performance Considerations

  • 8/6/2019 Flash Lite Developer Guides for LG Phones%28V.1.3EN%29

    18/20

    Appendix A - Optimization Tips

    18 Flash Lite Developer Guides for LG Phones

    A.1 Problems

    Since Flash Lite applications run on performance restricted devices, developing without regard to the

    mobile devices performance presents the following obstacles.

    CPU performance issues: Using high-quality motion and vector images

    Increasing memory utilization: Using high-quality or complex images and bitmaps

  • 8/6/2019 Flash Lite Developer Guides for LG Phones%28V.1.3EN%29

    19/20

    Appendix A - Optimization Tips

    Flash Lite Developer Guides for LG Phones 19

    A.2 Performance Considerations

    In this section we present methods for maximizing Flash Lite application performance.

    1. Establishing the conceptEstablishing content concepts with considerations for the mobile CPU performance.

    2. Design

    Creating image sources (bitmap or vector) with CPU performance and memory considerations in mind.

    3. Architecture planning and development

    Developing with ActionScript and architecture planning for code reuse and easier, simpler editing.

    4. Device CPU & memory checks

    Check CPU and memory usage on device when application runs.

    Use QXDM1 to check UI task performance.

    Use Flash Lite SAPlayer2 to check memory utilization.

    5. Optimization

    Concentrate on optimizing problem areas where quality and utilization are important.

    The following is a general optimization method:

    Memory utilization should be practical for viewing structured movie clips.

    The following are for design optimization:

    Limit alpha usage.

    Use bitmap images.

    Limit use of masks.

    Use simple vector shapes.

    Limit use of gradients.

    Limit use of full screen modes.

    For CPU performance caps, set _quality to LOW and replace vector images with bitmaps. While a

    HIGH _quality setting produces smooth vector images, it increases CPU consumption.

    The following are ActionScript optimization techniques:

    Use local variables instead of global variables.

    Use short variable names.

    After using onEnterFrame make sure to use Delete to avoid unnecessary CPU usage.

    Limit excessive use of onEnterFrame.

    6. Conclusion

    1 QXDM is a QUALCOMM device diagnostic tool.

    2 SAPlayer is a debug tool included with the full version of Flash.

  • 8/6/2019 Flash Lite Developer Guides for LG Phones%28V.1.3EN%29

    20/20

    Index

    Bluetooth ..................................................................................... 12

    Email Attachment..................................................................... 12

    External Memory Card .......................................................... 12

    Flash Lite 1.1 Featured Phones ............................................ 9

    Flash Lite 2.0 Featured Phones ............................................ 9

    Flash Lite 3.0 Featured Phones ......................................... 10

    LG PC Suite ......................................................................... 12, 14

    MMS ............................................................................................... 12

    Optimization .............................................................................. 20

    OTA ................................................................................................. 12

    Phone Directory ....................................................................... 12

    SWF File Deployment Methods ........................................ 12

    SWF File Size Limitation ....................................................... 13