从零开始的PICO教程（1）Pico游戏开发项目配置

一、前言

1、大纲

经过该教程你将学会

• 配置好Pico游戏开发需要的环境

二、成为Pico开发者

只有成为Pico开发者才可以发布可以在Pico上运行的游戏，所以这也是我们开始Pico开发生涯的第一步了。

1、注册 PICO 开发者帐号

你需要注册一个 PICO 开发者帐号，以便在 PICO 开发者平台管理应用。对于中国大陆地区，目前仅支持通过手机号进行注册。

1. 前往 PICO 开发者平台。
   

2. 点击 立刻加入，跳转至登录页面。

3. 选择你的帐号所在区域为 中国大陆、勾选 我确认已阅读并同意 PICO 开发者平台使用条款。
   点击 注册

4. 根据页面提示完成账号注册。
   注册成功后，参考下文中的步骤创建组织。

2、创建组织

在 PICO 开发者平台中，组织是指在 PICO 商店发布应用的主体。组织名称将被默认作为发行商，显示在 PICO 商店中的应用详情页面。一个开发者帐号可创建多个组织。

1. 使用先前注册的开发者帐号登录 PICO 开发者平台。

2. 点击页面中间的 创建组织。
   创建新的组织 窗口将弹出。
   

3. 在 创建新的组织 窗口中，根据页面提示，填写组织基础信息（带 * 标记的字段为必填项）

4. 点击 创建。
   创建完成后，你将看到以下弹窗：
   
   注：若你仅想体验完整的的应用开发流程，可跳过资质认证相关步骤，直接参考 ”创建应用“ 部分，创建属于你的第一个应用。若你需要体验完整的应用分发流程，需完成资质认证。提交认证后，你可以继续创建应用。

5. 点击 去填写。
   你将进入 组织详细信息 编辑页，需继续完成资质认证。
   
   如果只是个人开发者：提供姓名、身份证件、手机号等即可

6. 信息录入完毕后，点击页面右下角的 提交资质。
   提交后，资质信息将进入审核流程，你可以继续创建应用。若你退出开发者平台界面，可再次登录，然后点击左侧导航栏处的 设置 > 组织详细信息 来查看审核状态。
   审核通过后，资质信息便无法修改。若审核未通过，需前往主体资质认证页面，然后点击右上角的 修改认证信息 进行修改。修改完成后需再次提交，资质信息将再次进入审核流程。

3、创建应用

“应用” 是你在 PICO 商店的最终发布物，需在 PICO 开发者平台进行创建。步骤如下：

1. 选择已创建的组织。

2. 进入 我的应用 页面，点击页面中间的 创建应用 或页面右上角的 创建。
   

3. 在 创建新的应用 弹窗中，输入 应用名称，并选择 发布平台：

   • 3 DOF 平台
   • 6 DOF 平台 (推荐)

4. 点击 创建。
   创建完成后，你可以返回 我的应用 页面，查看创建的应用。
   
   
   查看创建的应用保存该应用的APP ID。后续Unity配置环境要用到这个，这个也是为什么要注册PICO账户成为开发者的原因之一。

三、导入PICO的SDK

1、PICO设备开启 “开发者” 模式

开发 PICO XR 应用无需额外购买开发机，只需为市售 PICO VR 一体机开启 “开发者” 模式即可将设备转换为开发机使用。

1. 开启 PICO VR 一体机。

2. 前往 设置 > 通用 > 关于本机。

3. 光标移至 软件版本号 并连续点击多次，直到左侧导航栏下方出现 开发者 选项。
   

4. 点击 开发者，进入开发者选项界面。

5. 打开右上角的 USB调试开关。
   
   注：这个后续打包运行开发的游戏的时候会用到，跳过就不能连着PC设备打包好发送到PICO并运行一条龙了

2、创建Unity项目

导入 SDK 前，需要在 Unity Hub 中新建项目。步骤如下：

1. 在 Unity Hub 主页，点击 项目 > 新项目。
   你将进入新建项目页。
   

2. 选择 核心模板 > 3D。

3. 点击 创建项目。

• 注：项目名称和存储目录不能包含中文字符。
  项目初始化完毕后，你将进入 Unity 编辑器页面。

3、导入 PICO Unity Integration SDK

1. 前往开发资源页面，下载最新版本的PICO Unity Integration SDK。
2. 解压所下载的 SDK 压缩包。
   你将会得到一个包含 package.json 文件的文件夹。
3. 返回 Unity 编辑器页面。
4. 在上方菜单栏处，选择 Windows > Package Manager。
5. 在 Package Manager 窗口中，点击 + > Add package from disk。
   
   选择 package.json 文件并导入。
   导入完成后，你将在菜单栏看到 PXR SDK Setting 。
   注：导入时候，遇到什么情况都点左边那个选项（类似同意的意思）

四、完成项目配置

1、启用 PICO XR 插件

启用 PICO XR 插件，以便在应用内接入 SDK 提供的 XR 能力。步骤如下：
从上方菜单栏处，选择 Edit > Project Settings。
在 Project Settings 窗口中，点击 XR Plug-in Management > 安卓设置图标。并勾选PICO

2、设置包名及版本号

包名是用来识别安卓应用的重要标识之一，格式为 com.companyName.productName。导出 APK 文件时，Unity 编辑器会根据你的设置，自动在 AndroidManifest 文件中填充公司名和产品名。版本号用于向用户展示应用的具体版本。每次应用发版前，请确保新版本号比当前版本号更高。按以下步骤修改应用包名和版本号：

1. 在 Project Settings 窗口中，点击左侧导航栏处的 Player。
2. 在 Player 面板处，设置 Company Name、Product Name 和 Version。
3. 设置图标（图标需要上传到Unity项目中）
   
   一开始测试的时候可以先全部默认

3、完成其他设置

其他设置部分主要影响应用的基础编译方式和支持系统版本。若需顺利开发 PICO XR 应用并通过 PICO 商店的上架审核，需要完成以下设置：

• Minimum API Level：设置应用运行所需的最低 Android SDK 版本。PICO 插件支持的最低 Android SDK 版本为 10.0（即 API 等级 29）。若低于该版本，构建应用时会报错。
• Target API Level：设置用于编译应用的目标 Android SDK 版本，所选版本必须等于或高于最低 Android SDK 版本，否则将报错。
• Scripting Backend：设置项目内 C# 代码的编译方式。
• Target Architectures：设置应用的运行环境（即 CPU）。
  步骤如下：

1. 点击 Player 面板上的 安卓图标。
   

2. 展开 Other Settings 标签页。

3. 在 Identification 设置区域，完成以下操作：
   
   a. 将 Minimum API Level 设置为 Android 10.0 (API Level 29)。
   b. 将 Target API Level 设置为 Automatic (highest installed)。一般已默认为该设置。
   系统将自动使用本地所下载的最高版本 Android SDK 来编译应用。

4. 在下方的 Configuration 设置区域，完成以下操作：
   

a. 将 Scripting Backend 设置为 IL2CPP。
与 Mono 相比，IL2CPP 可以更好地支持跨平台应用开发。IL2CPP 后端可以将 MSIL（Microsoft Intermediate Language）代码（例如脚本中的 C# 代码）转换为 C++ 代码，然后通过 C++ 代码生成一个兼容所选开发平台的原生二进制文件（例如 .exe、.apk 或 .xap）。
b. 将 Target Architectures 设置为 ARM64，并取消勾选 ARMv7。
ARM64 允许应用在 64 位环境中运行，以实现更好的应用性能。此外，64 位应用拥有更高的寻址空间（超过 4GB），且支持动态内存分配。

4、添加应用 ID

**应用 ID（APP ID）**是应用的唯一标识。
查看应用 ID

1. 前往 PICO 开发者平台。
2. 在 我的应用 页面，点击先前创建的应用的卡片。
3. 在左侧导航栏处，点击 API。
   API 页面展示 APP ID 字段。
   

填入应用 ID

1. 返回 Unity 编辑器，点击上方菜单栏处的 PXR_SDK > Platform Settings。
   你将看到 PICO Platform Settings 窗口。
2. 填入 APP ID，然后关闭窗口。
   

五、结束

走到这里就算正式完成Pico游戏开发的前置项目配置流程。下面将开始进行正式的游戏开发并打包至Pico上运行。
该教程由：深圳技术大学 – 元宇宙开发者协会 整理撰写提供。协会邮箱：2981007652@qq.com
参考文档：
PICO官网快速开始Demo