Facebook Flash Application開發心得(3) - 由Flash Api從Facebook取得資料

當最煩人的session問題解決之後，就該試著跟Facebook要點資料來瞧瞧了。
這一篇會大概解說一下Flash api如何跟Facebook索取資料的動作。
基本上Facebook Flash api在這方面的流程很簡單，其實就是先產生一個「命令」然後把這個命令丟給Facebook類別往外post出去就好，要做什麼動作就去產生相對應的命令類別就可以了。
所有的命令類別都繼承com.facebook.net.FacebookCall，有興趣的人可以直接去說明文件看這個類別，它就有列出所有它的子類了。
說明文件在這邊：
http://facebook-actionscript-api.googlecode.com/svn/release/current/docs/index.html
幾乎所有的命令類別都是在com.facebook.command的package裡。

相對於發出命令的簡易，Facebook Flash api在接收資料時的繁複卻是不可思議到讓人惱怒。有時一個命令發出後，收到的資料型別居然要層層解析，動輒用到四五個類別，再加上說明文件的陽春，所以往往需要不斷的一直trace，最後才能得到你想要的資料。
這個部份待會的code就會見識到…。

接下來，我們繼續接著上一篇的去修改，Html的部份就不用動了，這次沒動到javascript，所以只改ActionScript。
我們這次要從Facebook取得自己的個人資料，因此在上次的connectHandler裡驗證成功後馬上執行這個動作：
使用到的是com.facebook.commands.users.GetInfo;這個類別。

<br /> //需要import這兩個類別<br /> import com.facebook.commands.users.GetInfo;<br /> import com.facebook.data.users.GetInfoFieldValues;<br /> <br /> private function connectHandler(e:FacebookEvent):void {<br /> trace(e);<br /> if (e.success) {<br /> trace("驗證成功");<br /> //加入這一行，進行取得資料的動作<br /> getMyInfo();<br /> }<br /> }<br /> <br /> private function getMyInfo():void {<br /> //產生一個命令的instance<br /> //GetInfo是取得某人(可多人)的某些欄位資料(可指定欄位)<br /> //我這裡是取得自己的所有欄位資料<br /> var _call:GetInfo = new GetInfo([_uid], GetInfoFieldValues.ALL_VALUES);<br /> //監聽FacebookEvent.COMPLETE事件<br /> _call.addEventListener(FacebookEvent.COMPLETE, infoCompleteHandler);<br /> //把instance交給Facebook類別往外丟出去<br /> _facebook.post(_call);<br /> }<br />

GetInfo這個類別是用來跟Facebook索取會員資料用的，它可以允許一次索取很多人的，因此第一個參數是會員uid組成的Array。然後也可以指定要索取哪一些欄位，這些欄位的定義都在GetInfoFieldValues這個類別裡的靜態屬性，一樣是Array的形式，如果你要索取所有的欄位，那就直接帶入GetInfoFieldValues.ALL_VALUES就好，它本身就是一個Array型態。

接下來就是要處理事件回傳的結果：

<br /> //需要import這三個類別<br /> import com.facebook.data.users.GetInfoData;<br /> import com.facebook.data.users.FacebookUserCollection;<br /> import com.facebook.data.users.FacebookUser;<br /> <br /> private function infoCompleteHandler(e:FacebookEvent):void {<br /> //可藉由trace(e)來觀察每個呼叫的回傳資料狀態<br /> trace(e);<br /> //如果e.success且e.data有值的話, 解析資料<br /> if (e.success && e.data != null) {<br /> //因為可以一次取得很多人的資料<br /> //所以資料可能是多筆<br /> //我這邊將它轉成Array<br /> var _userArray:Array = GetInfoData(e.data).userCollection.toArray();<br /> //in this case, 人數一定是1<br /> trace("人數 = " + _userArray.length);<br /> //將自己的資料取出<br /> var _my:FacebookUser = FacebookUser(_userArray[0]);<br /> //打上自己的名字<br /> name_txt.text = "Hello! " + _my.name;<br /> <br /> //把自己的大頭照load進來<br /> var _ldr:Loader = new Loader();<br /> _ldr.load(new URLRequest(_my.pic));<br /> _ldr.x = 5;<br /> _ldr.y = 30;<br /> this.addChild(_ldr);<br /> }<br /> }<br />

開發Facebook application時，一直trace回傳的FacebookEvent會是一個好習慣…。FacebookEvent的形態基本上會是這樣：
[FacebookEvent type="complete" success=true data=[object GetInfoData] error=null]
type就不用講了，要注意的是success及data。
success就只有true或false，通常都是true，除非你跟Facebook之間的connection斷了，那success就會是false然後error會有東西。
data則是主要的資料，data會依照你命令的種類不同而有不同的資料型態，理論上命令的類別都是在com.facebook.command.xxxx的package裡，相對應的資料型態類別則會放在com.facebook.data.xxxx的package裡。
也就是送出命令時是去command裡找，接收到事件時就回來data這邊找。

這次的命令是com.facebook.command.users.GetInfo，收到的資料是com.facebook.data.users.GetInfoData。
但是其實討人厭的就在這邊，光一個GetInfoData還不夠，真的資料是存在GetInfoData類別裡的userCollection屬性 (com.facebook.data.users.FacebookUserCollection類別)，所以只好不斷的轉型別把它轉成陣列，最後陣列裡儲存的是一個一個的com.facebook.data.users.FacebookUser型別的資料…。
因此光解析個人資料就要動用三個型別… 加上發出命令的類別的話一共是五個，老實說，說明文件夠好的話這都還ok，偏偏不是，所以開發Facebook application的話一直trace會是一個好習慣。
當熟悉它的運作方式後，十分建議自己寫一些類別來整合簡化這些步驟。


如果沒意外的話，當登入後就可以看到自己的名字跟照片顯示在畫面上了。

下一篇
Facebook Flash Application開發心得(4) – Iframe的架構下取得Session