共计 2853 个字符，预计需要花费 8 分钟才能阅读完成。

Facebook 对象

Facebook 对象允许你将游戏与 Facebook 集成。它可用于任何网络托管的游戏，不仅仅是 Facebook 游戏。例如，你可能有一个运行在自己的服务器上的游戏。即使用户在你的网站上玩游戏，Facebook 对象仍然允许你与用户的 Facebook 账户集成。然而，提交应用程序到 Facebook 是必要的，这样你就有一个 App ID。通过 Facebook 开发者可以向 Facebook 提交应用。

Facebook 插件不兼容即时游戏。请改用即时游戏插件。
Facebook 对象进行异步请求。这意味着游戏在可能花费数秒的操作（如提交分数）完成时继续运行。因此，Facebook 对象基于一个启动任务（如发布分数）的动作，然后在任务完成时触发一个条件（如提交分数）。这些可能在几秒钟内分开，而游戏在之间继续运行，而不是在等待完成时冻结游戏。像大多数异步请求一样，动作可能以与其被调用的顺序不同的顺序完成。

准备就绪

Facebook 对象在启动时需要一段时间加载。不要在 On ready 触发或 Is ready 为 true 之前尝试使用 Facebook 对象，否则操作将被忽略。

你必须输入 App ID 才能成功加载 Facebook 对象，即使在测试中也是如此。如果你不输入它，对象永远不会准备好。这是因为 Facebook 阻止你使用 API，除非你给它一个真实的 App ID。

登录

用户必须在可以使用 Facebook 对象的任何其他功能（如发布到用户墙）之前成功使用他们的 Facebook 账户登录。这是通过 Log in 动作完成的，由于登录可能需要几秒，所以必须等到 On user logged in 触发后才能使用任何其他功能。

Facebook 可播放广告

此插件还提供了 Facebook 可播放广告的 On CTA click 动作。这个动作可以独立于其他功能使用，即无需先登录，或提供 app ID 或任何其他属性。

Facebook 属性

App ID
你在 Facebook 开发者部分为你的应用提供的 App ID。
App Secret
只有当你计划使用 Scores API 时才需要。否则不要输入 app secret。app secret 可以在你的应用的 Facebook 开发者部分找到，目前需要启用 Scores API。
Facebook 条件
Is ready
如果 Facebook 对象准备好使用则为 true。当 false 时，Facebook 对象仍在加载必要的脚本，所有操作将被忽略。
Is user logged in
如果用户当前已使用其 Facebook 账户登录则为 true。
On name available
在 On user logged in 之后不久触发，当获取用户姓名的表达式可用时。
On ready
当 Facebook 对象准备好使用时触发。在此之前，Facebook 对象仍在加载必要的脚本，所有操作将被忽略。
On user logged in
当用户成功登录时触发。它还在启动时触发，如果用户以前登录过，并且他们记住了登录返回应用程序。这还在用户登录期间游戏的每个布局开始时触发。
On user logged out
如果用户在游戏中注销则触发。
On hi-score
在 Request hi-score board 动作后，每个高分板上的一个高分触发一次。HiscoreName, HiscoreRank 和 Score 表达式包含当前的高分信息。
On score submitted
当 Publish score 动作成功完成时触发。
On user top score available
当 Request user top score 动作成功完成时触发。Score 表达式有用户的顶级分数。
Facebook 动作
Log in
打开一个弹出窗口，要求用户登录。这只能在用户输入事件中调用，如按键、按钮推动、鼠标点击或触摸屏点击。用户可能在登录屏幕取消，因此登录不一定成功。你必须提供要请求的权限的逗号分隔列表。Facebook 插件的某些功能取决于用户批准某些权限。不要请求你的应用程序不需要的权限。你可以在 Facebook 开发者指南中找到有关可用权限的文档。
Log out
从 Facebook 注销当前用户。
On CTA click
对于 Facebook 可播放广告。在可播放广告中，当用户与广告中的号召性用语（CTA）互动时使用此动作。这个动作可以独立于插件的其他功能使用。
Prompt to share link
打开一个对话框，提示当前用户在他们墙上分享你选择的 URL。这不要求任何权限，但用户可以取消操作。
Prompt to share this app
打开一个对话框，提示当前用户在他们墙上分享当前 Facebook 应用的 URL。这不要求任何权限，但用户可以取消操作。
Prompt wall post
打开一个对话框，提示当前用户发表墙帖。没有添加内容或链接 – 它是一个空的文本框，供用户键入他们喜欢的任何内容。这不要求任何权限，但用户可以取消操作。
Publish link
自动发布 URL 到用户的墙，没有任何提示。可选提供描述和小缩略图像。这要求用户已使用 Publish to stream 权限登录。
Publish wall post
自动发布消息到用户的墙，没有任何提示。这要求用户已使用 Publish to stream 权限登录。
Publish score
发布数值分数到游戏的高分板。这要求用户已使用 Publish scores 权限登录。当动作完成时，它触发 On score submitted。
Request hi-score board
请求游戏的高分。这要求用户已使用 Publish scores 权限登录。这个动作将在高分板上每个分数上一次触发 On hi-score。由你找到一种显示这些分数的方法；将每个高分附加到文本对象是一种简单的显示方式。
Request user top score
请求当前登录用户的这款游戏的最高分。这要求用户已使用 Publish scores 权限登录。当动作完成时，它触发 On user top score available.

Facebook 表情

用户名

当前用户的名字。只有在 On name available 触发后才设置。

全名

当前用户的全名。只有在 On name available 触发后才设置。

姓氏

当前用户的姓氏。只有在 On name available 触发后才设置。
用户 ID 字符串
当前用户的 ID，可以用来区分同名的不同用户。只有在用户登录后才会设置。注意：虽然这是一个数字，但由于 ID 可能比 Javascript 能表示的数大，所以返回为字符串。

最高分名称

当前最高分条目的名称。只在 On hi-score 事件中设置。

最高分排名

当前最高分条目的排名，从 1 开始，到请求的最高分条目数。只在 On hi-score 事件中设置。

最高分用户 ID 字符串

返回当前最高分条目的用户 ID。即使两个在高分榜上的人有相同的名字，这也是唯一的。注意：虽然这是一个数字，但由于 ID 可能比 Javascript 能表示的数大，所以返回为字符串。

分数

在 On hi-score 事件中，是当前的最高分，或者在 On user top score available 中，是当前用户的分数。