Pico官网
Pico设备参数
[下载] Pico Unity Integration SDK
[官方英文开发文档] Pico Unity Integration SDK
[官方中文开发文档] Pico Unity Integration SDK
[GitHub] Pico SDK Demos
[Unity手册] Unity XR SDK
XR Interaction Toolkit 2.1 开发手册
[GitHub] XR Interaction Toolkit Examples
Pico Unity XR SDK 文档
PicoVR Unity SDK 文档
Pico Unity Integration SDK(以下简称SDK)提供了丰富的XR能力,如渲染、输入、跟踪、混合现实捕捉等,您可以使用这些功能开发在Pico VR头显上运行的XR应用程序,构建您独特的XR宇宙,从而给人们带来身临其境的体验。
结合开发者平台易用的支付和统计系统,以及专业的技术支持服务,我们希望帮助您以简单高效的方式构建您的 XR 之旅。
在使用 SDK 之前,建议您阅读 Unity XR 文档以了解相关信息。
官方推荐使用 Windows 10 操作系统作为开发环境。因为一些工具,如预览工具(Preview Tool),需要运行在 Windows 10 上。
推荐配置如下
● CPU: Intel i5-4590 / AMD Ryzen 5 1500X or higher
● Graphics card: NVIDIA GTX 1060 / AMD Radeon RX 480
● RAM: 8 GB or higher
● Port: USB 3.0
Java Development Kit(JDK)版本必须是 1.8.0 or later。
下载 JDK
Pico Unity Integration SDK 支持的早期版本为 Unity 2019.4 LTS,如果您想使用更多的功能,官方推荐 Unity 2020.3 LTS 和 Unity 2021.3 LTS 版本。如果想使用Vulkan,需要使用 Unity 2020.3.13 或之后的版本。
在 Pico 中开启“开发者”模式。
1. 下载 Pico Unity Integration SDK
2. 解压 Pico Unity Integration SDK-2.0.x.zip,并找到 package.json 文件
3. 在 Unity Editor 中 [Window]->Package Manager->点+号->Add package from disk...
4. 选择 package.json 文件导入到工程中
5. 在使用Pico SDK API前,需要引入命名空间 using Unity.XR.PXR;
导入 package.json 完成后会自动弹出PXR SDK设置面板,如果不需要版权保护,直接去掉 “2.启动应用程序进行授权检查” 的勾选。
1. 在 Project Settings->XR Plug-in Management 中勾选上 PicoXR
2. 切换到 Android 平台。
3. Other Settings
Minimum API Level: Android 8.1 'Oreo' (API level 27)
Target API Level: Automatic (highest installed)
Scripting Backend: IL2CPP
Target Architectures: ARM64
如果想自定义AndroidManifest.xml文件,需要在其中插入
<meta-data android:name="pvr.app.type" android:value="vr" />
在 Package Manager 的 Unity Registry 列表中找到 XR Interaction Toolkit,然后升级到最新版本。
点击[I Made a backup, Go Ahead],升级交互系统。
切换输入系统
[Edit]->Project Settings->Player->Other Settings->Configuration->Active Input Handing*,选择 Both 或 Input Manager (Old)
安装了 Preview Tool 后,才能在 Unity Editor 中播放运行。
所需环境
● OS: Windows 10, Windows 11. For the graphics card:
○ Minimum:NVIDIA GeForce GTX 970 or AMD Radeon R9 290
○ Recommended:NVIDIA GeForce GTX 1060,AMD Radeon RX 480, or better
显卡必须支持 H265 (HEVC) or H264 video coding.
● SDK version: Pico Unity Integration SDK 2.0.4 or later
● Device: 当前, Preview Tool 仅支持 Neo 3 系列设备, 包括 Neo 3 Pro 和 Neo 3 Pro Eye。
将 PreviewTool_0402.apk 安装到 Pico VR Headset 中。PreviewTool_0402_Release.7z 里放的是 PC 端。双击 PreviewTool.exe 与 Pico VR Headset 建立连接。
确保PreviewTool.exe与Pico VR Headset处于连接状态中,就可以在Unity Editor中直接运行VR场景了。
1. 创建一个 Plane,设置Transform, Position(0, 0, 0);Scale(10, 1, 10)
2. 删除场景中的默认Camera,创建 XR Camera
向 XR Origin 对象上添加 PXR_Manager 组件。
Tracking Origin Mode
设置初始化输入设备时要使用的跟踪原点模式。
○ No Specified: 使用输入设备的默认跟踪原点模式。
○ Device: 将跟踪原点模式设置为相对于第一个已知位置。
○ Floor: 输入设备将相对于地板上的位置进行跟踪。
Camera Y Offset
摄像机相对地面的高度。
向 XR Origin 对象上添加 Input Action Manager 组件。
展开 OR Origin,选中 LeftHand Controller,点击 Preset,选择 XRI Default Left Controller
在 Package->Pico Integration->Assets->Resources->Prefabs 下找到手柄的模型预制体。除了直接使用官方的手柄模型,也可以使用自己的模型预制体。将prefab拖到 XR Controller (Action-based) 组件的 Model Prefab 变量上。
用相同的方式配置 RightHand Controller。
1. 需要在 Pico VR Headset 中开启 "开发者" 模式。
[设置]->[通用]->[关于本机]->连续点击"软件版本号",直到左侧列表出现“开发者”选项。进入[开发者],开启 "USB调试开关"。
Pico截屏图片保存位置 内部共享存储空间\Pictures\Screenshots
Pico企业版:开发者安装的应用将显示在应用列表中。
Pico消费版:开发者安装的应用将显示在未知来源中,并且无法显示启动图标和应用名称。
从应用商店下载的应用都会显示在应用列表中。
//引入Pico SDK
using Unity.XR.PXR;
//判断右手手柄是否已连接
bool rightControllerConnected = PXR_Input.IsControllerConnected(PXR_Input.Controller.RightController);
注意:如果项目位置变了,一定要同步改下Unity工程下的 Packages\manifest.json 文件中的 "com.unity.xr.picoxr" 路径。这条路径要指向当前 "PICO UnityXR Integration SDK v207" 文件夹位置。
例如: "com.unity.xr.picoxr": "file:D:/Dev/AllData/Pico/PICO UnityXR Integration SDK v207"