小游戏 SDK

本部分包含小游戏 JavaScript SDK 的 API 参考文档。如果您想开始构建新游戏，建议始终使用我们的最新版 SDK。请点击下方按钮，参阅最新版 SDK 的参考文档：

小游戏 SDK 参考文档捆绑包配置参考文档

请参阅小游戏 SDK 当前受支持版本的更新日志：

7.1 版本

前往小游戏 SDK v7.1 参考文档

更新日志

原生呈现视频内容：为应用添加 API，以使用原生形式呈现视频内容。
激励插屏广告 API：激励插屏广告是小游戏开发者用于变现的一种新型广告展示格式。激励插屏广告与激励视频广告不同：对于激励视频广告，用户可以选择是否观看；而激励插屏广告将代替普通插屏广告而出现，且用户可以选择退出广告。观看完整视频后，用户将获得游戏内奖励。
顶部横幅广告：允许开发者在游戏顶部显示横幅广告。

7.0 版本

前往小游戏 SDK v7.0 参考文档

更新日志

自定义邀请：玩家可通过 Messenger 邀请新玩家加入游戏。玩家将看到一个“邀请新玩家”部分，其中会显示还没玩过此游戏的好友。当玩家点击“邀请”后，系统随即向他们的好友发送消息，邀请他们加入游戏。玩家一次可发送多份邀请。详情请参阅此处指南。
触感反馈：在具有集成振动器的 Android 和 iOS 设备上，小游戏现在支持触感反馈。
排位赛 API：小游戏排位赛是发展新玩家的绝佳方式，并且有助于在排位赛期间（默认为 7 天）保持玩家的参与度。玩家可将排行榜分享到时间线，并通过话题引子邀请好友加入挑战。将动态消息推送与参赛玩家的二次分享相结合，使得排位赛这种游戏模式能够覆盖朋友关系网络，帮助游戏在短时间内获取更多玩家。
移除统计数据 API：此类 API 已被移除，取而代之的是更灵活的玩家数据 API。
移除 postSessionScore：我们将替换为 postSessionScoreAsync，因为这将为通过此 API 调用的对话框提供更好的用户操作信息。
移除 shareAsync 和 updateAsync 中未使用的参数：我们已从 shareAsync 中移除 INTENT 参数，因为该参数未被使用。我们还从 updateAsync 中移除了 IMMEDIATE_CLEAR 策略，因为我们当前有一个策略将自定义更新的频率限制为每个环境会话一次。
顶部横幅广告：允许开发者在游戏顶部显示横幅广告。

6.3 版本

前往小游戏 SDK v6.3 参考文档

更新日志

（新增）FBInstant.postSessionScore：通过此 API，游戏可以为 Facebook 提供玩家在当前游戏会话中的分数。Facebook 将在各种平台集成中使用这些分数信号，帮助玩家发现游戏、在游戏中展开竞争以及重新参与游戏。
离线匹配：之前匹配一直都是同步进行，导致玩家在等待时无法离开游戏。而这一版本在“matchPlayerAsync”中添加了一个异步选项。当玩家启用离线匹配时，系统会将其立即添加到群组会话中，玩家可在等待更多玩家加入时离开游戏。当玩家与其他玩家匹配成功后，如果该玩家仍处于游戏中，系统会添加该玩家，并将其切换到已匹配对话的游戏环境中。
在“initializeAsync”之后，可开始访问用于获取玩家、环境、语言和接入点相关信息的数据 API：我们正在逐步恢复游戏开始前对数据 API 的访问功能！例如，您现在可以在游戏加载时访问玩家的语言或接入点数据。这应该有助于您减少二次加载屏幕和游戏的整体加载要求。这一更改现已在网页端实现，并将从以下版本开始在移动端上实现：Android 版 Facebook v219、Android 版 Messenger v213、iOS 版 Facebook v222、iOS 版 Messenger v216。更早的移动版本将显示之前的行为，因此请务必在“startGameAsync”解析之后检查是否存在任何更新的值。