Facebook API Begining

 正文：
在开始所有之前，我们的首先要加入成为Facebook Develop，按以下网址加入：
http://developers.facebook.com/
要明白facebook用户所有自己的游戏或者应用程序都是建立在用户自己的Application上的，在加入成为developer后就能建立自己的Application并且获
得一条API Key 和 Secret Key。用户facebook服务器就是通过这两条密码和facebook用户自己的网页交互的。（具体如何建立一个Application，请参考：Let’s Set Up an App.doc
参考网址：http://services.tucows.com/developers/2007/07/25/getting-started-with-facebook-application-development/ ）


下面让我们看看facebook服务器和我们自己的服务器的架构图：



从 以上可以看出我们的facebook是通过我们的API后，我们就可以调用facebook用户的数据，我们的页面不是放在facebook上的 facebook服务器只是调用我们的页面，并且在我们Application上的canvas上显示出来。Canvas的最大的大小是646px X 690 px，（个人建议用636pxX680px）
Facebook流程、结构图：


FaceBook API说明：
在开始API说明前，我想大家看看如下的图：



FaceBook API上的API有很大程度上是与这四个选项是挂钩的。API里面大多数的功能就是获取上面的数据，调用方法等等。

官方API Methods参考文档网址：
(大家请经常看看此连接地址，为什么？因为Facebook上面的API为了适应市场等其他的原因，经常对API作出修改，好像最近在多伦多开完会之后，又对API作出了修改)

Url：http://wiki.developers.facebook.com/index.php/API

当我们想测试API时不一定要用我们自己的client，Facebook上通过了一个API测试网址，供我们快速测试API
API、FBML、FEED测试网址：http://developers.facebook.com/tools.php?

重要：
因为官方提供的所有教程太贫乏，所有我不得不去找别人blog上的API方法的使用例子
（所有具体例子在API Methodes文件夹中）

具体API方法说明（以下API方法并不是全部的API方法，是具体能在flashfacebook lib里面能够使用的方法，具体全部的API方法请参考上面的官方连接）：
(以下方法有些是要调用FBML的，具体FBML如何调用，请参看官方API Methods参考文档网址）
(FBML：facebook自己本身的一种标记语言)

Auth.createToken（新建标记）（必须执行此部序才能使用API）
Auth.getSession（获得SessionID）（必须执行此部序才能使用ID,这个SessionID是随机的，并且用MD5加密。
Friends.areFriends（检测两个或者多个用户是否为朋友，返回一个布尔值）
Facebook.friends.get（获得当前玩家所有朋友的ID列表）
Friends.getAppUsers（获得加入了我的Appliction的朋友ID列表）
Groups.get（获得我的组群列表）
Users.getInfo(获得玩家的详细信息）（重要）
Users.getLoggedInUser(获得当前玩家的ID号）
Events.get(获得当前玩家受到的邀请的事件列表)
Photos.addTag(给照片加入标签)
Photos.createAlbum(新建一个相册)
Photos.getTags(获得一个相册的标记的信息)
Photos.get(获得一个朋友的照片)
Photos.getAlbums(获得一个玩家的相册)

notifications.Get(获得所有的notifications信息）
Notifications.send(发送一个Notifications信息）（重要，可以实现很多功能，比如发送我们的游戏给别人玩什么的，这里要调用FBML）

（还有其他的一些方法都实现了，不过此我们不是那么重要，在这里不作说明）

Falsh的API方法：
具体能用的flashfacebook 的方法请参考以上列表，
Flashfacebook lib已经由本人改写、修正、测试。
具体如何使用请参看flash API Methodes包里面的Main.as类里面API使用方法说明。

Other Functionality（其他的一些方法）（重要）

Interacting with Facebook.com
While the current version of the API does not support performing actions on Facebook.com directly, you can direct your users to various Facebook pages to perform an action. To do this, just link the user to one of the following pages:
（当当前提供的API的不能实现facebook平台的某一些方法的时候，你能直接通过在facebook页面上使用你的用户的某些数值或者属性来实现你所需要的功能。完成这些方法，你只需要一条包含用户信息的连接就可以了）
http://www.facebook.com/profile.php?id=XXXXX （观看用户的profile）
view the specified user's profile
http://www.facebook.com/poke.php?id=XXXXX （逗某个用户一下）
poke the specified user
http://www.facebook.com/message.php?id=XXXXX &subject=XXXXX&msg=XXXXX
（传讯息给指定的用户。subject和msg参数是可选的方式预先填写的内容信息（用户仍然能够得到编辑的信息，然后递交））
send a message to the specified user. subject and msg parameters are optional ways to pre-fill the contents of the message (the user will still be able to edit the message before sending).
http://www.facebook.com/addfriend.php?id=XXXXX （加某个用户为朋友）
add the specified user as a friend
http://www.facebook.com/photos.php?id=XXXXX （看到某个照片）
see photos taken by the specified user
http://www.facebook.com/photo_search.php?id=XXXXX （看到某个用户的照片）
see photos of the specified user
http://www.facebook.com/wall.php?id=XXXXXXX （看到某个用户的post）
read or post on the specified user's wall
http://www.facebook.com/notes.php?id=XXXXX （看到某个用户的notes）
read the specified user's notes

Note that we don't look fondly upon spammy behavior, so please don't encourage your users to abuse this functionality.
（注意，我们不要小看、轻信spammy的行为，所以请不要鼓励你的用户滥用此功能。）
（从上句我们可以看出



附录：
facebook是什么？

美国FACEBOOK是一只对高校学生开放的网站,它严格限制注册，需要在指定的大学IP地址范围内上网才能注册facebook.com帐号。这种机制保证了用户的纯净，从而形成了校内网的特色，即“真诚”和“信任”——多数用户都使用真姓名、真信息和真照片。
每个用户在facebook上有自己的档案和个人页面。用户之间可以通过各种方式发生互动：留言、发站内信，评论日志。facebook还提供方便快捷的聚合功能，帮用户找到和自己有共同点的人。同时还针对大学生提供其它特色栏目。

什么是My Applications？
英文直译为我的申请，但是我认为是译“我的地盘”更合适；
每个申请的用户都有一个My Applications，别人就是通过我自己的My Applications来玩我们的游戏的。
每申请一个游戏都要设置一个Applications。
Facebook的API结构图:



Application 数据读取栏：（可以在这个栏目上读取这项Application的信息，比如有多少人玩，在什么时候玩等等。）