KB110: Character Builder output in a Flash 8, 9, or Flex container

All Flash files are marked with a Flash version. By default the Character Builder renders content to Flash version 6. While there are newer versions of the Flash player available, all Flash players will work with older Flash content. Rendering to the lowest version possible allows the Character Builder output to run on a wide range of platforms, including many mobile platforms. However when the CB output is loaded into a Flash container, then it is the flash version of this container that is used to determine certain global behaviors. For this reason it is generally recommended that you mark your CB output with the same Flash version as the container. The CB output can be marked with a higher Flash version by setting the version number in the Flash Version property on the Advanced panel for the Project object in Outline view.

There are two specific cases to be aware of.

Rule 1 - Mark the CB output as version 8 or higher when loading into Flash 8 or higher

In switching from Flash 7 to Flash 8 Macromedia fixed a "pixel offset" problem that affected all prior versions of Flash. When rendering to version 6 or 7, the CB adds logic to compensate for the bug, which in turn results in a reverse off-by-one bug when running in a Flash 8 container. The problem is not always noticeable, but can appear as a slight shifting of pixels when raster-based (realistic) characters are talking or blinking. To fix this, be sure you have CB 4.0.6 or higher, then mark your CB output as Flash 8 or higher and re-render.

Rule 2 - Use a LocalConnection when embedding into a Flash 9 AS3 or Flex 3 container

With Flash 9 you have the option to use the new Action Script 3 (AS3) language. AS3 is also used with the Flex platform. When working with AS3 containers, please use version 4.1.1 of the Character Builder or higher, and review the Flash tutorial in the User's Guide. The new API itself is consistent across all containers, however the procedure for invoking methods and attaching events is different between ActionScript 2 and ActionScript 3. Also, you should always render your content to Flash 8 or higher when using Action Script 3. The Tutorials folder includes samples of methods and events under Flash 8, Flash 9 AS3, and Flex 3.







Copyright © 2008 Media Semantics, Inc. All rights reserved.
Comments? Write webmaster@mediasemantics.com. See also our privacy policy.