锦标赛

一场锦标赛就是一个有起止时间、且共享起始上下文的排行榜。适合用来做周末活动、冲榜对抗,或者「来打破我的分数」式病毒传播流程。

创建

const tournamentId = await FRVR.tournaments.create(
  { seed: 12345, mode: 'endless' },     // 任意 payload —— 所有玩家拿到的是同一份
  {
    title:     'Weekend Rush',
    sortOrder: 'HIGHER_IS_BETTER',       // 计时挑战可用 'LOWER_IS_BETTER'
    endTime:   Date.now() + 48 * 3600e3, // epoch 起的毫秒数
  },
);

返回的 ID 是后续所有调用要用的句柄。

提交分数

await FRVR.tournaments.postScore(tournamentId, 42000, playerName, photoUrl);

playerName 和 photoUrl 是可选的覆盖项 —— 如果你的渠道没给出合适的默认值,或者你想显示游戏内昵称,就传它们。

读取一场锦标赛

const t = await FRVR.tournaments.getTournament(tournamentId);
// {
//   id, title, endTime, sortOrder,
//   entries: [{ playerId, score, rank, name, photo }, …]
// }

玩家参加的锦标赛

const mine = await FRVR.tournaments.getMyTournaments(20, 0); // count、offset

一组玩家的成绩

const scores = await FRVR.tournaments.getScores(tournamentId, [fid1, fid2, fid3]);

当前渠道是否支持?

if (!FRVR.tournaments.platform.isSupported()) {
  hideTournamentsMenu();
}

锦标赛需要服务端实现支撑;沙箱渠道可能不提供。

Tournaments:读取支持情况 + 当前

loading SDK…

platform.isSupported()platform.getCurrentTournament()