跳转到内容
IGP Developer Docs
🚧 Preview · 当前公开包仍处于预览阶段，接口可能继续变化。请始终锁定具体版本号，不建议直接引用 latest/。

Release Notes

本页列出 IGP Developer Docs 当前公开的各引擎 SDK 包版本、下载链接与校验值。

每个版本都有固定下载链接，并附带 SHA256SUMS；正式项目请固定具体版本，不要直接使用 latest。

如需查看每个版本的具体变更，请查看 Changelog。

当前最新版本：Unity 0.2.14，GameMaker 0.0.6。

0.2.14 更新重点：

  • 重新构建 Unity SDK 0.2.14 主包以及 Mirror transport、Compliance、Lying Bottle、Cloud Archive 和 GameKit 可选包。

  • 恢复 hosted RPC 契约以及 Unity / Godot SDK 的注册、注销、调用与响应事件。hosted command 编号 12 至 14、rpc_name 和 mode 重新启用。

  • Mirror Transport 诊断现在分别记录 Mirror logicalChannel 和每次发送实际采用的 effectiveTransport（kcp 或 raw-udp）；raw UDP 不可用时会明确记录回退到 KCP。

  • hosted KCP 新增 KcpHealthState 和 KcpLastFaultReason；dead-link、致命 socket 错误或发送队列硬溢出会关闭当前 data-plane、进入 ConnectionFailed 并通过 onError 上报。

  • 内置浮层改名为 ShowNetworkDiagnostics / showNetworkDiagnostics，显示健康状态、最近故障、RTT、队列和 UDP 统计。

  • KCP 在 WaitSnd >= 1024 时施加发送背压，并可在 256 datagram 软预算之后自适应排空 UDP burst。

  • Arena KCP 使用 MTU 1200 并补充逐远端 UDP/KCP 进展诊断；Mirror Transport reliable batching 默认值调整为 1024 bytes。

  • hosted KCP 与 raw UDP unreliable 会针对 200ms 高延迟、1000 datagrams/s 或 1 MiB/s 高流量输出结构化 Warning。

  • Mirror Transport 会针对原始大小超过 16 KiB 或需要可靠分片的大包，以及超过 4096 条或 16 MiB 的接收队列输出 Warning。

  • 高延迟、高流量和 Mirror payload/queue Warning 仍为 action=observe-only，不会改变网络行为。

  • 首次异常立即输出，持续异常最多每 30 秒汇总一次；高延迟和高流量恢复稳定 5 秒后只输出一次恢复日志。

  • 绑定的 Mirror Transport 会在 Runtime 进入 ConnectionFailed 时立即清空待派发的入站消息，并向对应的客户端和服务端连接派发一次断开回调。

0.2.13 highlights:

  • Published Unity SDK 0.2.13 packages for the main SDK, Mirror transport, Compliance, Lying Bottle, Cloud Archive, and GameKit modules.
  • Reorganized the main Unity package source into Core, Platform, Capabilities, Multiplayer, Diagnostics, and Internal categories without changing public APIs, namespaces, assembly identity, or Unity asset GUIDs.
  • Unity in-game ready APIs now live on IGPRuntimeManager and reuse Arena player state at Player.State["gameReady"]; batch queries read the current room snapshot.
  • Removed the Mirror Transport ready APIs and dedicated KCP 41004 ready message path. Game ready state does not control Mirror connections.
  • Runtime Manager diagnostics now use the shared IGPLog pipeline, including Info game-ready logs under scope=game-ready.
  • Unity GameKit adds IGPProfile.GetProfileAsync to fetch the signed-in user’s complete current profile through desktop session command GetDesktopUserProfile.
  • Profile responses include avatar and background selections, avatar-frame render metadata, bio, name-change state, activity time, and pending nickname review state; avatar PNG bytes remain on GetDesktopUserAvatarAsync.

0.2.12 highlights:

  • Published Unity SDK 0.2.12 packages for the main SDK, Mirror transport, Compliance, Lying Bottle, Cloud Archive, and GameKit modules.
  • Unity Mirror Transport now sends Channels.Unreliable through a raw UDP unreliable lane by default, with Use Raw UDP Unreliable Lane available as an opt-out back to the legacy reliable KCP path.
  • Unity hosted data-plane descriptors now include raw UDP lane fields: unreliableUdpHost, unreliableUdpPort, unreliableUdpToken, unreliableUdpExpiresAtUnixMs, and unreliableUdpPayloadMaxBytes.
  • Unity SDK adds the internal UDP client handshake, session-targeted envelopes, negotiated/default 1200 byte unreliable packet max, and receive dispatch used by Mirror transport.
  • Unity GameKit adds desktop-owned Share with text, multi-image binary payloads, and game-defined extension data; desktop session command frames now allow binary contentBytes up to the raised SDK frame limit.

0.2.11 更新重点：

  • Published Unity SDK 0.2.11 packages for the main SDK, Mirror transport, Compliance, Lying Bottle, Cloud Archive, and GameKit modules.
  • Unity IGPConfig.debugLogging is now an IGPLogLevel dropdown with Off, Error, Warning, Info, and Debug levels.
  • Info keeps lifecycle and staged diagnostics quiet enough for normal debugging; per-message send/receive, frame, payload, ping, and pong logs are reserved for Debug.
  • Unity Mirror Transport keeps low-frequency Info summaries for reliable payloads over 16 KiB or expected to fragment, including direction, peer, original/wire bytes, compression state, and estimated fragments.
  • Unity RTT HUD diagnostics now show UDP datagram rates, packet totals, and socket byte totals alongside App RTT, KCP srtt/rto, 1-second Queue averages, and 5-second Q peak values.
  • The Unity 0.2.11 packages were rebuilt so KCP/RTT diagnostics stay observational: heartbeat IsKcpAlive no longer gates P2P/Mirror sends, and reading KcpTransportStats no longer advances UDP rate sampling.

0.2.10 更新重点：

  • Published Unity SDK 0.2.10 packages for the main SDK, Mirror transport, Compliance, Lying Bottle, Cloud Archive, and GameKit modules.
  • Unity Mirror Transport now defaults connection retry attempts to every 60 seconds, connection timeout to 300 seconds, and peer silence timeout to 300 seconds.
  • Unity hosted KCP now supports binary envelope v2 for reliable chunk payloads while keeping the JSON/base64 fallback path.
  • Unity Mirror transport now logs compression decisions and exposes a separate reliable batch threshold.

0.2.8 更新重点：

  • Published Unity SDK 0.2.8 packages for the main SDK, Mirror transport, Compliance, Lying Bottle, Cloud Archive, and GameKit modules.
  • Unity network logs now include a per-process runId and event=session-start summary for startup context.
  • Unity KCP and P2P diagnostics now use explicit player id fields, add heartbeat timing details, and summarize payload bytes/checksums without full base64 payloads.

0.2.7 更新重点：

  • Published Unity SDK 0.2.7 packages for the main SDK, Mirror transport, Compliance, and GameKit modules.
  • Unity achievement unlock and progress calls now generate an eventId when callers omit one.
  • Unity achievement progress reports now accept optional progressValueMode for SET versus INCREMENT semantics.

0.2.6 更新重点：

  • Published Unity SDK 0.2.6 packages for the main SDK, Mirror transport, and Compliance modules.
  • Unity internal hosted session, KCP, P2P, and hosted realtime logs now share the structured [IGP SDK] format with timestamp, level, scope, path, and event fields.
  • Unity KCP receive-drain diagnostics now include payload, payload byte, frame, queue, RTT, and window snapshots in the unified SDK log stream.
  • Unity Mirror Transport now compresses payloads from 2 KiB by default before SDK size classification.

0.2.5 更新重点：

  • Published Unity SDK 0.2.5 packages for the main SDK, Mirror transport, and Compliance modules.
  • Unity hosted KCP now prints structured [IGP KCP] diagnostics for handshake, send/drop, UDP read, KCP receive, heartbeat RTT, and internal queue/window state.
  • Unity IGPKcpClient.DiagnosticsSummary can be exported by diagnostics tools for readable KCP queue, RTT, and window snapshots.

0.2.4 更新重点：

  • Published Unity SDK 0.2.4 packages for the main SDK, Mirror transport, and Compliance modules.
  • Unity hosted KCP now emits only control and data transport channels, matching Arena’s current control/data queue split.

0.2.3 更新重点：

  • Published Unity SDK 0.2.3 packages for the main SDK, Mirror transport, and Compliance modules.
  • Unity Mirror Transport now exposes PeerSilenceTimeoutSeconds, defaults peer silence detection to 120 seconds, and refreshes peer activity while large reliable messages are still being reassembled.
  • Unity Mirror Transport logs now include timestamps when IGPRuntimeManager.DebugLogging is enabled.

0.2.2 更新重点：

  • Published Unity SDK 0.2.2 packages for the main SDK, Mirror transport, and Compliance modules.
  • Unity IGPNetwork can now disable retaining incoming packets for polling when an event-only consumer such as Mirror Transport is bound, preventing duplicate receive queues from accumulating the same realtime data.
  • Unity Mirror Transport 现在统一跟随 IGPRuntimeManager.DebugLogging，未绑定 Runtime Manager 时默认不打印日志。

0.2.1 更新重点：

  • Unity hosted KCP now clears pending large-payload reassembly state when Arena sends reliable-message-aborted.
  • Late chunks for the same aborted reliableMessageId are ignored until the reassembly timeout window expires.
  • Published Unity SDK 0.2.1 packages for the main SDK, Mirror transport, and Compliance modules.

下载后可以用 SHA256SUMS 做校验，命令：

Terminal window
sha256sum -c SHA256SUMS

Windows 下可以用 PowerShell 对比：

Get-FileHash -Algorithm SHA256 .\cn.indiegp.sdk.unity-0.2.14.unitypackage

当前可用版本

Section titled “当前可用版本”

Unity

Section titled “Unity”
版本 文件 用途 / 何时需要 下载
0.2.14 cn.indiegp.sdk.unity-0.2.14.unitypackage Unity 主包，常规 Unity 接入必需；包含初始化、授权、正版校验、成就、房间、实时消息和状态同步等基础能力。 下载
0.2.14 cn.indiegp.sdk.unity.mirror-transport-0.2.14.unitypackage（可选） Mirror 传输层适配。只有项目已使用 Mirror，并且要把 Mirror 网络接入 IGP 房间时需要。 下载
0.2.14 cn.indiegp.sdk.unity.compliance-0.2.14.unitypackage（可选） 实名认证与防沉迷模块。只有需要读取实名/防沉迷状态、年龄段或剩余可玩时长时需要。 下载
0.2.14 cn.indiegp.sdk.unity.game-kit-0.2.14.unitypackage（可选） GameKit 扩展模块。只有接入排行榜、分享等 GameKit 能力时需要。 下载
0.2.14 SHA256SUMS 校验文件，用于确认下载包完整性。 查看
0.2.6 cn.indiegp.sdk.unity-0.2.6.unitypackage Unity 主包，常规 Unity 接入必需；包含初始化、授权、正版校验、成就、房间、实时消息和状态同步等基础能力。 下载
0.2.6 cn.indiegp.sdk.unity.mirror-transport-0.2.6.unitypackage（可选） Mirror 传输层适配。只有项目已使用 Mirror，并且要把 Mirror 网络接入 IGP 房间时需要。 下载
0.2.6 cn.indiegp.sdk.unity.compliance-0.2.6.unitypackage（可选） 实名认证与防沉迷模块。只有需要读取实名/防沉迷状态、年龄段或剩余可玩时长时需要。 下载
0.2.6 cn.indiegp.sdk.unity.game-kit-0.2.6.unitypackage（可选） GameKit 扩展模块。只有接入排行榜、分享等 GameKit 能力时需要。 下载
0.2.6 SHA256SUMS 校验文件，用于确认下载包完整性。 查看

GameMaker

Section titled “GameMaker”
版本 文件 用途 / 何时需要 下载
0.2.14 igp-gamemaker-sdk-0.2.14.zip（预览） GameMaker 预览包，包含 Windows runtime、bridge 与示例工程。 下载
0.2.14 SHA256SUMS 校验文件，用于确认下载包完整性。 查看
  • 使用方式：解压后使用 GameMaker 打开 samples/gamemaker/windows-auth-achievements/project/IGP.WindowsAuthAchievements.yyp，并参考 GameMaker Quick Start。

Godot

Section titled “Godot”

Godot 适配层尚未正式对外发布，见 Godot 概览。

Unreal

Section titled “Unreal”

Unreal 适配层尚未开始。

升级策略

Section titled “升级策略”

Preview 阶段的升级建议：

  • 固定版本：记录当前使用的 Unity / GameMaker SDK 版本，不要直接指向 latest/。
  • 版本记录：每次升级之前备份旧的 .unitypackage / .zip，方便回滚。
  • 校验：下载后执行一次 sha256sum -c SHA256SUMS，确认文件完整。
  • 接口变更：预览阶段的 patch 版本仍可能有破坏性变更，发版时会在 release notes 里注明。