• 執行效能較佳
• 與 Box2D 原版 API 接近，假如原版更新了，也可以自己架設 Alchemy 更新到 Flash 版
• 提供了很多輔助類別可以使用，譬如能夠作到各種形狀重力場等
• 與 Flash IDE 完美整合在一起，甚至只要用拖拉的方式就可以建立好需要的物理場景

唯一的缺點只有檔案較大，沒有提供單一打包好的 SWC，導致編譯速度太慢問題
用了之後一定會占掉 300kb 左右大小，這或許也不算很大
不過編譯速度太慢真的很傷腦筋
所以本篇文章的目的就是要把整個 Project 打包為單一 SWC
如此一來，編譯速度就會大幅提升，也能很容易的拿到 Flash Builder 內使用

當我實際開始著手這樣工作之後，才發現遇到很多問題
也懶得一一解釋原因了
主要的步驟如下：

1. 開一個空白的 Flex Library Project – Box2DAlchemyLib
2. 將 Box2D.swc 加入到 lib path
3. 將所有的 AS3 Class 放置到 Flex Lib src 下，修正未宣告型別、存取修飾子等語法問題

e.g. /src/wck/WavesEffect.as -> /src/extra/WavesEffect.as

4. 於空的 Package 下放置空白 Dummy Class

e.g. /src/Box2DAS/Cls.as

以上就能產生出可以同時給 Flash/Flex 用的 SWC 類別庫了
假如想要把 Demo.fla 套用新的 SWC 類別庫
修改步驟如下：

1. 修改 fla AS3 Setting，path 加入 Box2DAlchemyLib.swc，並取消發布 SWC
2. 修改 MovieClip 設定

GravityCapsule Symbol
Class: GravityCapsule
Base Class: gravity.GravityCapsule

GravityLinear Symbol
Class: GravityLinear
Base Class: gravity.GravityLinear

GravityRadial Symbol
Class: GravityRadial
Base Class: gravity.GravityRadial

GravitySine Symbol
Class: GravitySine
Base Class: gravity.GravitySine

修改完之後，編譯時間從原本 30 秒大幅縮短到 9 秒呢
這是我修改完之後的 Box2D WCK Library Project，從 2011-06-15 那版改的

Related posts:

1. richmediaplus.utils.AlertUtils
2. Warning: Class ‘Close’ does not extend the ‘DefineBits’ asset base class ‘flash.display.Bitmap’.
3. RobotLegs Module 開發上的問題

這對於多媒體光碟製作可能有些困擾
不過可以自行調整優先順序，相對路徑 SWZ 往上拉就好了

除此之外，假如是直接發布成 Projector 執行檔
基本上它是不支援 RSL 的，會出現警告訊息
然後一律變成 Merged into code 模式

Warning: No libraries were linked as Runtime Shared Libraries (RSLs) because of your publish settings: Windows Projector

假如改成 External 模式，就必須自己寫載入 RSL 的程式
一個比較好的方式是，先發布成 SWF，然後自己手動把具有動態載入 RSL 能力的 SWF 轉成 Projector

Related posts:

1. Adobe Flex Application LifeCycle
2. Flash Player 10.2, 10.3 TextField 中文字體問題
3. 巢狀遮罩造成 Flash Player 死機的 Bug

先看一下 Flex/Flash 自带的 Alert:

Alert.show(text:String = "", title:String = "", flags:uint = 0x4, parent:Sprite = null, closeHandler:Function = null, iconClass:Class = null, defaultButtonFlag:uint = 0x4):Alert

Alert Message 直接写在 Flex/Flash 的项目中，对于 Message 的不同性质，不同内容，不同parent，不同icon，不同 button 首选项…都要进行逐一的控制，而每次可能都会常常填写相同的 Message 内容 和 Message 标题。多的事情看起来就很讨厌，麻烦的事情更加让人不想去做。若遇到问题需要对 Message 进行修改，Alert 有多少我们就要改多少，而且时不时会有不小心遗漏的现象的问题出现。如果一开始就对 Alert Message 进行统一有效的管理，尽可能的简洁 Alert Message 的方式，在后面的项目开发过程中，将会有事半功倍的效果。

下面开始对 Alert Message 进行修改和设计。

为了达到每次修改 Message Content 而不用重新编译 Flex/Flash，我们将 Message 以 XML 的形式存在，而 Flex/Flash 要做的就是读取 message.xml，然后通过直接传入 Node String(‘error.richmediaplus.login’) 的方式，将相对应的 XML 信息体现在画面上。如果需要对 Message 进行相关的新增，修改，删除时，只对 message.xml 修改即可。

既然要用到 Node String ，就要在设计上与程序员有个统一的共识，目前认为『Message 分类』.『项目模块』.『详细信息』是比较好的选择之一。『Message 分类』可以对 Message 的性质进行统一管理，而且对其出现相应的 iconClass 进行统一设计。

『Message 分类』

• 注意（attention）
• 确认（question）
• 信息（info）
• 错误（error）

『项目模块』

• 注册模块（register）
• 登录模块（login）

注册模块（register）的『详细信息』

• 密码规则验证（passwordRule）
• 重复输入密码验证（passwordRepeatRule）

登录模块（login）的『详细信息』

• 密码错误（passwordWrong）

因此整个 message.xml 设计如下：

<?xml version="1.0" encoding="UTF-8"?>
<message>
	<title>Message Title</title>
	<info>
		<common>
			<test>这是替换字1: [0]，这是替换字2: [1]，这是替换字3: [2]</test>
		</common>
		<search>
			<resultNone>您所输入的关键字 [0] 查询不到相关信息！</resultNone>
		</search>
	</info>
	<attention>
		<register>
			<passwordRule>密码长度6～16个字符，字母区分大小写</passwordRule>
			<passwordRepeatRule>请重复输入一次相同的登录密码</passwordRepeatRule>
		</register>
	</attention>
	<question>
		<user>
			<del>确定删除帐号？</del>
		</user>
	</question>
	<error>
		<login>
			<passwordWrong>对不起，您的密码不正确! </passwordWrong>
		</login>
		<undefined>不明的错误原因。</undefined>
	</error>
</message>

XML 内容除了上面所说的『Message 分类』.『项目模块』.『详细信息』之外，还有个 title 的 NODE 和比较特殊的“[0][1][2]”等。一个项目的 Alert Message Title 一般来说比较固定，所以也可以设置在 XML 里，不用每次都要去敲，而比较特殊的“[0][1][2]”是 Message 内容的替代标识，适用于 Message 内容相同但主体不同的例子，如上面的 XML 的 info.search.resultNone 都是反应查询不到关键字的意思，但关键字每次可能不一样，我们可以及时对用户查询不到的关键字进行替换，而不用整个 Message 重新写过，只要传入相应的参数组合即可。

Alert Message 的形式

• 『OK』
• 『YES』『NO』
• 『YES』『NO』『CANCEL』

因此 AlertUtils 有 3 个 public static function

• AlertOKMsg
• AlertYesNoMsg
• AlertYesNoCancelMsg

3 个不同的方法，基本可以覆盖所有需要 Alert Message 的方式，他们对应的button 首选项也是不一样，如 AlertOKMsg 的 button 首选项是 Alert.OK，而 AlertYesNoMsg 的 button 首选项是 Alert.NO。

看看，到目前为止

Alert.show(text:String = "", title:String = "", flags:uint = 0x4, parent:Sprite = null, closeHandler:Function = null, iconClass:Class = null, defaultButtonFlag:uint = 0x4):Alert

分析一下，只剩下3个不确定的参数

• text
• parent
• closeHandler

其中 parent 一般默认为 Application，因此只剩下 text 和 closeHandler。

所以默认的 AlertUtils 相关 Alert Message 方法的参数设计为

//message 为 Message Node String，如'error.richmediaplus.login'。
//closeHandler 为 Alert Message 关闭的方法，默认为 null。
//parent 为 事件区域，默认为 Application。
//defaultButtonFlag 为 AlertUtils 对应方法的 button 首选项，如 AlertOKMsg 的默认 button 首选项是 Alert.OK，而 AlertYesNoMsg 的默认button 首选项是 Alert.NO。
//title 为 Alert Message Title，默认为 message.xml 中的 title。
//parameters 为可选参数数组，对相应的[0][1][2][3]...进行替换。
AlertUtils.AlertXXXMsg(message:String, closeHandler:Function = null, parent:Sprite = null, defaultButtonFlag:uint = Alert.NO, title:String = "", parameters:Array = null)

所以，当需要呼出密码规则不符的警告时，只需 AlertUtils.AlertOKMsg(“attention.register.passwordRule”)就可返回“密码长度6～16个字符，字母区分大小写”的信息；若关键字 richmediaplus 搜索不到相应信息，只需 AlertUtils.AlertOKMsg(“info.search.resultNone”, ['richmediaplus'])，就可以返回“您所输入的关键字richmediaplus查询不到相关信息！”

具体详见
AlertUtils Demo

AlertUtils Source

Related posts:

1. AlertUtils 更名为 AlertUtil
2. richmediaplus.controls.Pager
3. Create Trail Information & Expired Date in ActionScript3 & Flex

richmediaplus.controls.Pager 基于 Box 开发而成，用 Box 的好处除了省去排版的心思之外，可以利用 Box.direction 进行一些好玩的处理方式，因此 Pager 会根据 direction 进行横排或者竖排的样式。

整个分页系统由 richmediaplus.controls.Pager 和 richmediaplus.controls.pagerClasses.PagerItem 组成。Pager 掌握着整个分页的规则和设计，PagerItem 为『页』元素，但不包括前一页，后一页，最前页，最后页。整个开发习惯是为了配合由 『总页数』 count 和 当前『第 N 页』 currentPageIndex 的数据 组合成的数据，进行相应的处理。一般情况下，只需设置『总页数』 Pager.count 就可以使用，对 PagerEvent.PAGE_INDEX_CHANGED 进行监听就可以返回改变后的『页』元素的 pageIndex。当然，你可以自由得直接用 Pager.currentPageIndex 进行『页』元素的选择。

请注意，下面为几种特殊情况：

• 若 count 或 showCount 为 0 时，Pager 不显示。
• 若当前 count 为 10 条，当前选择的『页』元素为第 9 页，选择新的『页』元素第 10 页，若后台数据发生改变，count 返回为 8 条，那么选择的新『页』元素 currentPageIndex 越界（不包含小于 0 的情况），那么 Pager 自动会选择 『最后一页』，这种情况下是 DO NOT dispatch PagerEvent.PAGE_INDEX_CHANGED 事件的，这时候需要后台配合，在返回的同时，返回最后一页的数据，这样的话，就不用再去读取『最后一页』的数据了。

richmediaplus.controls.Pager Demo

richmediaplus.controls.Pager Source

Related posts:

1. richmediaplus.utils.AlertUtils
2. 基金凈值圖表(NetValueChart) & 基金績效圖表(PerformanceChart)
3. Create Trail Information & Expired Date in ActionScript3 & Flex

在線演示程序

No related posts.

More in ActionScript 3 TIFF Encoder in his blog.

JPGEncoder & PNGEncoder in as3corelib.

Related posts:

1. ActionScript and Flex optimization techniques and practices recommendation
2. richmediaplus.utils.AlertUtils
3. 將 Box2D Alchemy WCK 打包為 SWC 類別庫

TubeLoc 是 Ben Longoria 寫的一個AS2 YouTube Player API的AS3/Flex Proxy Library，你可以非常簡單容易的把Youtube Video加入到你的AS3/Adobe Flex/Adobe Air/AsWing工程當中，真正做到Nice Support！

• 支持目前最流行的AS3/Adobe Flex/Adobe Air/AsWing
• 包含了一個Flex Component(Movie.as)和一個基于Sprite的ActionScript3 Class(MovieSprite.as)
• 支持YouTube Chromeless Player 和 Full-Chrome Player
• 使用LocalConnection

具體請看：
TubeLoc in Google Code
TubeLoc in YouTube APIs and Tools 

Related posts:

1. YouTube Chromeless Player API 正式支持 ActionScript 3
2. 如何更新 Flash CS5.5 內建除錯 Player
3. 巢狀遮罩造成 Flash Player 死機的 Bug