PICO Emulator 是一款能在 PC 端模拟 PICO OS 环境的工具。你可以在 PICO Emulator 中调试应用。
PICO Emulator 提供以下能力：
* 安装被打包为 .apk 文件的空间应用。
* 向已安装的空间应用推送 .obb 文件或 .bundle 文件。
* 模拟眼手交互或手柄交互。
* 通过手柄按键模式把 PC 键盘映射为相应的手柄按键。
* 支持 UI 调试，包括性能数据模式、包围盒模式、碰撞体模式和坐标轴模式。
* 支持 MR 模拟功能，包括视频透视模拟和空间网格模拟。
## 系统要求
确保你的操作系统满足以下要求：
| **操作系统** | **要求** |
| --- | --- |
| macOS | * **版本**：v14.0 及以上
* **RAM**：不小于 16 GB
* **磁盘可用空间**：不少于 40 GB
* **CPU**：不低于 M1 Pro |
| Windows | * **版本**：Windows10 64 位及以上
* **RAM**：不小于 16 GB
* **磁盘可用空间**：不少于 40 GB
* **CPU**：不低于 Intel Core i5
* **GPU**：不低于 NVIDIA GeForce GTX 1060 |
## 支持运行的 SDK 功能
受硬件与运行环境限制，PICO Emulator 暂不支持运行 PICO Unity SDK 的部分功能，目前支持运行的功能如下：
| | **PICO Spatial 模式** | **PICO XR 模式** | **Unity OpenXR 模式** |
| --- | --- | --- | --- |
| **渲染** | - | * 启动画面
* 画面淡入淡出
* 合成层
* 多视图渲染
* 多重采样抗锯齿（MSAA）
* 焦点感知
* 应用空间扭曲（AppSW） | * 启动画面
* 画面淡入淡出
* 合成层
* 多视图渲染
* 多重采样抗锯齿（MSAA）
* 焦点感知
* 应用空间扭曲（AppSW） |
| **交互** | 系统键盘（Full Space & Shared Space） | * XR Interaction Toolkit
* 系统键盘
* 原点追踪
* 眼动追踪 | * XR Interaction Toolkit
* 系统键盘
* 原点追踪
* 眼动追踪 |
| **混合现实（PICO API）** | - | * 视频透视
* 空间锚点
* 场景标定
* 空间网格
* 平面检测 | * 视频透视
* 空间锚点
* 场景标定
* 空间网格 |
| **AR Foundation** | * Session（仅 Full Space）
* 相机（仅 Full Space）
* 锚点（仅 Full Space）
* 网格（仅 Full Space） | * Session
* 设备追踪
* 相机
* 锚点
* 网格 | 设备追踪 |
| **其他** | * 内容保护（Full Space & Shared Space）
* 平台服务（Full Space & Shared Space）
* 企业服务（Full Space & Shared Space） | * 空间音频
* 内容保护
* 平台服务
* 企业服务 | * 空间音频
* 内容保护
* 平台服务
* 企业服务 |
## 安装并启动 PICO Emulator
通过 PICO Spatial Plugin 来安装 PICO Emulator，然后通过 Android Studio 的 Device Manager 来启动 PICO Emulator。
### 第一步：安装 Android Studio
在安装 PICO Spatial Plugin 前，你需要安装指定的 Android Studio 和 Android SDK package。
1. 前往 [Android Studio 下载归档页面](https://developer.android.google.cn/studio/archive)。
2. 将页面的显示语言切换为 **English**，阅读条款和条件，然后单击页面底部的 **I agree to the terms** 按钮。
网站会显示 Android Studio 归档的下载文件列表。
3. 找到任意一个 **2025.1.1、2025.1.2、2025.1.3 或 2025.1.4** 的版本，根据你的操作系统下载对应的安装包，并完成安装。
4. 打开 Android Studio，然后跟随设置向导完成初始设置。
5. 前往 **Settings** > **Languages & Frameworks** > **Android SDK** > **SDK Platforms**，然后勾选右下角的 **Show Package Details** 选项。
**SDK Platform** 页签中显示各个 Android SDK 版本包含的软件包以及安装状态。
6. 展开 **Android 15.0 ("VanillaIceCream)** 目录，检查是否已安装 **Android SDK Platform 35** 和 **Sources for Android 35**。若未安装，勾选这两个选项，然后单击右下角的 **OK** 按钮进行安装。
### 第二步：安装 PICO Spatial Plugin
1. 从 [PICO 开发者官网](https://developer-cn.picoxr.com/resources/) 下载 PICO Spatial Plugin 的 .zip 包。
目前 PICO Spatial Plugin 仅支持离线安装，后续会支持直接从 IntelliJ 插件市场下载和安装。
2. 打开 Android Studio。
3. 前往 **Plugins** > **齿轮图标** > **Install Plugin from Disk...**，然后导入 Spatial Plugin 的 .zip 包。
直接导入你下载的原始 .zip 包，切勿解压。
导入完成后，Spatial Plugin 会出现在 Plugin 列表中。
4. 单击 **Restart IDE** 按钮，然后在弹出的确认窗口单击 **Restart** 重启 Android Studio。
Android Studio 重启完成后，Spatial Plugin 就被成功地安装到了你的 Android Studio 中。
### 第三步：通过 PICO Spatial Plugin 安装 PICO Emulator
安装 PICO Spatial Plugin 后，你可以在 Android Studio 通过它来安装 PICO Emulator。
1. 在 Android Studio 中，前往 **Settings...** > **Languages & Frameworks** > **PICO Spatial Tools**。
2. 选中 **PICO Emulator**，然后点击右下角的 **Apply** 按钮进行安装。
PICO Emulator 会被安装到 **PICO Spatial Tools Location** 参数所指定的路径。
### 第四步：通过 Android Studio 启动 PICO Emulator
1. 在 Android Studio 中，新建一个 PICO Spatial 项目并将其打开。
2. 在 **Device Manager** 中，单击加号，选择 **Create PICO Emulator**。
3. PICO Emulator 添加完成后，点击右侧的启动按钮启动 PICO Emulator。
##