A few months back, Facebook released a new Graph API allowing third-party applications to integrate with social data and connections established on their site. Naturally, we at Dareville have been playing around with these new APIs in a few of our recent projects and feel they are a huge improvement over the old REST services that were available previously. Unfortunately, there doesn’t exist an official Facebook/Adobe API for these new Graph services in ActionScript 3 so we decided to release our own!
This library simplifies the creation and acquisition of data from the Facebook Graph API, as well as the expectation of returned data in a consistent and strongly-typed format. This includes, but not limited to, retrieving and posting on users’ wall feeds, creating and retrieving events and event statuses, posting comments, searching content and much more!
It does not provide login authentication as there are many other libraries available for this purpose and really…why re-invent the wheel? Some great examples are from Big Spaceship and Jozef Chúťka.
There is some functionality that has not yet been implemented (places, inbox, send email, etc) but our intent is to include them as soon as possible. If you are interested in contributing, please do so with our repository on Github!
Syntax
Once you have acquired your access_token from Facebook, you can call any one of the services provided by the API. Keep in mind that you may need to have already prompted the user with specific permissions during the authentication step in order for methods to return data properly. See more on Facebook extended permissions.
Almost every method that you can call with these services, dispatches a Signal upon completion or failure. For full documentation and more information on the signals dispatched, please visit our ASDoc
Executing a service is as simple as the following:
var service : FacebookUserService = new FacebookUserService(); service.getNewsFeed( access_token );
Listening for the response is just as easy, especially if you are familiar with Signals. Add a listener to the signal and create your responder method. Each method is documented in our ASDocs with the provided parameter reteurned.
service.newsFeedLoaded.addOnce( onNewsFeedLoaded );
function onNewsFeedLoaded( vo : FacebookFeedCollectionData ):void
{
}
Examples
Post on current logged in users’ wall
var post : FacebookFeedCreatePostData = new FacebookFeedCreatePostData( msg, link, icon );
var service : FacebookUserService = new FacebookUserService();
service.wallPostCreated.addOnce( onWallPostCreated );
service.createWallPost( access_token, FacebookConstants.CONNECTION_ME, post );
function onWallPostCreated( post_id : String ):void
{
}
Get wall post comments
var service : FacebookCommentService = new FacebookCommentService();
service.commentsLoaded.addOnce( onCommentsLoad );
service.getComments( access_token, post_id );
function onCommentsLoad( vo : FacebookCommentCollectionData ) : void
{
}
Upload a photo
var source : ByteArray = jpg.encode( bmd );
var photo : FacebookPhotoCreateData = new FacebookPhotoCreateData(
"Photo caption", source );
var service : FacebookPhotoService = new FacebookPhotoService();
service.photoCreated.addOnce( onPhotoCreated );
service.createPhoto( access_token, photo, FacebookConstants.CONNECTION_ME );
function onPhotoCreated( id : String ):void
{
}
Contact and Links
Feel free to contact us with any recommendations, questions, comments: dev _at_ dareville _dot_ com
