从零开始的PICO教程(1)Pico游戏开发项目配置
文章目录
- 从零开始的PICO教程(1)Pico游戏开发项目配置
-
- 一、前言
- 二、成为Pico开发者
- 三、导入PICO的SDK
-
- [1、PICO设备开启 "开发者" 模式](#1、PICO设备开启 “开发者” 模式)
- 2、创建Unity项目
- [3、导入 PICO Unity Integration SDK](#3、导入 PICO Unity Integration SDK)
- 四、完成项目配置
-
- [1、启用 PICO XR 插件](#1、启用 PICO XR 插件)
- 2、设置包名及版本号
- 3、完成其他设置
- [4、添加应用 ID](#4、添加应用 ID)
- 五、结束
一、前言
1、大纲
经过该教程你将学会
- 配置好Pico游戏开发需要的环境
二、成为Pico开发者
只有成为Pico开发者才可以发布可以在Pico上运行的游戏,所以这也是我们开始Pico开发生涯的第一步了。
1、注册 PICO 开发者帐号
你需要注册一个 PICO 开发者帐号,以便在 PICO 开发者平台管理应用。对于中国大陆地区,目前仅支持通过手机号进行注册。
-
前往 PICO 开发者平台。
-
点击 立刻加入 ,跳转至登录页面。
-
选择你的帐号所在区域为 中国大陆 、勾选 我确认已阅读并同意 PICO 开发者平台使用条款。
点击 注册
-
根据页面提示完成账号注册。
注册成功后,参考下文中的步骤创建组织。
2、创建组织
在 PICO 开发者平台中,组织是指在 PICO 商店发布应用的主体。组织名称将被默认作为发行商,显示在 PICO 商店中的应用详情页面。一个开发者帐号可创建多个组织。
-
使用先前注册的开发者帐号登录 PICO 开发者平台。
-
点击页面中间的 创建组织 。
创建新的组织 窗口将弹出。
-
在 创建新的组织 窗口中,根据页面提示,填写组织基础信息(带 * 标记的字段为必填项)
-
点击 创建。
创建完成后,你将看到以下弹窗:
注:若你仅想体验完整的的应用开发流程,可跳过资质认证相关步骤,直接参考 "创建应用" 部分,创建属于你的第一个应用。若你需要体验完整的应用分发流程,需完成资质认证。提交认证后,你可以继续创建应用。 -
点击 去填写 。
你将进入 组织详细信息 编辑页,需继续完成资质认证。
如果只是个人开发者:提供姓名、身份证件、手机号等即可 -
信息录入完毕后,点击页面右下角的 提交资质 。
提交后,资质信息将进入审核流程,你可以继续创建应用。若你退出开发者平台界面,可再次登录,然后点击左侧导航栏处的 设置 > 组织详细信息 来查看审核状态。
审核通过后,资质信息便无法修改。若审核未通过,需前往主体资质认证页面,然后点击右上角的 修改认证信息 进行修改。修改完成后需再次提交,资质信息将再次进入审核流程。
3、创建应用
"应用" 是你在 PICO 商店的最终发布物,需在 PICO 开发者平台进行创建。步骤如下:
-
选择已创建的组织。
-
进入 我的应用 页面,点击页面中间的 创建应用 或页面右上角的 创建 。
-
在 创建新的应用 弹窗中,输入 应用名称,并选择 发布平台:
- 3 DOF 平台
- 6 DOF 平台 (推荐)
-
点击 创建。
创建完成后,你可以返回 我的应用 页面,查看创建的应用 。
查看创建的应用保存该应用的APP ID 。后续Unity配置环境要用到这个,这个也是为什么要注册PICO账户成为开发者的原因之一。
三、导入PICO的SDK
1、PICO设备开启 "开发者" 模式
开发 PICO XR 应用无需额外购买开发机,只需为市售 PICO VR 一体机开启 "开发者" 模式即可将设备转换为开发机使用。
-
开启 PICO VR 一体机。
-
前往 设置 > 通用 > 关于本机。
-
光标移至 软件版本号 并连续点击多次,直到左侧导航栏下方出现 开发者 选项。
-
点击 开发者,进入开发者选项界面。
-
打开右上角的 USB调试开关。
注:这个后续打包运行开发的游戏的时候会用到,跳过就不能连着PC设备打包好发送到PICO并运行一条龙了
2、创建Unity项目
导入 SDK 前,需要在 Unity Hub 中新建项目。步骤如下:
-
在 Unity Hub 主页,点击 项目 > 新项目。
你将进入新建项目页。
-
选择 核心模板 > 3D。
-
点击 创建项目。
- 注:项目名称和存储目录不能包含中文字符。
项目初始化完毕后,你将进入 Unity 编辑器页面。
3、导入 PICO Unity Integration SDK
- 前往开发资源页面,下载最新版本的PICO Unity Integration SDK。
- 解压所下载的 SDK 压缩包。
你将会得到一个包含 package.json 文件的文件夹。 - 返回 Unity 编辑器页面。
- 在上方菜单栏处,选择 Windows > Package Manager。
- 在 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 文件中填充公司名和产品名。版本号用于向用户展示应用的具体版本。每次应用发版前,请确保新版本号比当前版本号更高。按以下步骤修改应用包名和版本号:
- 在 Project Settings 窗口中,点击左侧导航栏处的 Player。
- 在 Player 面板处,设置 Company Name、Product Name 和 Version。
- 设置图标(图标需要上传到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)。
步骤如下:
-
点击 Player 面板上的 安卓图标 。
-
展开 Other Settings 标签页。
-
在 Identification 设置区域,完成以下操作:
a. 将 Minimum API Level 设置为 Android 10.0 (API Level 29) 。
b. 将 Target API Level 设置为 Automatic (highest installed) 。一般已默认为该设置。
系统将自动使用本地所下载的最高版本 Android SDK 来编译应用。
-
在下方的 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
- 前往 PICO 开发者平台。
- 在 我的应用 页面,点击先前创建的应用的卡片。
- 在左侧导航栏处,点击 API 。
API 页面展示 APP ID 字段。
填入应用 ID
- 返回 Unity 编辑器,点击上方菜单栏处的 PXR_SDK > Platform Settings 。
你将看到 PICO Platform Settings 窗口。 - 填入 APP ID,然后关闭窗口。
五、结束
走到这里就算正式完成Pico游戏开发的前置项目配置流程。下面将开始进行正式的游戏开发并打包至Pico上运行。
该教程由:深圳技术大学 -- 元宇宙开发者协会 整理撰写提供。协会邮箱:2981007652@qq.com
参考文档:
PICO官网快速开始Demo