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
{
}

Check out our blog post as well as our Github and ADDocs:

Dareville library for Facebook Graph APIs
Github library
ASDocs

SpotifyUtil

Here is an example of how to use the method which will convert the link variable below to “spotify:user:user_name:playlist:3WbWswJtOPIdKBQmZs9pGr”:

var link : String = "http://open.spotify.com/user/user_name/playlist/3WbWswJtOPIdKBQmZs9pGr";

var validUrl : String = SpotifyUtil.validatePlaylist( link, SpotifyUtil.URL_FORMAT_SPOTIFY );

if( validUrl )
{
	trace( link );
}

What we wanted to do was to use the same build SWF targets but for both situations without having to modify our process. Our solution was a nifty trick that used JavaScript inside ANT. I had never seen this technique before but some searching for a solution led us in this direction.

As you can see below, we have two initial targets, one which builds for local file system and one which builds for network use. We can then run either target first, which sets a property in our ANT file and then run our normal SWF build targets as normal, with this property set to the “use-network” property. Really looking forward to exploring some more complexities with JavaScript integration (as well as other languages from what I’ve read).

<target name="compile_local">
	<script language="javascript">
	<![CDATA[
		presenter.setProperty( "use-network", "false" );
	]]>
	</script>
</target>
<target name="compile_network">
	<script language="javascript">
	<![CDATA[
		presenter.setProperty( "use-network", "true" );
	]]>
	</script>
</target>

SNOOP 4:20

Ok, lets get started! First, all of these instructions assumes you have a good knowledge in how ANT works. It also assumes you will be building an ActionScript or Flex project. In this case, we are going to be creating a custom ContextMenu but you can really do this for anything. This will allow anyone us to see the version numbers when they right click on our application.

Ok, so how is this done? Open up your build.properties file for the project and add the following lines:

project.major	  = 1
project.minor     = 0
project.revision  = 0
project.version   = ${project.major}.${project.minor}.${project.revision}

The projet will act as our properties for figuring out the project major, minor and revision. These could probably be automated in some way but for now I am ok with manually setting these values since I will know when these versions change. We will also need to include a build number into our build so just add the following before anything else into your build file. Also note that if this file does not exist, ANT will create it for you so no need to concern yourself with what the contents are. Let ANT do the dirty work!

<buildnumber file="${basedir}/build/build.number" />

Next, we are going to want to copy our classes to a temporary directory so that we can modify them without harming the source. As you can see I have some temp.outdir and classes.dir properties

<target name="copyClasses" description="Creates a temporary directory where the code will be duplicated so we can modify and build without harming the original files">
	<mkdir dir="${temp.outdir}" />
	<copy todir="${temp.outdir}">
		<fileset dir="${classes.dir}"/>
	</copy>
</target>

Now that our classes are copied, we need to do a search on them for particular strings that we will end up replacing with the project version. In my case, I have a ContextMenu class which has a string value defined as “[PROJECT_VERSION_NUMBER]” so I do a regular expression replace in ANT to find that value and replace it.

<target name="projectversion" description="">
	<replaceregexp match="[PROJECT_VERSION_NUMBER]" replace="${project.fullname} : ${project.version}.${build.number}" flags="gs">
		<fileset dir="${temp.outdir}" includes="**/*.as"/>
	</replaceregexp>
</target>

And that is it. Now we have our build number plus project version automatically showing up in our application.