一、快速开始
1.下载、导入
官方下载网址:
开发资源 | PICO 开发者平台 (pico-interactive.com)
下载这一个就可以进行开发了。
- 解压所下载的 SDK 压缩包。你将会得到一个包含 package.json 文件的文件夹。
- 返回 Unity 编辑器页面。
- 在上方菜单栏处,选择 Windows > Package Manager。
- 在 Package Manager 窗口中,点击 + > Add package from disk。
- 选择 package.json 文件并导入。导入完成后,你将看到 PXR SDK Setting 窗口,关闭即可。
这里如果没有安装Android的话需要安装一下。
2.配置项目
第一步:启用 PICO XR 插件
启用 PICO XR 插件,以便在应用内接入 SDK 提供的 XR 能力。步骤如下:
- 从上方菜单栏处,选择 Edit > Project Settings。
- 在 Project Settings 窗口中,点击 XR Plug-in Management > 安卓设置图标。
第二步:设置 Player 相关参数
包名是用来识别安卓应用的重要标识之一,格式为 com.companyName.productName。导出 APK 文件时,Unity 编辑器会根据你的设置,自动在 AndroidManifest 文件中填充公司名和产品名。版本号用于向用户展示应用的具体版本。每次应用发版前,请确保新版本号比当前版本号更高。按以下步骤修改应用包名和版本号:
- 在 Project Settings 窗口中,点击左侧导航栏处的 Player。
- 在 Player 面板处,设置 Company Name、Product Name 和 Version。
需顺利开发 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)。
在这里就不说上架的事情了,需要的可以自行去看Pico官方的文档。
3.创建一个 XR 场景
第一步:升级 XR Interaction Toolkit 并导入示例文件
搭建基础 XR 场景需要用到 Unity 提供的基础功能和组件。其中,XR Interaction Toolkit 是 Unity 提供的高级工具包,包含许多跨平台的 XR 交互功能。PICO Unity Integration SDK 已自动使用旧版本(0.9.4-preview)的 XR Interaction Toolkit。升级后,你可以获得 Unity 提供的新资源包。
- 从上方菜单栏处,选择 Windows > Package Manager。
- 在 Package Manager 窗口中,点击 Packages > Unity Registry。列表中将展示 Unity Registry 中提供的工具包。
- 在列表中找到 XR Interaction Toolkit,并将其展开。
-
你将看到该工具包的不同版本。
- 点击 See other versions 展开版本列表。
- 从列表中选择 2.0.0 或以上版本,然后点击窗口右下角的 Update to version_number 按钮。
- 升级完成后,再次前往 Windows > Package Manager > XR Interaction Toolkit。
- 展开右侧的 Samples 面板。
- 点击 Import,导入 Starter Assets 和 XR Device Simulater 示例文件。
示例文件
说明
Starter Assets
该示例文件默认位于 Assets/Samples/XR Interaction Toolkit/[version]/Starter Assets 目录下,提供了一套示范配置文件,包括一套默认的输入动作和预设。
XR Device Simulator
XR 设备模拟器,提供用于模拟 XR 头戴和手柄的资产,默认位于 Assets/Samples/XR Interaction Toolkit/[version]/XR Device Simulator 目录下。该示例文件允许通过鼠标和键盘输入来操控头戴和手柄。文件夹内包含与模拟器配套使用的示例 Binding,以及一个可以在场景中快速使用的预制体。
第二步:创建VR场景
新建项目后,Unity 已默认在项目中创建并打开了一个 SampleScene。该 SampleScene 中仅包含方向光(Directional Light)和一个普通摄像机(Main Camera)。
摄像机可以捕捉虚拟世界并将其在显示器上展示。通过自定义摄像机参数和操控摄像机,可以让应用呈现独一无二的画面。场景对摄像机数量没有限制。你可以自行设置各个相机的位置和渲染顺序,使其能够在屏幕上任意位置以任何顺序渲染整个场景,或仅渲染场景中的部分内容。
若想在头戴上正确显示 3D VR 画面,需为左右眼各添加一个普通摄像机。XR 摄像机是 XR Interaction Toolkit 中的一个默认组件,可以同时渲染左右眼画面并在头戴上呈现。此外,作为 XR 应用体验的基础,随着头戴和身体的移动,XR 摄像机能够实现 3DoF 或 6DoF 移动。
按以下步骤将场景中的普通摄像机替换为 XR 摄像机:
- 在 Hierarchy 窗口中,右击默认添加的 Main Camera,然后点击 Delete 将其删除。
- 点击 + > XR > XR Origin (VR),将 XR Origin 添加至场景。
XR Origin 物体包含以下元素: - 选中 XR Origin。搜索 PXR_Manager 脚本,然后双击将其添加。
- 在 Hierarchy 窗口中,点击 + > 3D Object > Plane。
第三步:配置手柄
除 XR 摄像机外,手柄也是 XR 应用的重要组成部分。用户可以通过手柄与虚拟世界进行互动,享受沉浸式 XR 体验。PICO Unity Integration SDK 为开发者提供了默认的手柄模型,包括 LeftControllerModel 和 RightControllerModel。你可以将它们添加至应用中,并让它们随着真实手柄的移动而移动。
按以下步骤配置 PICO 默认手柄模型:
- 在 Hierarchy 窗口中,展开 XR Origin > Camera Offset。
- 选中 LeftHand Controller。
- 在 Inspector 窗口中,点击 XR Controller (Action-Based) 面板右上角的 预设 图标。
- 在 XR Controller (Action-Based) 脚本区域找到 Model Prefab 设置项。(安装同样的步骤配置右手)
4.运行
相信很多人都没有VR设备然后对VR开发学习的,所以这里讲没有VR设备,在电脑上进行运行。
勾选Project Setting->XR Interaction Toolkit->Use XR Device Simulator in Scenes。
二、XR Device Simulator操作
XR 设备模拟器,提供用于模拟 XR 头戴和手柄的资产,默认位于 Assets/Samples/XR Interaction Toolkit/[version]/XR Device Simulator 目录下。该示例文件允许通过鼠标和键盘输入来操控头戴和手柄。文件夹内包含与模拟器配套使用的示例 Binding,以及一个可以在场景中快速使用的预制体。
快捷键作用
Tab:切换头显和手柄,依次顺序:头显—>左手柄—>右手柄
U:直接切换为头显
T/Y:T为直接切换左手柄,Y为直接切换右手柄
WSAD:上下左右移动
Q/E:Q为下降,E为上升
\:鼠标隐藏锁定
R:在手柄中:Translate为手柄移动,Rotate为射线移动
左边Shift键:直接切换左手柄
空格键:直接切换右手柄
HMD(头显)
鼠标左右移动模拟人体身躯左右旋转(手柄跟随视角一起旋转,上下移动手柄不跟随)
按住鼠标右键模拟人体头部左右旋转(手柄不跟随视角一起旋转)
Controller(手柄)
G:点击确认/抓取
IKJL:另外一个手柄上下左右移动