Facebook ActionScript Graph API ( 4 ) Dialogs

這一篇簡直是在考驗debug與找solution的功力！Dialog是用來彈出對話框，讓user與其互動，例如發布post到塗鴉牆，或是彈出extended permissions讓user同意等。因為user必須與其互動(按下同意按鈕之類)才會有反應，所以不需要特別的permission。例如不需要publish_stream權限也可以使用Feed Dialog去發post。目前文件裡面列出三種Dialog可用：Feed Dialog、Friends Dialog以及OAuth Dialog。而在這個API是使用Facebook.ui()來呼叫。很不幸的，這個method雖然可以正常呼叫，不過有點小bug，就是callback function無法正常呼叫，詳情見這篇。

修正Source Code與SWC
幸好，上面那篇也有提到修正方法，使用Source Code的人，只要修正兩個地方：第一，打開com.facebook.graph.Facebook.as，在第612行那邊加入一行：

data.method = method;
data.funName = method;//只要加這行
if (callback != null) {

第二，打開com.facebook.graph.core.FacebookJSBridge.as，將第118行最後面的obj.method改為obj.funName，改完後變成：

obj = FB.JSON.parse( params );
cb = function( response ) { FBAS.getSwf().uiResponse( FB.JSON.stringify( response ), obj.funName ); }//改這行最後的obj.funName
FB.ui( obj, cb );

這樣Source Code就改完了。如果使用SWC的，就把它轉成SWC吧。如果嫌麻煩，可以下載我改過的。

Facebook.ui()：
接著就來看這個method。它有四個參數，第一個就是要呼叫的dialog名稱，例如feed。第二個參數就是呼叫時要傳送的data，就丟入一個Object，第三個就是callback function，第四個是顯示的方式，web版可以用page、iframe或popup。page是整頁轉過去，通常不會用；iframe就是在頁面上疊一個lightbox，我發現現在即使flash的wmode設為window它也可以正常疊在flash上面，不確定是新版flash player才可以還是怎樣；比較保險的做法就用popup彈出視窗來了。接著我們就來試一下Feed Dialog與OAuth Dialog，Friends Dialog我不知道用在哪種情況比較好，就先不管它了。

Feed Dialog
寫到這我已經沒耐性加太多介面了，就加個btnFeed Button，Click後執行固定的程式：

var data:Object = new Object();
data.link = "http://developers.facebook.com/docs/reference/dialogs/";
data.picture="http://fbrell.com/f8.jpg"
data.name = "這是name";
data.caption = "這是caption";
data.description = "這是description";
data.message = "這是message";
Facebook.ui("feed", data, requestHandler, "popup");

data可以指定哪些參數可以參考Feed Dialog的文件。另外callback function只會回傳一個Object參數，因此我們小改一下requestHandler：

private function requestHandler(result:Object, fail:Object = null):void 

讓第二個參數預設為null，這樣就可以通用了。這是我這邊偷懶，實際上我們當然會另外寫個function去處理。測試一下，如果點選"發佈"的話，可以看到result會回傳post_id；如果點選取消就不會有反應。

OAuth Dialog
這個Dialog的用處是登入時我們先要求幾個基本的extended permissions，等到有需要時，我們再跟user進一步去要求更多的permission，這樣可以避免user一開始看到一長串的permission要允許就卻步了。依照OAuth Dialog的文件，只要Facebook.ui()的第一個參數設為oauth，第二個參數data給他個屬性scope，值就是我們想要user與許的permission，以逗號隔開。但實測之後這樣完全沒用！即使不透過as，直接呼叫那網址也沒用。後來看到文件裡面有個Click here，有個測試頁，從那測試頁的網址發現，第一個參數必須傳permissions.request，第二個參數data必須設定perms屬性，這樣就可以了！！這個不知道以後Facebook會不會更正，請小心使用。我們就直接加個btnOAuth，Click後執行：

var data:Object = new Object();
data.perms = "email, read_friendlists, read_mailbox";
Facebook.ui("permissions.request", data, requestHandler, "popup");

這裡我們隨便設定幾個login時沒有允許的permission來測試。當彈出Dialog時點選同意或不允許，都會回傳session的資訊，差別我們可以從result.perms來查看，裡面會有我們要求的permission裡面，user有允許的permission。在實際應用上，我們可能希望先知道user有沒有與許過某個權限，如果有，就直接執行某功能，否則就先彈出OAuth Dialog，user同意後再進行該功能。雖然FacebookSession有個availablePermissions疑似可以用，不過實測之後一直都是null。我們可以自己來做這個功能，呼叫FQL查詢：
SELECT publish_stream,email FROM permissions WHERE uid = me()
欄位就把我們App.裡所有可能有的permission丟進去。回傳時那些欄位值等於1的就是有允許過的permission，把這些資訊儲存下來。每次要允許權限前就先查這個儲存下來的內容，而每次允許了新權限後再去更新這個內容，就可以了！

以上，應該已經把這套API重要的功能介紹完了，其他大概只有在使用IFrame App.時，可以使用Facebook.setCanvasAutoResize()與Facebook.setCanvasSize()可以設定IFrame的大小，對App.內容比較長時就可以試著用看看囉。結束！

上一篇文章：Facebook ActionScript Graph API ( 3 ) FQL、Old REST API以及picture