北京小鸟看看科技有限公司
1 / 66
PicoVRAndroidSDK_Unity
开发说明文档
版本:v_2.7.6
北京小鸟看看科技有限公司
北京小鸟看看科技有限公司
2 / 66
目录
1 说明.............................................................................................................................................................. 3
1.1 SDK 介绍 .......................................................................................................................................................................... 3
1.2 文档介绍 ........................................................................................................................................................................... 3
2 支持设备....................................................................................................................................................... 4
3 开发环境要求................................................................................................................................................ 5
4 SDK 接入快速入门 ....................................................................................................................................... 6
5 各硬件产品开发指南 .................................................................................................................................. 13
5.1 Pico U & Pico Goblin & Pico Goblin2................................................................................................................ 13
5.1.1 实现头部跟踪与立体渲染 .......................................................................................................................... 13
5.1.2 使用单手柄预制体(Pico Viewer 不支持) ........................................................................................ 14
5.1.3 使用单手柄的按键、触摸板 ...................................................................................................................... 15
5.2 Pico Neo....................................................................................................................................................................... 16
5.2.1 实现头部跟踪与立体渲染 .......................................................................................................................... 16
5.2.2 使用双手柄预制体 ....................................................................................................................................... 18
5.2.3 使用双手柄的按键、触摸板 ...................................................................................................................... 19
5.3 Pico Viewer ................................................................................................................................................................. 20
5.3.1 实现头部跟踪与立体渲染 .......................................................................................................................... 20
5.3.2 Viewer 相关说明 ......................................................................................................................................... 21
5.4 Pico 一体机按键 .......................................................................................................................................................... 22
6 API 接口函数一览...................................................................................................................................... 22
6.1 获取版本信息 ................................................................................................................................................................ 22
6.2 Sensor 跟踪相关 ......................................................................................................................................................... 23
6.3 手柄相关(Viewer 不支持) .................................................................................................................................... 24
6.4 电量音量亮度服务相关 ............................................................................................................................................... 31
6.5 头戴距离传感器相关 ................................................................................................................................................... 35
6.6 硬件设备相关 ................................................................................................................................................................ 36
7 支付系统.................................................................................................................................................... 38
7.1 准备工作 ........................................................................................................................................................................ 38
7.1.1 获取支付所用字符串 .................................................................................................................................. 38
7.1.2 使用支付所用字符串 .................................................................................................................................. 41
7.2 使用支付系统 ................................................................................................................................................................ 42
7.3 功能接口说明 ................................................................................................................................................................ 43
7.3.1 登陆 ................................................................................................................................................................ 43
7.3.2 支付 ................................................................................................................................................................ 44
7.3.3 查询订单 ....................................................................................................................................................... 45
7.3.4 获取用户信息 ............................................................................................................................................... 46
7.4 开发者服务端交互 ....................................................................................................................................................... 47
8 开发注意事项............................................................................................................................................. 52
8.1 进入设备的开发者模式 ............................................................................................................................................... 52
8.2 Unity 版本兼容 ............................................................................................................................................................ 52
8.3 Android Manifest 文件............................................................................................................................................. 53
9 辅助工具.................................................................................................................................................... 55
9.1 显示帧速率 .................................................................................................................................................................... 55
9.2 场景切换渐变效果 ....................................................................................................................................................... 56
10 常见问题解答............................................................................................................................................. 57
北京小鸟看看科技有限公司
3 / 66
1 说明
1.1 SDK 介绍
为方便广大 Unity 3D 开发者开发适用于 Pico 虚拟现实头盔的应用,我公司推出了 PicoVRAndroidSDK_Unity
(以下简称 SDK)。SDK 主要提供:传感器融合,双目立体渲染,光学畸变校正,异步时间扭曲,单缓冲渲染,
3DoF/6DoF 多交互支持,3D 立体音效,电源及散热管理,账号及支付管理等功能。
为方便开发者接入,SDK 通过 UnityPackage 包的格式提供,开发者导入后可看到如下目录:
图 1.1 SDK 结构
Assets>UnityMobieSDK 下的每个子目录都对应 SDK 中相应的功能,子目录下的 Scenes 目录中提供了供您
参考的场景,在适配 SDK 时遇到问题可查看文档,也可参考参考场景中的方法。
1.2 文档介绍
本文档主要介绍了 SDK 的接入方法,包括:立体渲染与传感器融合功等能的接入、设备控制器的使用、支付
功能的接入。并介绍了 SDK 的目录结构与接口 API 的功能。另外,还对一些常见疑问进行了解答。开发者使用 SDK
前请务必阅读该文档对应的内容,以获得最佳效果。
北京小鸟看看科技有限公司
4 / 66
2 支持设备
SDK 支持如下硬件设备:
表 2.1 支持设备列表
设备类型
型号
VR 盒子
Pico 1/1s
Pico U
VR 一体机
Pico Goblin
Pico Neo
Pico Viewer
Pico Goblin2
北京小鸟看看科技有限公司
5 / 66
3 开发环境要求
对于 Unity 5,SDK 适配 Unity5.2 及以上版本。
对于 Unity 2017,支持所有版本,推荐使用 Unity2017.1.0、Unity2017.2.0、Unity 2017.3.0,Unity2017.4.1。
对于 Unity 2018, 目前支持到 Unity2018.2.11,推荐使用 Unity2018.1.0、Unity2018.2.0。
Pico Viewer 仅适配 Unity2017.2.0f3 及以上。目前 Viewer 使用 Unity 2018.2.0、 2018.2.1、 2018.2.2、
2018.2.3、 2018.2.4 版本有黑屏现象,Unity 2018.2.5、2018.2.6、 2018.2.7 版本无此问题。
另外,开发前需要配置好 Android 开发环境,具体的环境要求如下:
表 3.1 Android 开发环境
软件名称
软件版本
JDK
jdk1.7.0_01 及以上
Android SDK
API Level 19 及以上
另外,如开发面向 Pico 1/1s 及 Pico U 的应用,即面向 Android 手机的应用,请务必保证 Android 手机满足
如下要求:
表 3.2 对手机的要求
要求条目
具体要求
Android 版本
Android 6.0 及以上
传感器
具有陀螺仪、加速度传感器