Facebook絕對開發Part1

2010 08 19補充說明：
現在FB已經改版了
所以這樣的方法已經不適用了喔
分享一下最近開發FB App的心得,
大至上分成三種情況
1：本機應用程式開發。如 AIR 應用程式
2：IFrame架構。就是網站的框是FB的樣式, 網址也是FB的。然後一進去應用程式就一定必需要是會員並同意連線。
3：Connect架構。網址是自已的，只是去連線要FB的資訊。
在這兒先分享使用Connect教學,
Step1：申請應用程式

先到http://www.facebook.com/developers/
右邊有個

按下後，開始填些基本資料

應用程式名稱：這只是一個標題，跟設定沒有什麼關系。
完後成，左邊的選單，切換到聯外通(Connect) 表籤,

而右邊的欄位, 也只需要在聯外通網址打上你真正的網址路徑, 在開發的過程中
我是在自己的電腦架構虛擬網域(Win7或是Win Server都可以, 但XP就沒這功能), 等測試完成
再來更改這個欄位，填上正式網址。

按下完成後
可以看到屬於自己的APP設定頁面, 記下API Key 和 Secret Key, 待會開發時會用的到。

FB的APP程式, 有二個圖片可以放置，Icon就是小圖, 當使用者加入書籤時會出現。
Logo就是大圖片，當使用者第一次要跟你的APP連線時, 這張圖片就會出現在上面。

Step2：使用Flash來開發
開發的程式有很多種可以選用，在這先使用最熟悉的Flash來開發。
下載Facebook AS3 API類別
http://code.google.com/p/facebook-actionscript-api/
官方有提供不錯的Example教學。
在開始寫程式之前，先來了解一下需求與流程。
在這兒奶老師的需求就是先進入網站，然後有一個按鈕用來觸發跟FB連線
這時會另開一個視窗，連到FB的網站，讓使用者輸入帳密，及同意該APP連線你的個人資訊。
完成連線後，就可以使用FB提供的類別, 來得到你想要的資訊，在這兒我們先得到個人資訊。
在Flash FB類別裡，
使用FacebookSessionUtil、JSSession或是WebSession來跟FB做連線
三種各有不同的使用時機點
在這兒我們先使用FacebookSessionUtil來做連線的選擇, 之後再來分悉這三種的優缺點。
宣告FacebookSessionUtil類別, 並把API Key 、 Secert Key及stage的loaderInfo帶入

fbSession = new FacebookSessionUtil("API_KEY", "SECRET_KEY", stage.loaderInfo);

偵聽等待事件和連線成功事件, 同時把Session裡的facebook屬性存出來，
因為連線成功後, Session類別的任務就差不多，接下來要其他資訊的工作都是Facebook這個類別來處理。

fbSession.addEventListener(FacebookEvent.WAITING_FOR_LOGIN, _waitingForLoginHandler);
fbSession.addEventListener(FacebookEvent.CONNECT, _fbSessionConnectHandler); 
fbook = fbSession.facebook;

在等待的過程中，跳一個Alert來告訴使用者, 登入FB後，再回來點擊一次, 好讓Flash再觸發一次驗證的程式。

private function _waitingForLoginHandler(e:FacebookEvent):void {
var _alert:Alert = Alert.show("Click OK when you've logged in", "Logging into Facebook");
_alert.addEventListener(Event.CLOSE, doClose);  
}
private function doClose(e:Event):void {    
fbSession.validateLogin();
//當使用者關掉該 Alert 時，檢查是否登入成功, 是的話，FacebookEvent.CONNECT事件就會發生。
//接著就可以開始要資料。
}

連線成功後，就可以開始要個人資訊。
所以跟fb資料有關的類別，就是放在 com.facebook.commands 類別包裡。
透過 Facebook 類別實體的 post方法, 送出去要資料回來。
個人資訊使用 GetInfo 類別,
參數1：把建立好的 uid 送過去(這個很重要, facebook是透過這個uid來判斷的)
參數2：要取得那些個人資訊, 在這是一個靜態常數, 你可以只要選擇部份資料即可, 在該範例我是取得全部

var _call:FacebookCall = fbook.post(new GetInfo([ fbook.uid ],  GetInfoFieldValues.ALL_VALUES ));
//一樣偵聽 Complete 事件。
_call.addEventListener(FacebookEvent.COMPLETE, _fbGetInfoHandler);
private function _fbGetInfoHandler(e:FacebookEvent):void {      
//資料是否成功取得, 可透過  e.success 或是 e.error來判斷
if (e.error){ 
status.text = "getInfo Error" + e.error.errorMsg;
//如果有錯誤, 就把訊息跳出來。
return;
}        
//將 e.data 轉型成真正的型別, 方便我們存取。
var _infoData :GetInfoData = GetInfoData(e.data);          
//因為 GetInfoData 是一個集合, 個人的資訊是在第一筆, 使用 getItemAt(0);
var _fbUser  :FacebookUser = FacebookUser (_infoData.userCollection.getItemAt(0));   
if (_fbUser) {
userImage.source = _fbUser.pic_big;   
userName.text = "Hello " + _fbUser.name + " " + _fbUser.last_name;    
}    
}

這樣就完成了。
這樣的連線方法，每次使用者一進入網站，都就要一下登入，然後另開視窗，然後再同意連線
假設使用者己經是登入的情況且同意過這個APP，還是要再做一次驗證，相當的不友善。
下一篇再來分享結合JS，使用WebSession來決解這個問題。
SourceCodeDownload