Plug-in and play: Add Apple frameworks to your Unity game projects
Graphics & Games 进阶 20m

即插即用：将 Apple 框架集成到你的 Unity 游戏项目

Plug-in and play: Add Apple frameworks to your Unity game projects

2022年6月6日

在 Apple 官方观看视频

一句话判断

如果你在做 Unity 游戏并且目标平台包含 iOS/macOS，这套官方插件几乎是你绕不开的起点。

这场 Session 讲了什么

Apple 在 WWDC 2022 上正式发布了一套面向 Unity 开发者的插件集合，涵盖六个核心模块：

  • Apple.Core：基础依赖，统一管理所有插件的构建设置、平台配置和安全选项。每个插件导入前必须先装它。
  • GameKit（Game Center）：提供玩家认证、排行榜、成就、多人匹配等社交游戏功能。
  • Game Controller：支持 MFi 和第三方手柄的输入映射、按键图标（glyphs）获取。
  • Accessibility：让 Unity 游戏接入 VoiceOver、Dynamic Type 等系统级无障碍能力。
  • Core Haptics：接入 Apple 数据驱动的触觉反馈系统，实现细腻的震动效果。
  • PHASE：几何感知的空间音频引擎，让声音随 3D 场景自动变化。

整个项目的设计哲学是”一个插件对应一个原生框架”，用 C# 脚本尽可能直接映射底层 API。这意味着你学插件的过程就是在学原生框架本身。

值得深挖的点

构建流程的全链路设计值得关注。项目根目录的 build.py 一键完成原生库编译、Unity meta 文件更新、插件打包和测试构建。完整构建需要 Xcode + Python3 + npm + Unity 四件套，这在跨平台工具链中算是比较克制的选择。

Apple.Core 的职责边界设计得很聪明。它不只是一个设置面板，还承担了 asset processor（确保导入时平台配置正确）和 post-process build script（确保 Xcode 中间项目正确引用原生库）两个角色。这种”胶水层”的思路可以借鉴到其他跨平台场景。

GameKit 插件的组件化思路也值得注意。Session 中用了一个 GameManager Component 来封装 GKLocalPlayer 的生命周期管理，认证只在游戏启动时做一次，后续所有 Game Center 交互都通过这个组件来分发。这种设计对 Unity 开发者来说很自然。

代码片段

GameKit 玩家认证的典型模式：

// GameManager 组件定义
public class GameManager : MonoBehaviour
{
    private GKLocalPlayer localPlayer;

    void Start()
    {
        // 连接 Game Center 服务
        localPlayer = new GKLocalPlayer();
        
        // 认证玩家（整个生命周期只需一次）
        localPlayer.Authenticate((player) => {
            // 查询玩家限制条件
            // 包括内容年龄分级、多人模式、通信限制等
            var restrictions = player.GetRestrictions();
            HandleRestrictions(restrictions);
        });
    }
}

导入 Apple.Core 的流程：

# 一键构建所有插件
python3 build.py

# 产物在 build/ 目录下，通过 Unity Package Manager
# 选择 "Add package from tarball" 导入

最佳实践

  • 导入顺序不能错：Apple.Core 必须第一个导入，其他插件都依赖它。
  • 用 Package Manager 管理：所有插件都是标准 Unity Package，走 tarball 导入流程，不要手动拷贝文件。
  • 构建设置集中管理：在 Project Settings > Apple Build Settings 中统一配置最低系统版本和安全选项，避免散落在各处。
  • 认证做一次：Game Center 认证在游戏启动时完成即可，不需要每次功能调用都重新认证。
  • 关注 Player Restrictions：不同年龄段玩家的限制条件不同，在多人模式和通信功能上线前务必检查。

还有什么值得关注

  • 这套插件目前是初始版本，功能覆盖还比较基础，后续迭代可能会补充更多框架
  • PHASE 空间音频和 Core Haptics 的组合能做出相当沉浸的游戏体验，特别适合 AR/VR 场景
  • Accessibility 插件的存在说明 Apple 对游戏无障碍化的重视程度在上升，这也可能是 App Review 的未来方向
  • 插件源码全部开源在 GitHub，有定制需求的团队可以直接 fork 修改
WWDC 2022