Unity 安装

本页仅说明如何将 SDK 安装到 Unity 工程。安装完成后的接入主流程请查看 Unity Quick Start。

前置条件

• Windows 10 及以上
• Unity 2022.3 LTS 或更高
• 已注册的 appId（找 IGP 运营获取）

方式：导入 Unity Package（推荐）

这是当前 Preview 阶段的默认分发方式。导入后 SDK 会放在 Assets/IGP.UnitySDK 下，便于 Unity 工程直接识别和编译。

1. 下载安装包

从 Release Notes 选择需要锁定的版本。以当前 Unity SDK 版本 0.1.6 为例，需要下载：

• cn.indiegp.sdk.unity-0.1.6.unitypackage —— 主包（必需）
• cn.indiegp.sdk.unity.mirror-transport-0.1.6.unitypackage —— Mirror 传输层（可选）
• cn.indiegp.sdk.unity.compliance-0.1.6.unitypackage —— 实名认证与防沉迷模块（可选）
• cn.indiegp.sdk.unity.cloud-archive-0.1.4.unitypackage —— Cloud Archive 模块（可选）

下载后请与同目录的 SHA256SUMS 校验一致。

2. 先安装 Unity 依赖

主包依赖 Unity 官方包 Newtonsoft JSON 和 UGUI。如果工程里还没有这两个包，请先在 Unity Editor 中打开 Window → Package Manager，通过 Add package by name... 添加：

• com.unity.nuget.newtonsoft-json
• com.unity.ugui

也可以直接在 Packages/manifest.json 的 dependencies 中加入：

"com.unity.nuget.newtonsoft-json": "3.2.1",
"com.unity.ugui": "1.0.0"

3. 导入 SDK 包

在 Unity Editor 中执行：

1. Assets → Import Package → Custom Package...
2. 选择 cn.indiegp.sdk.unity-0.1.6.unitypackage
3. 确认导入全部文件

如果项目需要实名认证与防沉迷，再用同样方式导入 cn.indiegp.sdk.unity.compliance-0.1.6.unitypackage。

如果项目需要 Cloud Archive，再用同样方式导入 cn.indiegp.sdk.unity.cloud-archive-0.1.4.unitypackage。

如果项目已经在用 Mirror，再用同样方式导入 cn.indiegp.sdk.unity.mirror-transport-0.1.6.unitypackage。导入前请确认项目本身已经安装 Mirror。

提示

建议先导入主包并确认 Console 没有编译错误，再导入可选包。可选包依赖主包。

验证安装

Unity Editor 打开后：

1. 工程里能看到 Assets/IGP.UnitySDK
2. 如导入可选包，能看到对应的 Assets/IGP.UnitySDK.* 目录
3. Console 没有关于 IGP.UnitySDK 的编译错误
4. Assets/IGP.UnitySDK/package.json 中的版本号与下载版本一致

安装完成后，请继续执行 Unity Quick Start。