Facebook Instant Game小游戏常见问题

jyj345

小游戏常见问题

开发小游戏

应用的产品列表中未显示“小游戏”，为什么？

选择为应用“添加产品”时，如果列表中未显示“小游戏”，请确保应用属于“游戏”类别。如果应用不是这一类别，则不会显示“小游戏”产品。

游戏的文件大小限制（以 MB 为单位）是多少？

我们未对游戏大小施加硬性限制。但我们建议初始下载时间不要超过 5 秒。您最多可以托管 200 MB 的游戏捆绑包，但在初始加载时，仅应下载绝对必要的文件。

分享方法中“intent”参数的用途是什么？

我们的 FBInstant.context.shareAsync() 方法包含 intent 参数，此参数用于接收 'INVITE'、'SHARE' 等值。目前，从版本 4.0 开始，此参数不再用于某种特定用途。这一参数的添加旨在让我们的 SDK 不过时，并会在今后提供面向用户的更改，但目前仅提供语义值。

开始与另一个玩家比赛时，如何展示被邀请/被挑战玩家的头像和姓名？

这目前还无法实现。首次在游戏中向另一玩家发起挑战时，没有 SDK 方法可用于检索被挑战玩家的信息。我们建议使用“opponent”（对手）等占位符姓名，直到第二个玩家回应邀请，那时您便可以通过 FBinstant.player 访问他们的信息。

我的游戏是否需要后端？

在决定信息的存储位置时，有以下两种选项：

使用第三方后端，您的游戏可通过 XMLHttpRequest、fetch、WebSocket 或 EventSource 与该第三方后端通讯。这意味着您可以获得更多灵活性，但也会产生与游戏受众成正比的托管费用。

使用我们基于 SDK 的解决方案，让许多服务器端功能即时可用： a.如需存储播放器的特定信息，请使用 player.getDataASync 和 player.setDataAsync 方法 b.如需存储游戏环境的特定信息，请参阅我们关于活动存储的指南 c.对于排行榜，请参阅我们的排行榜 API 指南

在移动设备玩小游戏的最低系统要求是什么？

玩小游戏的最低系统要求是：

iOS 8 及以上版本

Android 5.0 及以上版本

请参阅我们的轻量级游戏文档，详细了解轻量级游戏的最低系统要求。

如何将游戏的访问权限限制于一个自定义列表中的国家/地区？

要将游戏的访问权限限制于一个自定义列表中的国家/地区：

在应用的控制面板中，前往“设置”/“高级”选项卡

启用“受限地区”

从“允许使用的国家/地区”列表中做出选择

点击“保存更改”

提交内容供审核时，为什必须提供 Apple 开发团队编号？

提交小游戏平台应用供审核时，您必须根据 Apple App Store 审核指南 4.7 提供 Apple 开发团队编号。这有助于您的游戏在 iOS 平台的分销。使用无效或过期的开发团队编号可能会导致您的游戏被移除。

我正在使用 Howler.js 处理游戏中的音频，但遇到了一些问题。我该怎么办？

您可以直接在 Howler.js Github 上报告问题。请在问题报告的标题中注明“[IG]”，以便得到开发者的优先处理。

当游戏设置为横向格式时，window.innerWidth 与 window.innerHeight 的值不一致。我该怎么办？

您应该在解析 FBInstant.startGameAsync() 之后再调用 window.innerWidth 和 window.innerHeight。

是否可以在游戏中使用 Facebook 音频素材中的音乐？

您可以在游戏中使用（甚至编辑）Facebook 音频素材中的音乐。请注意，“音频素材”中的内容只能在 Facebook 平台使用，因此包含音频素材内容的任何版本的游戏都只能在 Facebook 平台分发/使用。

游戏智能助手

我的游戏智能助手未收到 Webhooks，为什么？

智能助手未收到 Webhooks 最常见的原因是应用内配置错误。请访问我们的智能助手设置部分，获取有关如何设置游戏智能助手的完整指南。 请检查您的开发者面板是否符合下列条件：

您必须在开发者面板的小游戏版块配置应用主页

您必须在开发者面板的 Messenger 版块订阅 messages 和 messaging_game_plays 事件

在开发者面板的 Messenger 版块，您必须在“订阅的主页”部分配置与上方第 (1) 步相同的主页

您的主页类别必须为“应用主页”，且其名称中必须包含您的游戏名称。

尝试发送消息时收到错误消息，这是为什么？

如果您收到错误消息作为图谱 API 发送调用的响应，则表示发生了下列情况之一：

您尝试发送的消息超出了以下限制：10 天内最多只可向每位用户发送 5 条消息；或

您发送消息的对象删除、屏蔽了您的智能助手，或将智能助手设置为免打扰模式；或

您的应用处于开发模式，且您尝试向应用管理员或开发者以外的用户发送消息

有关更多信息，请参阅发送 API 参考文档

常见问题和疑难解答

通过嵌入式播放器运行时，游戏不能正常运行

如果您阅读了我们的[快速入门或[测试、发布、分享指南，就一定非常熟悉嵌入式播放器的概念。嵌入式播放器可方便您在电脑中测试通过本地 HTTP 服务运行的小游戏，它连接了小游戏 SDK 的所有有效功能。

有时，尝试这种方式时，您的游戏可能无法顺利加载。有时，浏览器的开发者面板中不会显示任何消息；还有一些时候，会显示如下消息：Failed to execute 'postMessage' on 'DOMWindow'。这些都表示同一类型的错误，导致此类错误最常见的原因是：您的本地服务器因证书问题而拒绝提供资源。

如果是这种情况，请找到本地服务器的根（通常是 https://localhost:8000 或 https://127.0.0.1:8000），并按照浏览器的说明接受证书或为此网站添加安全例外。完成此操作后，返回嵌入式播放器网址，一切即应该恢复正常。

尝试加载广告时，收到“Cannot find registered ad from instance ID.”（无法通过实例编号找到注册的广告。）错误

如果您尝试通过曾经失败的 AdInstance 加载广告，便会出现此错误。如果您的 AdInstance 的 loadAsync 方法已经拒绝过一次，请不要尝试重复使用这个方法。建议通过调用 getInterstitialAsync 或 getRewardedVideoAsync 来请求新的 AdInstance

为方便大家群策群力，我们创建了一个 Facebook Instant Game   交流群：814298516 。 欢迎同学们加入交流开发和运营经验。