XR 开发者社区:https://www.spatialxr.tech/
文章目录
- 📕 下载 Pico SDK
- 📕创建 Unity 工程
- 📕Build Settings
- 📕安装 XR Plug-in Management
- 📕导入 Pico SDK
- 📕导入 XR Interaction Toolkit
- 📕玩家物体配置
- 📕传送交互
- 📕抓取交互
- 📕UI 交互
- 📕程序打包
视频教程:
上半部分:Unity Pico 开发:Pico SDK 适配 XRI 3.x & SDK 下载【全球最新 XR Interaction Toolkit 3.0 开发教程】
下半部分:Unity Pico 开发:导入 SDK & 移动、抓取、UI 交互 & 程序打包 【全球最新 XR Interaction Toolkit 3.0 教程】
XR Interaction Toolkit 系列教程:
XR Interaction Toolkit 系列教程
1.OpenXR与XRI概述【全球最新 Unity VR 系统化入门开发教程】(XR Interaction Toolkit 3.0)
📕 下载 Pico SDK
Pico SDK 下载地址:https://developer-cn.picoxr.com/resources/
下载过后解压压缩包。
Pico Unity Integration SDK:包含了 Pico 开发的底层插件,能把 Unity 程序适配到 Pico 设备,提供 Pico 的特性,如手势追踪、MR 环境感知、空间锚点等 Pico 设备的功能。目前对 Pico 特性的支持是比较多的。
Pico Unity Live Preview Plugin:Pico 串流 SDK。
Pico Unity OpenXR SDK:和 Pico Unity Integration SDK 类似,也是提供了 Pico 开发的底层插件,但它是基于 OpenXR 的,可以在 Unity OpenXR 的设置里添加 Pico 特性的支持,更适合于跨平台的开发,只需在 OpenXR 的设置里勾选不同硬件设备的特性,就能够把相同的程序发布到不同的设备上。但是目前来说该 SDK 更新会比较慢,对 Pico 特性的支持没有 Pico Unity Integration SDK 多,但在未来可能是 Pico 重点发展的一个 SDK。
另外还可以下载 Pico Developer Center(简称 PDC),该软件提供了一些 Pico 的开发者工具,还能够用于串流调试。
本教程将介绍如何使用 Pico Unity Integration SDK 结合 XR Interaction Toolkit 3.x 的版本开发基础的交互功能。教程中用到的 Pico Unity Integration SDK 版本是 3.1.0,从这个版本开始,Pico SDK 将支持 XR Interaction Toolkit 3.0 及以后的版本,XR Interaction Toolkit(简称 XRI) 在 3.0 之前和之后的版本里,开发方式发生了比较大的变化。现在 XRI 3.x 能够开发大部分主流 XR 设备,如 Meta Quest,Pico,Apple Vision Pro。
📕创建 Unity 工程
本教程使用的 Unity 版本是 2022.3.20 f1,Unity 编辑器需要安装 Android Build Support(安卓打包模块)
📕Build Settings
创建 Unity 工程后打开菜单栏的 File > Build Settings,点击安卓标志,点击 Switch Platform,把打包发布平台切换到安卓。
📕安装 XR Plug-in Management
打开 Edit>Project Settings,找到 XR Plug-in Management,点击 Install XR Plug-in Management,安装 XR 插件管理器,在这里能够选择底层插件。
📕导入 Pico SDK
打开 Window>Package Manager,点击左上角的“+”,选择 Add package from disk,找打
在之前解压的 Pico SDK 中会有一个 package.json 文件,选择这个文件进行导入。
导入完成后,你将看到 PXR SDK Setting 窗口,点击 Apply,然后关闭即可。
具体步骤参考:https://developer-cn.picoxr.com/document/unity/import-the-sdk/
教程里导入了 Pico Unity Integration SDK 和 Pico Unity Live Preview Plugin
然后回到 XR Plug-in Management,安卓端勾选 PICO,电脑端勾选 PICO Live Preview
📕导入 XR Interaction Toolkit
导入 Pico Unity Integration SDK 后,Unity 会自动导入 XR Interaction Toolkit,但可能是 3.0 以前的版本。我们在 Package Manager 当中找到 XR Interaction Toolkit,复制它的包名:com.unity.xr.interaction.toolkit,点击左上角“+”,选择 Add package by name,把复制的包名粘贴进去,进行导入,然后 Unity 就会把 XRI 的版本升级到最新的正式版。
然后点击 Samples,可以导入 XRI 的样例包,本教程导入 Starter Assets 和 XR Device Simulator:
然后在 Edit>Project Settings 里找到 XR Plug-in Management 下的 Project Validation,在安卓端和电脑端勾选 Fix All,进行自动环境修复。
📕玩家物体配置
在 Project 窗口里搜索 XR Origin (XR Rig),把它拖到场景里。这个物体是一个交互功能比较齐全的玩家物体,包含传送、移动、抓取、射线交互,它来自于 Starter Assets 样例包。
然后可以在 XR Origin 物体身上添加 PXR_Manager 脚本,这个脚本能够选择开启 Pico 的一些特性,如手势追踪、MR 环境感知、空间锚点等,为了后续扩展程序功能可以添加这个脚本,但是不添加它也能进行基础的手柄交互。
📕传送交互
在 Hierarchy 面板里点击鼠标右键,选择 XR>Teleportation Area,会创建出一个可传送和持续移动的地面,然后在 Teleportation Area 物体上的 Teleportation Area 脚本中,将 Interaction Layer Mask 设为 Teleport。
📕抓取交互
在 Hierarchy 面板里点击鼠标右键,选择 XR>Grab Interactable,创建出可抓取的物体。
默认是可以在远距离去抓取物体,在远处控制物体移动,如果在物体身上的 XR Grab Interactable 脚本中把 Far Attach Mode 设为 Near,那么这个物体在远距离抓取时会飞到手上。
📕UI 交互
在 Hierarchy 面板里点击鼠标右键,选择 XR>UI Canvas,然后可以在这个 Canvas 画布中创建 UI 元素。
📕程序打包
打包前需要在 Pico 开发者后台创建一个应用,将应用的 App ID 与 Unity 工程关联。
可参考:
https://developer-cn.picoxr.com/document/unity/create-a-developer-account-organization-and-app/
https://developer-cn.picoxr.com/document/unity/complete-project-settings/
然后打开 File>Build Settings,把需要打包的场景添加到 Scenes In Build 列表中,列表中第一个场景就是打开程序后第一个进入的场景。然后将 Pico 和 电脑通过 USB 线连接到一起,确保 Pico 开启开发者模式后,就可以点击 Build And Run 进行打包。
https://developer-cn.picoxr.com/document/unity/build-and-run-the-scene/