游戏创意与功能

你的下一项功能

成就

每位玩家每个键只解锁一次。手动规则信任游戏;统计阈值在同一受影响的上报事务内评估。

SDK:develop 分支需要玩家会话
Godot
成就功能示意图
可见的结果

操作后,同一玩家的first_steps已解锁。重复同一键不会再次解锁或发放奖励。

视频稍后提供

此步骤尚无视频。指南和MCP请求已可使用。

成就

准备同一个项目

  1. 在仪表盘中选择与游戏配置相同的项目。

    成就 →
  2. 在控制台表单中创建或复用这些测试条目。这些是示例值,并非项目当前数据。

    键名
    first_steps
    名称
    First steps
    解锁规则
    manual
    启用
    true
    解锁前隐藏
    false
    无奖励
    []

    每位玩家每个键只解锁一次。手动规则信任游戏;统计阈值在同一受影响的上报事务内评估。

  3. 运行示例前先保存、重新加载并核对条目。保留其他定义。

实现此功能

你可以预览指南。运行需要有效的项目密钥。 准备项目

已安装 SDK、导入项目配置,且玩家已登录。

此 SDK 示例使用 develop。请检查已安装的 SDK 是否具备所需 API。

先通过快速入门连接目标玩家,再通过明确的按钮或场景操作调用run_reviewed_action()。仅打开文件不会发送请求。

GDScript
res://scripts/achievements.gd
horizOn 调用
1extends Node
2​
3# Existing configured SDK and authenticated player session required.
4# Invoke run_reviewed_action explicitly after reviewing this example.
5# This explicit action unlocks the shown configured achievement key.
6func run_reviewed_action() -> void:
7 if not Horizon.auth.isSignedIn():
8 return
9 var user_id: String = Horizon.auth.getCurrentUser().userId
10 var loaded: Dictionary = await Horizon.achievements.getAchievements(user_id, "")
11 if not loaded.success:
12 push_warning(loaded.errorCode)
13 return
14 for progress in loaded.data.progress:
15 print(progress.key, ": ", progress.rewardState)
16​
17 # Configure manual first_steps; invoke on the corresponding game action.
18 var unlocked: Dictionary = await Horizon.achievements.unlock(user_id, "first_steps")
19 if not unlocked.success:
20 push_warning(unlocked.errorCode) # After timeout retry the same key.
21 return
22 # Complete progress has no unlock date or pending reward payload.
23 # Values were credited atomically. Refresh playerValues when displaying balances.
24 # No Inbox claim or local value addition. Retry the original key after an uncertain reply.
打开完整SDK示例 ↗

测试你的新功能。

操作后,同一玩家的first_steps已解锁。重复同一键不会再次解锁或发放奖励。

在仪表盘中选择与游戏配置相同的项目。

接口
  • GET/achievements
  • POST/achievements/unlock
  • POST/achievements/rewards/deliver
API 参考中的全部接口
排行榜功能示意图
下一步建议

为每一局添加最高分。

每局结束后保存分数并展示领先者。继续使用现有连接和玩家会话。