PinK 用户手册

外观

在Pink中构建Unity工程到SUD游戏平台 ​

使用 SUD Unity 插件可以把 Unity 项目导出为适配 SUD 平台的目录。导出完成后，在 PinK 中选择该目录并生成可发布的 .sp 包。

安装并打开 Unity 插件 ​

下载插件：sud-unity-plugin-v1.0.0.3.unitypackage

  1. 打开 Unity 项目，选择“Assets > Import Package > Custom Package...”。也可以把 .unitypackage 文件直接拖入编辑器。
  2. 选择下载的 .unitypackage 文件，在导入窗口中选择“Import”。
  3. 确认 Assets 目录下出现 sud-unity-plugin 文件夹。
  4. 选择“SUD 小游戏 > 转换小游戏”打开插件窗口。
Unity 编辑器中的 SUD 小游戏入口
Unity 编辑器中的 SUD 小游戏入口
SUD Unity 插件窗口
SUD Unity 插件窗口
SUD Unity 插件构建窗口
SUD Unity 插件构建窗口

配置构建 ​

导出路径 ​

选择“选择”，设置构建产物的导出目录。构建完成后，相关文件会写入该目录。

基础配置 ​

配置项说明
Development Build勾选后导出 Debug 版本，便于调试；不勾选则导出体积更小的 Release 版本。
Color Space设置颜色空间，通常保持项目默认值。
Texture Compression按目标平台选择纹理压缩格式，例如 ETC2。
Exception Support设置异常支持级别，通常保持默认值。

插件会自动固定以下 WebGL 配置，无需手动修改：

配置项固定值说明
Compression FormatDisabled不使用 Gzip 或 Brotli 压缩。
Data CachingDisabled不使用浏览器缓存。

启动资源 CDN ​

需要减小游戏主包体积时，勾选“启用启动资源 CDN”。开启后，Unity .data 资源会通过 CDN 加载。

在“启动资源 CDN 地址”中填写 CDN 根地址，例如：

text
https://example.com/game/

导出后，将 remote-assets 目录下的 Build 文件夹上传到该 CDN 根地址：

text
remote-assets/Build/

启动 Loading ​

启用启动资源 CDN 后，可以选择一张游戏启动阶段的 Loading 背景图。“选择”用于添加图片，“清除”用于移除图片。

  • 图片按比例铺满屏幕并居中裁剪。
  • 图片宽度或高度不能超过 2048 px。
  • 资源已缓存时会复用本地缓存。

Scenes In Build ​

展开 Scenes In Build，选择参与构建的场景。至少保留一个场景，否则无法导出。

开始导出 ​

  1. 完成配置后，选择“导出”。
  2. 在 Unity Console 中查看构建日志。
  3. 构建完成后，检查自动打开的输出目录。

注意：首次构建 WebGL 项目通常需要几分钟到几十分钟。构建期间不要关闭 Unity。

检查导出产物 ​

输出目录包含以下两个文件夹：

目录用途
webgl/Unity 原始 WebGL 产物，可通过 index.html 调试。
sud/供 PinK 打包和发布的 SUD 小游戏目录。

sud 目录通常包含以下文件：

text
sud/
├── main.js
├── unity_adapter.js
├── Build/
│   ├── *.loader.js
│   ├── *.framework.js
│   ├── *.data
│   └── *.wasm
└── StreamingAssets/

常见问题 ​

导出失败 ​

  • 查看 Unity Console 中的错误日志。
  • 确认 Assets/sud-unity-plugin 目录存在且完整。
  • 确认 Scenes In Build 中至少选择了一个场景。
  • 选择“手动清理缓存”后重新导出。

导出后运行异常 ​

确认 sud/ 中包含 main.js 和 unity_adapter.js，并检查 sud/Build/ 中的 loader.js、framework.js、data 和 wasm 文件是否完整。也可以先打开 webgl/index.html，排查 Unity WebGL 构建本身的问题。

切换 Debug 或 Release 后构建异常 ​

选择“手动清理缓存”，然后重新导出。

PinK 内导入构建 ​

选择目录前，确认目录存在、可写，并且根层级包含 main.js。

三方引擎项目已在 Unity 等引擎中完成编译和 SUD 平台适配，因此在 PinK 中只需打包，不会再次编译。

注意：如果 main.js 位于更深一层的子目录，请直接选择该子目录。目录校验失败时，PinK 会提示重新选择。

  1. 在 PinK 中打开从 Unity 导出的项目目录。
  2. 打开“项目 > 三方构建”。
  3. 配置 SUD 平台参数，然后选择“构建 > 生成”。

成功后可前往 SUD 游戏平台进行查看。

常见问题 ​

提示打包目录无效 ​

确认目录存在、可写，并且当前层级包含 main.js。如果实际项目位于下一层，请选择实际项目目录，而不是它的父目录。

上传 sp 文件时出现 413 ​

413 通常表示 .sp 文件超过服务器允许的上传大小。使用 Release 方式重新编译三方引擎项目，并提高编译优化级别，再重新打包。

PinK 用户手册

Copyright © SUD