{"id":943,"date":"2010-04-01T16:54:48","date_gmt":"2010-04-01T15:54:48","guid":{"rendered":"http:\/\/alittleb.it\/?p=943"},"modified":"2010-04-02T08:59:33","modified_gmt":"2010-04-02T07:59:33","slug":"consigli-di-programmazione-per-la-tua-applicazione-facebook","status":"publish","type":"post","link":"https:\/\/www.alittleb.it\/it\/actionscript-it\/consigli-di-programmazione-per-la-tua-applicazione-facebook\/","title":{"rendered":"Consigli di Programmazione per la tua applicazione Facebook"},"content":{"rendered":"

L’articolo \u00e8 disponibile solo in inglese, ci scusiamo per il disagio.<\/p>\n

\n

Today we would like to spend some time talking about our experience developing a simple Flash game for Facebook and share some useful tips with you.
\nObviously, the first thing you need is an idea…if you want your application to became famous going social you got to stop thinking like a developer and start thinking like a facebook user.
\n
\nIndividual preferences on what kind of game a person would like to play are not as relevant as the fact your game has to have a large social component.
\nThe player is primarily a social network user and secondarily a game player; he’s using your application because he decided to join Facebook to keep in contact with friends, coworkers, relatives and share contents with them.<\/p>\n

Take your time and find a funny way to entertain users giving them the chance to interact with the others, telling they’re having fun playing your game and inviting friends to do the same. This way your game will spread.<\/p>\n

If you have decided to use Flex as development platform, keep reading, otherwise go here<\/a> and choose yours.
\nYou can download here<\/a> the official API Libraries which are fully supported by Facebook and Adobe.
\nIf you use SVN you can check them out from this repository<\/a>.
\nIt comes with some useful example projects.
\nAlso the Adobe website<\/a> has some useful resoursces.<\/p>\n

Now you have to set up your brand new application, going here: http:\/\/www.facebook.com\/developers\/<\/a><\/p>\n

Once you joined the developers group and registered your application, to start testing from Flex you’d like set the “Application Type” as Desktop, so the debugging process will be easier.<\/p>\n

\"\"<\/p>\n

When your application is finished, you’ll decide to use IFrame or Fbml, for now let’s see how Fbml works.
\nLeave the Canvar Callback Url’s field empty, it will be read as “localhost”.<\/p>\n

\"\"<\/p>\n

First step: Log In from your application<\/strong><\/p>\n

Create a New Flex Project and import the Facebook SWC Library ( http:\/\/facebook-actionscript-api.googlecode.com\/files\/Facebook_library_v3.4_flash.swc ).<\/p>\n

\"\"<\/p>\n

Then try this snippet, provided by Adobe, replacing “xxxx” with your Application Secret and API Key (they’re stored in Your Application’s Home Page):<\/p>\n

\n\n
import<\/span> com.<\/span>facebook.<\/span>Facebook;<\/span>
\nimport<\/span> com.<\/span>facebook.<\/span>events.<\/span>FacebookEvent;<\/span>
\n
\nprivate<\/span> var<\/span> _book:<\/span>Facebook;<\/span>
\nprivate<\/span> var<\/span> _session:<\/span>FacebookSessionUtil;<\/span>
\n
\nprivate<\/span> var<\/span> API_KEY:<\/span>String<\/span><\/a> = "xxxx"<\/span>;<\/span>
\nprivate<\/span> var<\/span> SECRET_KEY:<\/span>String<\/span><\/a> = "xxxx"<\/span>;<\/span>
\n
\nprivate<\/span> function<\/span> init<\/span>(<\/span>)<\/span>:<\/span>void<\/span> {<\/span>
\n    \/\/create a new Facebook Session<\/span>
\n    _session=new<\/span> FacebookSessionUtil(<\/span>API_KEY,<\/span> SECRET_KEY,<\/span> loaderInfo<\/span>)<\/span>;<\/span>
\n    \/\/add listener for the connection complete<\/span>
\n    _session.<\/span>addEventListener<\/span>(<\/span>FacebookEvent.<\/span>CONNECT<\/span>,<\/span> onConnect)<\/span>;<\/span>
\n    \/\/connect<\/span>
\n    _fbook=_session.<\/span>facebook;<\/span>
\n    }<\/span>
\n
\nprivate<\/span> function<\/span> onConnect(<\/span>e:<\/span>FacebookEvent)<\/span>:<\/span>void<\/span> {<\/span>
\n    \/\/you're logged in!<\/span>
\n    trace<\/span>(<\/span>"Facebook API Ready"<\/span>)<\/span>;<\/span>
\n    }<\/span>
\n
\nprivate<\/span> function<\/span> doneLoggingIn(<\/span>)<\/span>:<\/span>void<\/span> {<\/span>
\n    \/\/validate session<\/span>
\n    _session.<\/span>validateLogin(<\/span>)<\/span>;<\/span>
\n    }<\/span><\/div><\/div>\n\n<\/pre>\n
You can find your app information in its facebook profile:<\/p>\n
\"\"<\/p>\n
A pop-up should open and ask you to log in, if you haven\u2019t already logged in.<\/p>\n
Now that you’re logged in, you might be interested in knowing how to retrieve users’ data.
\nThere are several ways to access users information: the most common are API methods and FQL queries.
\nI personally prefer the latter, since I reckon it is considerably faster.
\nIt’s because you can use specific requests to get just the data you need. In fact most of the methods implemented by the API Libraries are generally wrappers for FQL Queries.
\nFQL allows you to use a SQL-style interface to construct queries that returns data stored in these tables<\/a>.
\nIf you’re not familiar with SQL language here you can find detailed information about creating Fql queries<\/a>.<\/p>\n
Here’s an example that shows how to retrieve friends’ Uids, first name and last name from logged user’s Uid:<\/p>\n
\n\n
import<\/span> com.<\/span>facebook.<\/span>Facebook;<\/span>
\nimport<\/span> com.<\/span>facebook.<\/span>commands.<\/span>fql.<\/span>FqlQuery;<\/span>
\nimport<\/span> com.<\/span>facebook.<\/span>data<\/span>.<\/span>FacebookData;<\/span>
\nimport<\/span> com.<\/span>facebook.<\/span>events.<\/span>FacebookEvent;<\/span>
\nimport<\/span> com.<\/span>facebook.<\/span>net.<\/span>FacebookCall;<\/span>
\nimport<\/span> com.<\/span>facebook.<\/span>utils.<\/span>FacebookSessionUtil;<\/span>
\n
\nprivate<\/span> var<\/span> _fbook:<\/span>Facebook;<\/span>
\nprivate<\/span> var<\/span> _session:<\/span>FacebookSessionUtil;<\/span>
\n
\nprivate<\/span> var<\/span> API_KEY:<\/span>String<\/span><\/a> = "xxxx"<\/span>;<\/span>
\nprivate<\/span> var<\/span> SECRET_KEY:<\/span>String<\/span><\/a> = "xxxx"<\/span>;<\/span>
\n
\nprivate<\/span> function<\/span> init<\/span>(<\/span>)<\/span>:<\/span>void<\/span> {<\/span>
\n    _session=new<\/span> FacebookSessionUtil(<\/span>API_KEY,<\/span> SECRET_KEY,<\/span> loaderInfo<\/span>)<\/span>;<\/span>
\n    _session.<\/span>addEventListener<\/span>(<\/span>FacebookEvent.<\/span>CONNECT<\/span>,<\/span> onConnect)<\/span>;<\/span>
\n    _fbook=session.<\/span>facebook;<\/span>
\n}<\/span>
\n
\nprivate<\/span> function<\/span> doneLoggingIn(<\/span>)<\/span>:<\/span>void<\/span> {<\/span>
\n    session.<\/span>validateLogin(<\/span>)<\/span>;<\/span>
\n}<\/span>
\n
\nprivate<\/span> function<\/span> onConnected(<\/span>e:<\/span>FacebookEvent)<\/span>:<\/span>void<\/span>{<\/span>
\n    _session.<\/span>removeEventListener<\/span>(<\/span>FacebookEvent.<\/span>CONNECT<\/span>,<\/span> onConnected)<\/span>;<\/span>
\n    trace<\/span>(<\/span>"Facebook API Ready"<\/span>)<\/span>;<\/span>
\n    if<\/span>(<\/span>e.<\/span>error<\/span>)<\/span>{<\/span>
\n        \/\/ catch errors<\/span>
\n        trace<\/span>(<\/span>"ERROR:"<\/span>  +<\/span>  e.<\/span>error<\/span>.<\/span>errorMsg +<\/span> e.<\/span>error<\/span>.<\/span>errorCode)<\/span>;<\/span>
\n    }<\/span>else<\/span>{<\/span>
\n        var<\/span> _loggedUserUid:<\/span> Int = _fbook.<\/span>uid )<\/span>;<\/span> \/\/ save logged user's IUD necessary to do the query<\/span>
\n        \/\/create an Fql Multiquery using user (http:\/\/wiki.developers.facebook.com\/index.php\/User_%28FQL%29)<\/span>
\n        \/\/and friend (http:\/\/wiki.developers.facebook.com\/index.php\/Friend_%28FQL%29) tables<\/span>
\n        var<\/span> query:<\/span> String<\/span><\/a> =  "SELECT uid, first_name, last_name FROM user WHERE uid IN (SELECT uid2 FROM friend WHERE uid1 = "<\/span> +<\/span> _loggedUserUid +<\/span> ")"<\/span>;<\/span>
\n        \/\/create a FacebookCall and use post method to do a query to Facebook server<\/span>
\n        var<\/span> fbquery:<\/span>FacebookCall =  _fbook.<\/span>post(<\/span>new<\/span> FqlQuery(<\/span>query)<\/span>)<\/span>;<\/span>
\n        \/\/add a listener for the event complete<\/span>
\n        fbquery.<\/span>addEventListener<\/span>(<\/span>FacebookEvent.<\/span>COMPLETE<\/span>,<\/span> onGetData)<\/span>;<\/span>
\n    }<\/span>
\n
\n}<\/span>
\n
\nprivate<\/span> function<\/span> onGetData(<\/span>e:<\/span>FacebookEvent)<\/span>:<\/span>void<\/span>{<\/span>
\n    if<\/span>(<\/span>e.<\/span>success)<\/span>{<\/span>
\n        \/\/save your data as FacebookData<\/span>
\n        var<\/span> data<\/span>:<\/span>FacebookData = e.<\/span>data<\/span>;<\/span>
\n        \/\/and store your query result as XML<\/span>
\n        var<\/span> result:<\/span>XML<\/span><\/a> = new<\/span> XML<\/span><\/a>(<\/span>data<\/span>.<\/span>rawResult)<\/span>;<\/span>
\n        \/\/now you can parse your XML how you're used to do<\/span>
\n    }<\/span>else<\/span>{<\/span>
\n        \/\/ catch errors<\/span>
\n        trace<\/span>(<\/span>"ERROR:"<\/span>  +<\/span>  e.<\/span>error<\/span>.<\/span>errorCode +<\/span> e.<\/span>error<\/span>.<\/span>errorMsg)<\/span>;<\/span>
\n    }<\/span>
\n}<\/span><\/div><\/div>\n\n<\/pre>\n
Yeah, you know who you (and your friends) are!
\nAnother useful tip to create a viral application is to let users post messages to walls ( their own or their friends’), but we’ll discuss this topic in a future post<\/a>.
\nFor my application I decided not to use a html button to open “Invite Friends page”, I prefer having a flash button embedded in the swf.\u00a0In order to make it work I had to link it to a simple PHP script via ActionScript.<\/p>\n
\n\n
require_frame(<\/span>)<\/span>;<\/span>
\n$user<\/span> =<\/span> $facebook<\/span>-><\/span>require_login<\/span>(<\/span>)<\/span>;<\/span>
\n
\n    \/\/ Prepare the invitation text that all invited users will receive.<\/span>
\n    $content<\/span> =<\/span>
\n            "  write something <a href="<\/span>">"<\/span>.<\/span>$app_name<\/span>.<\/span>"<\/a>.\\n<\/span>"<\/span>.<\/span>
\n            "get_add_url()."<\/span>" label="<\/span>Get Stats Now"\/>"<\/span>;<\/span>
\n
\n?><\/span><\/div><\/div>\n\n<\/pre>\n
This is the AS3 code for the button:<\/p>\n
\n\n
inviteBtn.<\/span>addEventListener<\/span>(<\/span>MouseEvent<\/span><\/a>.<\/span>Click,<\/span> invite)<\/span>;<\/span>
\n
\nprivate<\/span> function<\/span> invite(<\/span>e:<\/span>MouseEvent<\/span><\/a>)<\/span>:<\/span>void<\/span>{<\/span>
\n    \/\/the url where php script is stored<\/span>
\n    var<\/span> url<\/span>:<\/span>String<\/span><\/a> = "www.yoursite.com\/invite.php"<\/span>;<\/span>
\n    \/\/create a URLRequest and use navigateToURL to link the page<\/span>
\n    var<\/span> request:<\/span>URLRequest<\/span><\/a> = new<\/span> URLRequest<\/span><\/a>(<\/span>url<\/span>)<\/span>;<\/span>
\n    navigateToURL<\/span>(<\/span>request)<\/span>;<\/span>
\n}<\/span><\/div><\/div>\n\n<\/pre>\n","protected":false},"excerpt":{"rendered":"
L’articolo \u00e8 disponibile solo in inglese, ci scusiamo per il disagio. Today we would like to spend some time talking about our experience developing a simple Flash game for Facebook […]<\/p>\n
Read More<\/a><\/p>","protected":false},"author":9,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"content-type":"","_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"footnotes":""},"categories":[79,81,80],"tags":[],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/www.alittleb.it\/it\/wp-json\/wp\/v2\/posts\/943"}],"collection":[{"href":"https:\/\/www.alittleb.it\/it\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.alittleb.it\/it\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.alittleb.it\/it\/wp-json\/wp\/v2\/users\/9"}],"replies":[{"embeddable":true,"href":"https:\/\/www.alittleb.it\/it\/wp-json\/wp\/v2\/comments?post=943"}],"version-history":[{"count":0,"href":"https:\/\/www.alittleb.it\/it\/wp-json\/wp\/v2\/posts\/943\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.alittleb.it\/it\/wp-json\/wp\/v2\/media?parent=943"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.alittleb.it\/it\/wp-json\/wp\/v2\/categories?post=943"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.alittleb.it\/it\/wp-json\/wp\/v2\/tags?post=943"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}