FBInstant.player.getConnectedPlayersAsync()持续返回空的问题排查与解决

常见原因及对应解决方案 #

1. 当前游戏上下文为单人模式（SOLO） #

FBInstant.player.getConnectedPlayersAsync()仅返回同一游戏上下文中的已授权好友，如果当前上下文是单人类型（contextType为SOLO），接口必然返回空数组。

• 解决方法：
  • 查看你的contextType输出，确认是否处于单人上下文；
  • 测试时必须通过Facebook好友对话、群组等多人上下文打开游戏，而非直接打开独立测试链接。

2. 好友未满足「同一上下文参与游戏」条件 #

即便好友完成了游戏授权，若他们没有通过同一个游戏上下文链接启动过游戏，也不会被该接口返回。

• 解决方法：
  • 确保测试好友是点击你分享的上下文专属链接进入游戏；
  • 让好友完成完整的游戏初始化流程（走到startGameAsync执行完成的步骤）。

3. 游戏权限配置缺失 #

Facebook Instant Games需要正确配置权限才能获取连接玩家，若未声明player_friends相关权限，接口会返回空。

• 解决方法：
  • 登录Facebook开发者后台，找到你的游戏应用；
  • 在应用审核 > 权限与功能中，确保player_friends权限已添加并处于可用状态（开发模式下无需审核即可使用）。

4. 接口调用时机的潜在问题 #

虽然你的代码在startGameAsync之后调用接口，但部分场景下上下文信息可能未完全同步。

• 解决方法：
  • 调用接口前先检查上下文有效性，或添加上下文切换引导逻辑，以下是优化后的代码示例：

let global_config = {};
window.onload = function (e) {
  FBInstant.initializeAsync()
    .then(() => FBInstant.startGameAsync())
    .then(() => {
      const contextId = FBInstant.context.getID();
      const contextType = FBInstant.context.getType();
      const playerName = FBInstant.player.getName();
      const playerPic = FBInstant.player.getPhoto();
      const playerId = FBInstant.player.getID();

      global_config = { contextId, contextType, playerName, playerPic, playerId };
      console.log("default", global_config);

      // 先判断是否为单人上下文
      if (contextType === "SOLO") {
        console.log("当前为单人上下文，无法获取连接玩家，请切换到多人上下文测试");
        // 引导用户选择多人上下文，切换后重新获取玩家
        FBInstant.context.chooseAsync()
          .then(() => FBInstant.player.getConnectedPlayersAsync())
          .then(players => console.log("切换上下文后获取到的玩家：", players))
          .catch(err => console.error(err));
        return;
      }

      // 正常调用接口
      FBInstant.player.getConnectedPlayersAsync()
        .then(players => console.log("getConnectedPlayersAsync", players))
        .catch(err => console.error("getConnectedPlayersAsync", err));
    })
    .catch(err => console.error("初始化失败：", err));
};

内容的提问来源于stack exchange，提问作者artwl