Forum Sitebox Facebook Documentation

Discussion and help relating to the PlayerIO webpage and Facebook app hosting solution, Sitebox.

Facebook Documentation

Postby batiali » November 8th, 2010, 1:25 pm

Hello there,

I know it's not related to player.io but it would be profitable for you anyway, so here is my suggestion.

Example projects are really important. I believe they play an important role to convince people pay for player.io
So, as I stated in the survey, you should really pay more attention to those example projects.
Make them tidy, document better, use oop :P
I mean, lets have a look to Seedlings example, it's a great one, it has lots of features that you may want to do with a facebook game. But it's really complicated. Game.as class does almost everything. Is it only me thinking that those roles should be splited or you guys didnt care about it that much?
I believe these example projects can be coded & documented better.

Also, do you have any plan to make any documentation about Facebook classes, like FB, FBData, and so on?

Thanks in advance.
batiali
 
Posts: 29
Joined: August 11th, 2010, 2:53 pm

Re: Facebook Documentation

Postby azuanagames » November 8th, 2010, 4:18 pm

Those FB classes really do need documentation. Though they kind of are documented. You need to look at the facebook developer site itself.

The facebook docs are here: http://developers.facebook.com/docs/reference/javascript/
azuanagames
 
Posts: 157
Joined: April 29th, 2010, 10:59 pm

Re: Facebook Documentation

Postby Oliver » November 9th, 2010, 2:10 pm

The Facebook API we're providing (https://github.com/playerio/Facebook-Graph-As3) is an almost direct port of the javascript api, so their documentation should apply to that project. We've documented it as much as we can, but most of the functionality is not in the actionscript code, but rather in the arguments that are passed to FB.api() and FB.ui() FB.Data.*, which we can't document because faceboook hasen't documented it that well and change it fairly often... That's why we refer to their documentation, because it's the most up to date you'll find...

There is a readme associated with out AS3 graph api btw, just go here https://github.com/playerio/Facebook-Graph-As3 and scroll to the bottom.

Since the release of our AS3 Facebook Graph API, adobe has updated their old mega-facebook-api to work with Facebook Graph: http://code.google.com/p/facebook-actionscript-api/
You can try using that, but in my mind it's a horrible piece of over-enginering and way to complicated for 99% of the normal use cases..

With regards to the structure of the sample project: They're not designed to be complete games, but rather showing the key points in how to use player.io and -- in the case of seedlings -- integrate with Facebook. That's why a lot of it is contained in the main game.as file, because that way a developer can read through that one file and learn how player.io works.

Best,
Oliver
User avatar
Oliver
.IO
 
Posts: 1159
Joined: January 12th, 2010, 8:29 am


Return to Sitebox



cron