RIAidea.com

AS3 Component: RichTextField

flashlizi@gmail.com(flashlizi) — Wed,25 Jun 2008 13:35:40 +0800

Just a very simple demo with some bugs, welcome any feedback (bug or suggestion).

Demo Update:06-27
like MSN or QQ, you can input any content with smileys and send to the output window.

Flash动画

在线播放

用FlashDevelop开发兼容Flash和Flex的纯AS库SWC组件

flashlizi@gmail.com(flashlizi) — Thu,22 May 2008 17:52:47 +0800

1、下载ExportSWC插件，解压到FD的Plugins目录，重启FD，在导航栏上会出现Export SWC的图标。
2、新建一个AS3的Default Project，在项目文件夹下会出现bin和src两个文件夹，删除src目录下Main.as。
3、打开project的properties面板，在classpaths里添加你想编译的as类库的目录。
4、在compiler options面板的Additional compiler options项里输入如下compc编译参数：
-namespace http://schemas.riaidea.com/as3lib/ manifest.xml -include-namespaces http://schemas.riaidea.com/as3lib/ -compute-digest=false
其中namespace和include-namespaces指定编译类库的命名空间，在这里你可以修改为你想要的命名空间。manifest.xml是你的as类库清单，它的具体写法请参看这里。
5、点击Export SWC的按钮，即会在bin目录下生成一个swc文件，至此大功告成。

Official Flash Player 10(Astro) Documentation

flashlizi@gmail.com(flashlizi) — Thu,22 May 2008 11:41:09 +0800

Download: Official Flash Player 10 Documentation
Extended read:
Flash Player 10 Drawing API

Google's Javascript Library and Doctype

flashlizi@gmail.com(flashlizi) — Thu,15 May 2008 11:10:30 +0800

对于web developer而言，google的技术绝对具有吸引力。今天google发布了一个叫goog的javascript库，而且还发起了一个叫Doctype的项目，goog也是其中的一部分。此项目旨在为开发者开发web应用提供一个百科全书式的参考。内容包括：web安全文章，Jvascript DOM控制，CSS技巧，DOM/HTML/CSS参考等。而“By web developers, for web developers”的理念，允许更多的开发者参与到这个项目中来，不断完善和发展。

WebORB:整合Flash/Flex与服务端的通讯平台

flashlizi@gmail.com(flashlizi) — Mon,28 Apr 2008 17:25:18 +0800

WebORB是一个免费的整合Flash/Flex与服务端(.NET/Java/Ruby/PHP)的通讯平台，它对AMF0，AMF3，RTMP，XML都有很好的支持。特别是.NET平台，推荐使用WebORB。

让timer事件不延迟第一次调度

flashlizi@gmail.com(flashlizi) — Wed,23 Apr 2008 15:25:49 +0800

一般启动Timer对象创建计时器后，都要经过Timer.delay的延迟后才会第一次调度timer事件。不过有些时候，我们想不经过delay就第一次调度timer事件，因此我们可以扩展Timer类来实现：

使用方法：

需要注意的是，不延迟第一次调度timer事件不会计入到计时器的总运行次数repeatCount的。即调度完第一次timer事件后，currentCount仍为0。

Flex SDK coding conventions and best practices

flashlizi@gmail.com(flashlizi) — Wed,16 Apr 2008 09:58:09 +0800

Adobe Open Source上发布的Flex SDK编程规范与实践。内容包括命名、编程惯用法、文件组织管理、代码格式、项目文档ASDoc等一系列的规范。致力于Flex/Flash开发的朋友都值得一看，这有助于你进行效率更高，可读性更好的开发。

URL: http://opensource.adobe.com/wiki/display/flexsdk/Coding+Conventions

再推荐一篇关于FMS3的文章：Dynamic stream switching with Flash Media Server 3

PHPQuery: A Simple AS3 Warper of AMFPHP

flashlizi@gmail.com(flashlizi) — Tue,25 Mar 2008 17:46:08 +0800

一个简单的amfphp封装，简化了amfphp的使用。
最新更新：增加getServices方法，返回所有可用的services方法集合的数组。需要在amfphp/services目录下增加ServiceUtils.php文件。PHPQuery和ServiceUtils在附件中均有下载。
使用示例：

PHPQuery源码：

package {    
    import flash.net.NetConnection;
    import flash.net.Responder;
    
    public class PHPQuery {
        
        private static var _gateway:String;
        private static var netConnection:NetConnection;
        
        //connect to specified amfphp gateway
        public static function connect(gateway:String):void {
            if (!netConnection) netConnection = new NetConnection();
            _gateway = gateway;
            netConnection.connect(gateway);
        }
        
        //call a php method.
        public static function call(command:String, onResult:Function, onFault:Function = null, ...args):void {
            var responder:Responder = new Responder(onResult, onFault);
            var params:Array = [command, responder].concat(args);
            netConnection.call.apply(null, params);
        }
        //get all services and theirs methods on amfphp
        public static function getServices(onResult:Function, onFault:Function = null):void {
            PHPQuery.call("ServiceUtils.getServices", function(result:Object) { onResult.call(null, listServices(result)); } , null);
        }
        //list all services's methods
        private static function listServices(result:Object):Array {
            var out:Array = [];
            for (var i:int = 0; i < result.length; i++) {
                var re:Object = result[i];
                if (re.children) {
                    var child:Array = listServices(re.children);
                    out = out.concat(child);
                }else {
                    for(var m:String in re.methods) {
                        var method:String = "";
                        if (re.data) {
                            method += re.data.replace( /\\/ , ".");
                        }
                        method += re.label + "." + m;
                        out.push(method);
                    }
                }
            }
            return out;
        }
        //get the amfphp gateway
        public static function get gateway():String {
            return _gateway;
        }
    }
}

点击下载PHPQuery和ServiceUtils文件

为你的ActionScript项目创建API文档

flashlizi@gmail.com(flashlizi) — Wed,19 Mar 2008 18:09:16 +0800

作为一个developer，写项目的API文档是非常重要的一件事情，flash developer也不例外。ASDoc能让我们快速创建ActionScript项目的API文档。

下面以一个实际的示例来说明如何创建API文档：

1)打开Adobe Flex 3 SDK Command Prompt。
2)用cd命令进入ActionScript项目的目录，如：cd D:\flashlizi\asdoc。
3)输入ASDoc命令：
asdoc -source-path . -window-title "ASDoc演示示例类" -package riaidea.asdoc "A Example of Using ASDoc" -doc-classes riaidea.utils.zip.ASDocExample
这是一个基本的asdoc命令。其中参数source-path表示as源文件目录，如果在当面目录则用点“.”来表示。window-title表示帮助文档的窗口标题，即浏览器窗口标题。package参数用来描述一个包，如这里描述包riaidea.asdoc为"A Example of Using ASDoc”。doc-classes用来指明需要生成API文档的类，如果指定的类中还引用了其他自定义类，那这些类也会生成API文档。
更详细的asdoc命令使用可以查看这里：http://livedocs.adobe.com/flex/3/html/index.html?content=asdoc_9.html
4)执行完毕后，在asdoc目录下会生成了一个asdoc-output目录，里面就是API文档。一般的，我们生成的API文档无需按26个字母分类，因此我们可以把里面的all-index-A.html到all-index-Z.html删除，并删除title-bar.html中的Index链接，这样的API文档就精简多了。

下面是本例中的类riaidea.utils.zip.ASDocExample的源码：

package riaidea.asdoc{
    
    import flash.display.Sprite;
    import flash.events.Event;
    
    /**
    * 当创建一个ASDocExample实例的时候调度init事件。
    * @eventType mx.events.FlexEvent.BUTTON_DOWN
    */
    [Event(name="init", type="flash.events.Event")]
    /**
     * ASDoc演示类。此例演示了如何写注释才能创建一个基本的AS项目的API文档。
     * @example
     * <listing version="3.0">
     * var eg:ASDocExample=new ASDocExample();
     * eg.print("ASDoc演示类");
     * eg.test("flashlizi");
     * </listing>
     * @see <a href="http://www.riaidea.com" target="_blank">http://www.riaidea.com</a>
     */

public class ASDocExample extends Sprite {
        
        /**
         * 实例的创建者。
         * @default flashlizi
         */
        public var creator:String;
        private var _date:Date;
        /**
         * 构造函数-constructor。
         */
        public function ASDocExample() {
            this.creator = "flashlizi";
            this._date = new Date();
            dispatchEvent(new Event(Event.INIT));
        }
        /**
         *    打印参数指定内容。
         * @param    content 要打印的内容。
         */
        public function print(content:String):void {
            trace(content);
        }
        /**
         * 测试类的创建者是否与参数指定名称相同。
         * @param    name 测试指定的名称。
         * @return    创建者与指定名称相同返回true，否则返回false。
         */
        public function test(name:String):Boolean {
            return name == creator;
        }
        /**
         * 实例的创建时间。
         */
        public function get date():Date {
            return date || new Date();
        }
        public function set date(value:Date):void {
            _date = value;
        }
    }
}

现在来说明一下如果写类的注释才能创建一个比较完善的API文档。

1）首先，只有包含在/**与*/之间的注释才能被asdoc识别。对一个类的方法或者属性做注释，只要在之前加上这样的注释就可以了。
2）注释的第一行开始（不包括注释标记）是被注释对象（方法、属性等）的说明介绍。当出现@param 这样的注释标记的时候，asdoc就会自动解析为相应的内容。
3）本例ASDocExample中包含了一些常用的asdoc标记：
a、eventType。只能用于注释Event元标记，如[Event(name="init", type="flash.events.Event")]。这样在API文档中这个事件会出现这个类的Event说明块中。
b、example。用于创建一个示例。示例代码需写在< listing >和< /listing >之间。
c、see。用于创建“另请参见”说明块。
d、default。用于创建属性的“默认值”说明。
e、param。用于创建对方法的参数的说明。
f、return。用于创建对方法的返回值的说明。
g、private。使用此标记的方法或属性将不会输出到API文档中。

更多的asdoc标记请参看：http://livedocs.adobe.com/flex/3/html/help.html?content=asdoc_6.html#186140

下载本例的所有源文件： ASDocExample

Batch convert files to Flashpaper2

flashlizi@gmail.com(flashlizi) — Tue,18 Mar 2008 11:50:11 +0800

Command:
FlashPrinter.exe {PATH TO DOCUMENT} -o {OUTPUT PATH & FILE with SWF extention}
Example:
FlashPrinter.exe riaidea.doc -o riaidea.swf