Unity 概览

IGP Unity SDK 用于将 Unity 游戏接入 IGP 平台的正版校验、游戏数据同步、成就、实名认证与防沉迷能力。

本页仅说明 Unity 引擎相关细节。具体功能接入方式，请优先查看“按功能使用”中的对应页面。

功能列表

正版校验：在游戏启动时确认当前玩家是否在 IGP 平台上合法持有这款游戏，支持 authorized_online / authorized_offline 两种结果（协议层对应 RequestGameAuthorization）。
桌面客户端连接：连接本机 IGP 桌面客户端，支持重试、按需启动和能力查询。
游戏数据同步：进入对局后，通过 RoomNode KCP/TCP reliable 与可选 UDP unreliable 通道传输实时消息和游戏数据。
状态与 RPC：跨端同步玩家状态，点对点调用房间内其他玩家的逻辑。
成就：解锁与进度上报。
实名认证与防沉迷模块：可选接入实名认证与防沉迷状态事件、年龄段读取、剩余可玩时长读取。
Mirror 传输层：为已经使用 Mirror 的 Unity 项目提供可选传输层包。
GameKit / Leaderboard / Share：可选接入排行榜、分享等 GameKit 能力。

接入前提

Unity 2022.3 LTS 或更高
Windows 10 及以上
使用 Desktop 能力时本机安装 IGP 桌面客户端
IGP 运营分配的 appId

包组成

四个公开模块按需选择，每个模块都提供 Unity Package 与离线 UPM tarball：

包名	用途	适用项目
`cn.indiegp.sdk.unity`	主包，包含 runtime 与 Editor 工具	所有接入项目都必装
`cn.indiegp.sdk.unity.multiplayer`	RoomNode Game data plane、Realtime、KCP/TCP/UDP，以及可选 Mirror 集成	需要游戏数据同步或 Mirror 的项目
`cn.indiegp.sdk.unity.compliance`	实名认证与防沉迷辅助入口	需要读取实名认证与防沉迷状态和事件的项目
`cn.indiegp.sdk.unity.game-kit`	GameKit 扩展能力，当前包含 Leaderboard 排行榜和 Share 分享	需要接入排行榜、分享等 GameKit 能力的项目

主包的 Assets/IGP.UnitySDK/Samples 提供 Achievements。Multiplayer 包的 Assets/IGP.UnitySDK.Multiplayer/Samples 提供：

RealtimeMessaging —— 实时 / state / RPC

开始接入

Host Session 平台由 Core 在初始化时根据当前 Unity 运行平台自动确定：按 Desktop、Mobile 优先级判断，随后只创建一个 runtime，无需用户配置；attach 失败不会切换平台。Multiplayer 不感知该平台，可以通过无参数入口向当前 Core provider 请求 descriptor，也可以通过重载显式接收调用方 descriptor；两种入口建立的 Runtime 都只连接 RoomNode Game lane。

装包：Unity 安装
按接入目标完成最小验证流程：Unity Quick Start
按项目能力完成正式接入：Unity 对接指南
确认基础启动流程：启动与连接
按目标功能继续看：
做对应能力的完整检查：联调与测试
如需在 Editor 中调试 desktop 能力：Unity 调试
查看最新版本号与下载链接：Release Notes

当前限制

Preview 阶段：接口仍可能有不兼容改动，请锁定具体版本号使用。
仅支持 Windows 10 及以上。其他操作系统不在支持范围内。
Host descriptor 获取失败只记录 warning，Core 仍可初始化；此时 IsRuntimeCreated == false，可通过显式接口重试。
当前正式验证仍只覆盖 Windows Desktop；Mobile Host provider 尚未进入公开支持范围。

商标与版权声明

本页面和 IGP Unity SDK 未由 Unity Technologies 或其关联公司赞助，也不代表与 Unity Technologies 或其关联公司存在官方关联或背书。

Unity、Unity 标志及其他 Unity 商标是 Unity Technologies 或其关联公司在美国及其他地区的商标或注册商标。Unity 相关商标、标志和素材的使用应遵循 Unity 官方商标指南。