物品赠送、更快的聊天与匹配回合,以及可恢复的 API 密钥:horizOn 本周更新
概要
horizOn 玩家现在可以互相赠送物品,聊天和匹配回合通过实时套接字传输,删除的项目密钥可以完整恢复。
本周值得更新 SDK。Unity SDK 1.13、Godot SDK 1.12 和 Unreal SDK 1.11 均于 11 月 16 日发布,同时发布的还有 Server 1.78、Simple Server 1.8 和 MCP Server 1.10。玩家现在可以互相传递物品,聊天消息和匹配回合有了更快的服务器路径,删除的项目密钥不再永久丢失。
以下是 11 月 12 日至 11 月 18 日之间的变化。
物品赠送:玩家之间互相发送物品
玩家迟早会提出这个要求:「我能把这把剑给我朋友吗?」自己构建这个功能比看起来更难。物品绝不能存在两份,连接中断不能让它消失,而且任何人都不应该能够通过编辑消息来伪造赠送。
有了 Server 1.78 和新的 SDK,horizOn 为你处理这一切。玩家从自己的库存中选择一件物品,通过玩家 ID 发送给同一游戏的另一位玩家。从那一刻起,服务器持有原物品。接收者在其 Player Inbox 中获得一个条目,并从那里领取物品,物品保持之前的身份和属性。
礼物未被领取时会发生什么
- 拒绝。 接收者可以拒绝礼物,物品会返回给发送者。
- 过期。 如果七天内无人领取,物品也会返回。
- 安全返回。 返回的物品作为独立的收件箱条目到达,因此发送者以同样的方式领取回原物品。
免费或收费
你可以在 Dashboard 中决定发送是免费还是收取固定费用(使用你的某个 Player Values 货币)。发送者付费,当礼物返回时费用不会退还。Dashboard 中新增的物品赠送页面列出了每份礼物,让你可以检查它、重试返回并恢复卡住的情况。
在你的引擎中
每个 SDK 都有一个新的管理器:Unity 中的 ItemGiftsManager、Godot 中的 Horizon.itemGifts 和 Unreal 中的 ItemGifts 子系统,支持 Blueprint。每个引擎都附带一个示例,在首次调用前存储发送请求,这样超时或重启可以安全地重复它而不会发送物品两次。Simple Server 1.8 也支持物品赠送,MCP Server 1.10 为你的 AI 编码助手提供了相关工具和文档。
通过实时套接字的聊天和匹配回合
horizOn 中的聊天和回合制匹配使用实时 WebSocket 连接,因此玩家无需轮询即可看到新消息和回合。从 Server 1.78 开始,该连接在托管服务器上运行用于聊天和匹配,并且它的功能不仅仅是通知变化。
当套接字连接时,新的 SDK 会直接通过它发送聊天消息或匹配操作(如加入或进行回合),而不是单独的 HTTP 请求。如果套接字未就绪,SDK 会自动通过 HTTP 发送相同的调用,因此你的游戏代码无需更改。当玩家订阅聊天或匹配时,服务器可以包含当前状态的快照,这节省了额外的重新加载。创建匹配和报告结果仍然使用 HTTP。
旧版本的 SDK 继续像以前一样工作。要获得更快的路径,请更新到 Unity 1.13、Godot 1.12 或 Unreal 1.11。
每个套餐的实时连接数
定价页面现在显示每个套餐允许的实时连接数,从免费版的 4 个到专业版的 100 个,外加用于短时突发的连接峰值。如果你的游戏为大厅中的每个玩家打开套接字,请在上线前检查这些数字。
恢复已删除的项目密钥
删除错误的项目密钥曾经是糟糕的一天。自 Server 1.78 和 Dashboard 1.115 起,删除密钥可以撤销。API 密钥页面列出了仍可恢复的已删除密钥,恢复会带回密钥及其玩家和数据。
已删除密钥的玩家也不再从视图中消失。用户列表显示他们,你可以像其他玩家一样激活、停用或删除他们。
其他发布内容
- 每个账户的开放匹配数。 除了每个玩家的限制外,每个套餐现在限制账户所有项目的开放匹配总数,从免费版的 100 个到专业版的 2,500 个。SDK 和 MCP Server 处理新的错误,Simple Server 对每个安装有自己的限制。
- 更清晰的定价表。 对比表已分组并解释每一行。
- 在线数据处理协议。 你可以直接在 Dashboard 中签订数据处理协议并以 PDF 形式下载。
- API 密钥详情。 密钥详情显示可复制的 ID,范围限定为单个项目的账户密钥列出该项目。
- 匹配结果。 当同一匹配的两个结果报告同时到达时,服务器会重试而不是失败。
- MCP Server 1.11。 玩家认证工具、按项目密钥过滤的远程配置以及按实体名称查找项目。
- 注册。 更多一次性邮箱域名被屏蔽。
- 法律页面。 每个翻译的法律页面现在都说明只有英文和德文版本具有约束力。
如果你错过了上周的更新,请阅读更安全的 API 密钥重新生成和服务器端 AI 翻译。
在 Discord 上更快获取更新
本文总结了本周的内容。如果你想在发布时立即了解,请加入 horizOn Discord 服务器。新版本会在那里实时发布,通常比每周总结早几天,这也是提问或告诉我们你接下来需要什么的最快渠道。
更新你的 SDK,在游戏中尝试物品赠送,并告诉我们通过套接字的聊天和匹配体验如何。在 Discord 上回复或在 GitHub 上提交问题。完整的更改列表在 horizOn 更新日志上。