AS3 Class 簡易FaceBook連線授權與發文 API

前一陣子自己作了一些臉書的flash社群遊戲,使用了官方建議的AS3 API,但是使用後總覺得相當不順手,bug又多,反倒是javascript提供的api,功能比較完整,又好用....所以乾脆自己用js的api打包在as3裡面,感覺整個速度也快很多(我是用js來呼叫Graph API)

目前主要提供四個比較常用的功能

1. 登入授權,順便取得一些發文的授權
2. 取回user的詳細資料,名子呀,生日呀.....等等
3. 取回好友的uid跟name
4. 自動發文到你的塗鴉板

雖然不多,但是如果只是要應用臉書的好友串聯功能,已經差不多夠用了,反正如果要用其他的Graph API功能,access_token都在cookies裡面,可以在自己拿去用...

API 與 說明文件 範例下載

雖然文件都有說明,還是大概說一下功能與要注意的地方

首先當然要取得一個自己的api_key
請到這裡來申請

之後你會取得一個api key

下載我所提供的Class
把Cain_fb_api.swc跟你的fla放在同一層資料夾

再來是html有幾個地方要注意

一定要先嵌入這個js,因為終究我的api是透過js api來操作

另外body裡面請放入這個div, js api會用到fb-root這個id

flash外掛的allowScriptAccess屬性請設always....這應該不用解釋了,不然swf沒辦法呼叫js
且它的id與name屬性記得都要設定,且要一樣

好了之後終於可以開始進入as部分了,先把class匯入

import Cain.fb.event.*;
import Cain.fb.*;



API初始化 api key請填上自己去申請的
var fb:Fb_API = new Fb_API("xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx");


進行認證
fb.login();
認證完會觸發Fb_API.onLOGIN事件
fb.addEventListener(Fb_API.onLOGIN, onFB_LOGIN);
觸發後如果fb.data的值是true代表授權成功,使用者登入,這時候access_token已經在cookies裡面了,之後要下什麼Graph API請隨意

如果要取得自己的資料請下
fb.getUser();
取得後觸發GetUserEvent.RESPONSE事件

fb.addEventListener(GetUserEvent.RESPONSE, onGetUser);
回傳的事件裡面有個user物件,所有資料都在裡面
如果你要名子,可以用user.name取得(其他的請自己看說明文件User 的屬性)

如果要取得朋友列表
fb.getFriends();
取得後觸發GetFriendsEvent.RESPONSE事件

fb.addEventListener(GetFriendsEvent.RESPONSE, onGetFriends);

回傳的事件裡面有個data陣列,你可以依序取出,每一欄是一個Object

裡面有name跟uid屬性,就是朋友的名子與她的uid

ps.理論上如果要取得朋友的詳細資料可以下fb.getUser(它的uid)
不過有時候可能沒有經過允許有時會取不到..


訊息發布
fb.publishStream(new PublishMessage("要發布的訊息"));
發布後觸發PublishStreamEvent.RESPONSE事件
fb.addEventListener(PublishStreamEvent.RESPONSE, onPublishStream);
回傳的事件有個success屬性,代表發文成功與否
如果發文成功,還會有個id屬性,就是這篇文章的id

目前僅需要這先些功能,估計以後會再增加