小米应用商店：小米VR开发者指南

小提示：您能找到这篇{小米应用商店：小米VR开发者指南}绝对不是偶然，我们能帮您找到潜在客户，解决您的困扰。如果您对本页介绍的小米应用商店：小米VR开发者指南内容感兴趣，有相关需求意向欢迎拨打我们的服务热线，或留言咨询，我们将第一时间联系您！

< ">< font-size: 18px;">Ⅰ.小米VR一体机开发者指南

< ">尊敬的VR开发者，为了协助您完成小米VR一体机应用的开发工作，该指南简单介绍了如何开始开发的流程，请仔细阅读。我们为您提供的小米VR一体机硬件和软件均是早期版本，您可能会遇到问题。如遇到问题请及时向我们反馈。我们的消费者版本会在硬件和软件上都进行大量改进和迭代，确保整体达到优质的VR体验。

< ">一、开始开发

< ">1.开始设备初始化流程

< ">下载手机2D Companion app

< ">启动app并打开手机蓝牙，按照流程，选择设备平台“小米VR一体机”，完成一体机初始化，一体机会在初始化过程中进行首次系统升级，升级完成后方可使用。

< ">我们为一体机设计了“推送升级”和“静默升级”两种系统升级途径：当服务端存在系统更新时，联网的一体机会收到系统升级提示；或一体机在开机联网状态下，电量达到50%以上时，在凌晨2点到6点会自动升级ROM。

< ">2.注册小米账号，并通过小米开放平台http://dev.xiaomi.com认证成为开发者，开发者认证可能需要2-3个工作日，请耐心等待。

< ">3.开发的应用程序需要集成开发签名文件，此文件用于在开发过程中访问VR服务的底层接口，如果没有这个文件，应用程序将无法访问VR服务的底层接口，应用程序无法正常启动。开发者可以从网站：http://dev.xiaomi.com/vr/signature/index上通过一体机的序列号获取签名文件，每个签名文件对应一个特定的一体机，更换一体机需要同时更换安装文件，否则应用程序无法正常运行。必须注册为开发者才能访问此网页。

< ">4.应用包安装与启动

< ">4.1：如何开启开发者模式

< ">（1）：用开发者账号登录应用（注意：非开发者账户无法打开开发者模式）

< ">（2）：确保小米VR一体机和手机小红书热门机制都已经连接到互联网

< ">（3）：打开/关闭开发者模式：依次点击设置-关于小米VR，如下图所示按钮（1---2），找到小米VRlogo

< ">（4）：快速点击小米VRlog5次可打开/关闭开发者模式。（开发者模式默认关闭）

< ">4.2：应用程序测试期间的有用命令

< ">-安装APK包：adb install"c:1.apk

< ">-卸载APK包：adb uninstall“c:1.apk

< ">-启动apk包：adb shell am start-n package name/activity name

< ">例子：adb shell am start–n com.xiaomi.vr/com.mi.dlabs.vr.sdk.plugins.unity.mivrunityplayerActivity

< ">5.使用Unity自带的Build and Run就可以在V1O的机器上把开发的应用程序跑起来。

< ">V1O最新SDK外网链接地址03.20(仅Unity)：

< ">Unity:http://upgrade.miglass.mi.com/MIVR_Unity_SDK_1.4.5_2031a.zip

< ">Unreal:http://upgrade.miglass.mi.com/MIVR_Unreal_SDK_1.4.4_b3b5e.zip

< ">设备同时支持小米一体机SDK和Oculus mobile SDK，但需去除Oculus SDK中Platform SDK部分

< ">小米VR SDK for Unity下载：https://dev.mi.com/console/doc/detail?pId=818

< ">小米VR SDK for Unreal Engine下载：https://dev.mi.com/console/doc/detail?pId=830

< ">6.常见问题说明：

< ">（1）安装完成后用下面的方法去启动应用

< ">因为没有2D的界面也不会有icon，如果机器的界面进入了别的界面，此时如果需要启动自己的APP，使用下面的命令去启动：

< ">假设包名为com.xiaomi.vr,Activity的名字为com.mi.dlabs.vr.sdk.plugins.unity.MiVRUnityPlayerActivity（如果没有使用自定义的Act近期明星危机公关事件ivity，这个是默认的Activity名字）

< ">adb shell am start-n com.xiaomi.vr/com.mi.dlabs.vr.sdk.plugins.unity.MiVRUnityPlayerActivity

< ">使用此命令就可以启动应用，包名和Activity名字替换为开发者自己的。

< ">二、发布应用

< ">1.上传应用前，请确保应用程序符合小米VR眼镜应用评审规范，具体的规范内容请查阅《小米VR应用评审规范》其中以下几点特别需要强调：

< ">应用全程保持60FPS及以上的帧数运行

< ">在应用启动时必须在第一步进行手柄方向的校准，提示用户将手柄正对正前方，并长按手柄圆圈键进行手柄方向校准

< ">应用对体感手柄的功能定义需符合小米VR体感手柄按键定义规范

< ">2.完成开发后，登陆http://dev.xiaomi.com/myitems?pageType=10进行应用上传，上传应用前你必须注册成为小米开放平台开发者：http://dev.xiaomi.com/

< ">3.小米VR审核人员将针对您提交的应用进行审核，通过审核后即可上线小米VR平台。

< ">三.基本操作

< ">1.小米VR一体机顶部的电源按键，点按为亮屏/熄屏，长按为关机。

< ">2.手柄的上半区是一个触控面板，滑动操作时规定目标物体与用户手指滑动方向一致，例如用户向上滑动，画面中内容跟随向上移动，如下图所示：

< ">3.手柄前方的扳机键及上半区的触控面板按下为点击键，点击为确定功能，开发者需将应用中的确认及最常用功能键定义为此按键

< ">4.手柄的三角键为回退键，默认点击返回上一层菜单，在第三方应用中，允许开发者自定义该按键功能

< ">5.手柄的圆圈键点按为退出应用，长按为进行方向校准，将手柄当前方向作为正方向。

< ">6.手柄的三角键长按为呼出全局菜单（将在未来的系统版本中支持）

< ">四.常见问题

< ">问：为什么应用接入SDK后无法打开或出现崩溃？

< ">答：进行小米开放平台开发者账号申请。登录http://dev.xiaomi.com注册成为开发者。注册开发者需要几天工作日才能通过审核，请耐心等待。开发的应用程序需要集成开发签名文件，此文件用于在开发过程中访问VR服务的底层接口，如果没有这个文件，应用程序将无法访问VR服务的底层接口，应用程序无法正常启动。开发者可以从网站上通过一体机的序列号获取签名文件。每个签名文件对应一个特定的一体机，更换一体机需要同时更换安装文件。否则应用程序无法正常运行。必须注册为开发者才能访问此网页。

< ">问：为什么上传应用出现错误提示？

< ">答：上传应用出现错误提示往往是由于应用不符合小米VR的Manifest要求导致的请特别注意《小米VR Unity插件开发文档》中的“应用程序的Manifest”部分，开发的应用程序必须完全符合文档中的Manifest，否则应用审核会无法通过。

< ">Ⅱ.小米VR眼镜开发者指南

< ">尊敬的VR开发者，为了协助您完成小米VR眼镜应用的开发工作，该指南简单介绍了如何开始开发的流程，请仔细阅读。我们为您提供的小米VR眼镜硬件和软件均是早期版本，您可能会遇到问题。如遇到问题请及时向我们反馈。我们的消费者版本会在硬件和软件上都进行大量改进和迭代，确保整体达到优质的VR体验。

< ">一.开始开发

< ">小米VR眼镜支持小米手机6、5、小米手机5S、小米手机5S Plus、小米手机Note2、红米Pro，未来会支持更多款小米旗舰及热门机型。

< ">请按照小米MIUI官方网站的教程，将适配款式的小米手机升级到最新的MIUI开发版或稳定版：http://www.miui.com/download“确认传播”专注于品牌策划、效果营销和危机管理的数字整合营销传播公司，我们深度诠释客户的品牌理念、文化及背景，多维深度传播客户的文化底蕴和核心价值观，提升客户品牌的知名度、关注度与美誉度。

< ">安装小米VR应用，请将支持的小米手机连接网络，并插入小米VR眼镜中，系统弹出提示下载“小米VR”应用，点击确定进行下载

< ">打开小米VR应用，在设置中进行体感手柄的重新配对。

< ">如果适配款式的小米手机已经成功升级到最新MIUI开发版或稳定版，并且安装了小米VR应用之后，插入小米VR眼镜，即可启动VR启动。

< ">进行小米开放平台开发者账号申请。登录http://dev.xiaomi.com注册成为开发者，注册开发者需要几天工作日才能通过审核，请耐心等待。

< ">开发的应用程序需要集成开发签名文件，此文件用于在开发过程中访问VR服务的底层接口，如果没有这个文件，应用程序将无法访问VR服务的底层接口，应用程序无法正常启动。开发者可以从网站：http://dev.xiaomi.com/vr/signature/index上通过手机的序列号获取签名文件，每个签名文件对应一个特定的手机，更换手机需要同时更换安装文件，否则应用程序无法正常运行。必须注册为开发者才能访问此网页。

< ">开始开发，开发的应用程序必须使用小米VR SDK，目前我们提供Unity的SDK，请查阅我们提供的《小米VR Unity插件开发文档》进行开发。请使用Unity V5.3.7进行开发，使用V5.4.0或以上版本目前存在兼容性问题，我们会持续改善Unity不同版本的兼容性问题。

< ">你不需要使用VR启动进入你开发的应用，你可以直接在手机上安装你的应用，通过手机系统桌面进入你开发的应用。如果你正确接入小米VR SDK，插入小米VR眼镜即可享受独立运动传感器，16毫秒超低延时，ATW算法等优化功能。

< ">请特别注意《小米VR Unity插件开发文档》中的“应用程序的Manifest”分，开发的应用程序必须完全符合文档中的Manifest，否警察危机公关百度文库则应用审核会无法通过。

< ">二.发布应用

< ">1.上传应用前，请确保应用程序符合小米VR眼镜应用评审规范，具体的规范内容请查阅《小米VR眼镜应用评审规范》其中以下几点特别需要强调：

< ">应用必须全程以分屏的VR模式进行显示

< ">应用全程保持60FPS及以上的帧数运行

< ">应用如需要使用手柄的体感功能（方向）进行精细的操作，在应用启动时必须在第一步进行手柄方向的校准，提示用户将手柄正对正前方，并双击手柄圆圈键进行手柄方向校准

< ">应用对体感手柄的功能定义需符合小米VR眼镜体感手柄按键定义规范

< ">必须符合SDK文档中的应用程序Manifest规范

< ">2.完成开发后，登陆http://dev.xiaomi.com/myitems?pageType=10进行应用上传，上传应用前你必须注册成为小米开放平台开发者：http://dev.xiaomi.com/

< ">3.通过审核后即可上线小米VR平台。

< ">三.基本操作

< ">1.小米VR眼镜顶部的按键，点按为确定，长按为进入全局菜单。

< ">2.手柄的上半区是一个触控面板，滑动操作时规定目标物体与用户手指滑动方向一致，例如用户向上滑动，画面中内容跟随向上移动，如下图所示：

< ">3.手柄的上半区的触控面板按下为点击键，点击为确定功能，开发者需将应用中的确认及最常用功能键定义为此按键

< ">4.手柄的三角键为回退键，默认点击返回上一层菜单，在第三方应用中，允许开发者自定义该按键功能

< ">5.手柄的圆圈键点按为退出应用，会弹出退出应用的提示画面。

< ">6.手柄的圆圈键双击为进行方向校准，将手柄当前方向作为正方向。

< ">7.手柄的圆圈键长按2秒为呼出全局菜单

< ">四.常见问题

< ">问：为什么将手机插入小米VR眼镜中没有任何反应？

< ">答：请确保

< ">你的手机为小米手机6、小米手机5，小米手机5S，小米手机5S Plus，小米手机Note2。

< ">你的手机MIUI升级到最新开发版。

< ">你的手机安装了最新的小米VR应用（使用“小米VR应用”文件夹中的APK）

< ">插入时用力足够，确保正确插入到位置。

< ">问：为什么我接入小米VR SDK后，开发的应用直接在手机操作系统桌面打开后就直接显示了不应该是插入头显后才会显示吗？

< ">答：为了方便开发者开发，我们增加了Simple Mode:&lt;meta-data android:name=”com.mi.dlabs.vr.HMD_TYPE”android:value=”simple”/&gt;可以在不插入VR眼镜的时候显示图像，使用手机的IMU进行头部跟踪。当插入VR眼镜后会自动切换到VR眼镜中的IMU。在上传小米VR应用商店之前需要移除该标签。具体请参见《小米VR Unity插件开发文档》中“5.应用程序的Manifest”的部分。

< ">问：为什么在VR分屏模式下，转动/移动手机会看到VR分屏画框周边会出现晃动？

< ">答：这是正常现象这是ATW算法的特点，ATW算法可以帮助在少量掉帧的情况下平滑帧率，不会出现卡顿等导致眩晕的问题，其中一个特点就是会让画框出现一定程度的晃动。

< ">问：为什么应用接入SDK后无法打开或出现崩溃？

< ">答：进行小米开放平台开发者账号申请。登录http://dev.xiaomi.com注册成为开发者。注册开发者需要几天工作日才能通过审核，请耐心等待。开发的应用程序需要集成开发签名文件，此文件用于在开发过程中访问VR服务的底层接口，如果没有这个文件，应用程序将无法访问VR服务的底层接口，应用程序无法正常启动。开发者可以从网站上通过手机的序列号获取签名文件。每个签名文件对应一个特定的手机，更换手机需要同时更换安装文件。否则应用程序无法正常运行。必须注册为开发者才能访问此网页。

< ">问：为什么上传应用出现错误提示？

< ">答：上传应用出现错误提示往往是由于应用不符合小米VR的Manifest要求导致的请特别注意《小米VR Unity插件开发文档》中的“应用程序的Manifest”部分，开发的应用程序必须完全符合文档中的Manifest，否则应用审核会无法通过。