小米應(yīng)用商店：小米VR開發(fā)者指南

Ⅰ.小米VR一體機開發(fā)者指南

尊敬的VR開發(fā)者，為了協(xié)助您完成小米VR一體機應(yīng)用的開發(fā)工作，該指南簡單介紹了如何開始開發(fā)的流程，請仔細閱讀。我們?yōu)槟峁┑男∶譜R一體機硬件和軟件均是早期版本，您可能會遇到問題。如遇到問題請及時向我們反饋。我們的消費者版本會在硬件和軟件上都進行大量改進和迭代，確保整體達到優(yōu)質(zhì)的VR體驗。

一、開始開發(fā)

1.開始設(shè)備初始化流程

下載手機2D Companion app

啟動app并打開手機藍牙，按照流程，選擇設(shè)備平臺“小米VR一體機”，完成一體機初始化，一體機會在初始化過程中進行首次系統(tǒng)升級，升級完成后方可使用。

我們?yōu)橐惑w機設(shè)計了“推送升級”和“靜默升級”兩種系統(tǒng)升級途徑：當服務(wù)端存在系統(tǒng)更新時，聯(lián)網(wǎng)的一體機會收到系統(tǒng)升級提示；或一體機在開機聯(lián)網(wǎng)狀態(tài)下，電量達到50%以上時，在凌晨2點到6點會自動升級ROM。

2.注冊小米賬號，并通過小米開放平臺http://dev.xiaomi.com認證成為開發(fā)者，開發(fā)者認證可能需要2-3個工作日，請耐心等待。

3.開發(fā)的應(yīng)用程序需要集成開發(fā)簽名文件，此文件用于在開發(fā)過程中訪問VR服務(wù)的底層接口，如果沒有這個文件，應(yīng)用程序?qū)o法訪問VR服務(wù)的底層接口，應(yīng)用程序無法正常啟動。開發(fā)者可以從網(wǎng)站：http://dev.xiaomi.com/vr/signature/index上通過一體機的序列號獲取簽名文件，每個簽名文件對應(yīng)一個特定的一體機，更換一體機需要同時更換安裝文件，否則應(yīng)用程序無法正常運行。必須注冊為開發(fā)者才能訪問此網(wǎng)頁。

4.應(yīng)用包安裝與啟動

4.1：如何開啟開發(fā)者模式

（1）：用開發(fā)者賬號登錄應(yīng)用（注意：非開發(fā)者賬戶無法打開開發(fā)者模式）

（2）：確保小米VR一體機和手機都已經(jīng)連接到互聯(lián)網(wǎng)

（3）：打開/關(guān)閉開發(fā)者模式：依次點擊設(shè)置-關(guān)于小米VR，如下圖所示按鈕（1---2），找到小米VRlogo

（4）：快速點擊小米VRlog5次可打開/關(guān)閉開發(fā)者模式。（開發(fā)者模式默認關(guān)閉）

4.2：應(yīng)用程序測試期間的有用命令

-安裝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的機器上把開發(fā)的應(yīng)用程序跑起來。

V1O最新SDK外網(wǎng)鏈接地址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

設(shè)備同時支持小米一體機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）安裝完成后用下面的方法去啟動應(yīng)用

因為沒有2D的界面也不會有icon，如果機器的界面進入了別的界面，此時如果需要啟動自己的APP，使用下面的命令去啟動：

假設(shè)包名為com.xiaomi.vr,Activity的名字為com.mi.dlabs.vr.sdk.plugins.unity.MiVRUnityPlayerActivity（如果沒有使用自定義的Activity，這個是默認的Activity名字）

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

使用此命令就可以啟動應(yīng)用，包名和Activity名字替換為開發(fā)者自己的。

二、發(fā)布應(yīng)用

1.上傳應(yīng)用前，請確保應(yīng)用程序符合小米VR眼鏡應(yīng)用評審規(guī)范，具體的規(guī)范內(nèi)容請查閱《小米VR應(yīng)用評審規(guī)范》其中以下幾點特別需要強調(diào)：

·應(yīng)用全程保持60FPS及以上的幀數(shù)運行

·在應(yīng)用啟動時必須在第一步進行手柄方向的校準，提示用戶將手柄正對正前方，并長按手柄圓圈鍵進行手柄方向校準

·應(yīng)用對體感手柄的功能定義需符合小米VR體感手柄按鍵定義規(guī)范

2.完成開發(fā)后，登陸http://dev.xiaomi.com/myitems?pageType=10進行應(yīng)用上傳，上傳應(yīng)用前你必須注冊成為小米開放平臺開發(fā)者：http://dev.xiaomi.com/

3.小米VR審核人員將針對您提交的應(yīng)用進行審核，通過審核后即可上線小米VR平臺。

三.基本操作

1.小米VR一體機頂部的電源按鍵，點按為亮屏/熄屏，長按為關(guān)機。

2.手柄的上半?yún)^(qū)是一個觸控面板，滑動操作時規(guī)定目標物體與用戶手指滑動方向一致，例如用戶向上滑動，畫面中內(nèi)容跟隨向上移動，如下圖所示：

3.手柄前方的扳機鍵及上半?yún)^(qū)的觸控面板按下為點擊鍵，點擊為確定功能，開發(fā)者需將應(yīng)用中的確認及最常用功能鍵定義為此按鍵

4.手柄的三角鍵為回退鍵，默認點擊返回上一層菜單，在第三方應(yīng)用中，允許開發(fā)者自定義該按鍵功能

5.手柄的圓圈鍵點按為退出應(yīng)用，長按為進行方向校準，將手柄當前方向作為正方向。

6.手柄的三角鍵長按為呼出全局菜單（將在未來的系統(tǒng)版本中支持）

四.常見問題

問：為什么應(yīng)用接入SDK后無法打開或出現(xiàn)崩潰？

答：進行小米開放平臺開發(fā)者賬號申請。登錄http://dev.xiaomi.com注冊成為開發(fā)者。注冊開發(fā)者需要幾天工作日才能通過審核，請耐心等待。開發(fā)的應(yīng)用程序需要集成開發(fā)簽名文件，此文件用于在開發(fā)過程中訪問VR服務(wù)的底層接口，如果沒有這個文件，應(yīng)用程序?qū)o法訪問VR服務(wù)的底層接口，應(yīng)用程序無法正常啟動。開發(fā)者可以從網(wǎng)站上通過一體機的序列號獲取簽名文件。每個簽名文件對應(yīng)一個特定的一體機，更換一體機需要同時更換安裝文件。否則應(yīng)用程序無法正常運行。必須注冊為開發(fā)者才能訪問此網(wǎng)頁。

問：為什么上傳應(yīng)用出現(xiàn)錯誤提示？

答：上傳應(yīng)用出現(xiàn)錯誤提示往往是由于應(yīng)用不符合小米VR的Manifest要求導致的請?zhí)貏e注意《小米VR Unity插件開發(fā)文檔》中的“應(yīng)用程序的Manifest”部分，開發(fā)的應(yīng)用程序必須完全符合文檔中的Manifest，否則應(yīng)用審核會無法通過。

Ⅱ.小米VR眼鏡開發(fā)者指南

尊敬的VR開發(fā)者，為了協(xié)助您完成小米VR眼鏡應(yīng)用的開發(fā)工作，該指南簡單介紹了如何開始開發(fā)的流程，請仔細閱讀。我們?yōu)槟峁┑男∶譜R眼鏡硬件和軟件均是早期版本，您可能會遇到問題。如遇到問題請及時向我們反饋。我們的消費者版本會在硬件和軟件上都進行大量改進和迭代，確保整體達到優(yōu)質(zhì)的VR體驗。

一.開始開發(fā)

小米VR眼鏡支持小米手機6、5、小米手機5S、小米手機5S Plus、小米手機Note2、紅米Pro，未來會支持更多款小米旗艦及熱門機型。

請按照小米MIUI官方網(wǎng)站的教程，將適配款式的小米手機升級到最新的MIUI開發(fā)版或穩(wěn)定版：http://www.miui.com/download.html

安裝小米VR應(yīng)用，請將支持的小米手機連接網(wǎng)絡(luò)，并插入小米VR眼鏡中，系統(tǒng)彈出提示下載“小米VR”應(yīng)用，點擊確定進行下載

打開小米VR應(yīng)用，在設(shè)置中進行體感手柄的重新配對。

如果適配款式的小米手機已經(jīng)成功升級到最新MIUI開發(fā)版或穩(wěn)定版，并且安裝了小米VR應(yīng)用之后，插入小米VR眼鏡，即可啟動VR啟動。

進行小米開放平臺開發(fā)者賬號申請。登錄http://dev.xiaomi.com注冊成為開發(fā)者，注冊開發(fā)者需要幾天工作日才能通過審核，請耐心等待。

開發(fā)的應(yīng)用程序需要集成開發(fā)簽名文件，此文件用于在開發(fā)過程中訪問VR服務(wù)的底層接口，如果沒有這個文件，應(yīng)用程序?qū)o法訪問VR服務(wù)的底層接口，應(yīng)用程序無法正常啟動。開發(fā)者可以從網(wǎng)站：http://dev.xiaomi.com/vr/signature/index上通過手機的序列號獲取簽名文件，每個簽名文件對應(yīng)一個特定的手機，更換手機需要同時更換安裝文件，否則應(yīng)用程序無法正常運行。必須注冊為開發(fā)者才能訪問此網(wǎng)頁。

開始開發(fā)，開發(fā)的應(yīng)用程序必須使用小米VR SDK，目前我們提供Unity的SDK，請查閱我們提供的《小米VR Unity插件開發(fā)文檔》進行開發(fā)。請使用Unity V5.3.7進行開發(fā)，使用V5.4.0或以上版本目前存在兼容性問題，我們會持續(xù)改善Unity不同版本的兼容性問題。

你不需要使用VR啟動進入你開發(fā)的應(yīng)用，你可以直接在手機上安裝你的應(yīng)用，通過手機系統(tǒng)桌面進入你開發(fā)的應(yīng)用。如果你正確接入小米VR SDK，插入小米VR眼鏡即可享受獨立運動傳感器，16毫秒超低延時，ATW算法等優(yōu)化功能。

請?zhí)貏e注意《小米VR Unity插件開發(fā)文檔》中的“應(yīng)用程序的Manifest”分，開發(fā)的應(yīng)用程序必須完全符合文檔中的Manifest，否則應(yīng)用審核會無法通過。

二.發(fā)布應(yīng)用

1.上傳應(yīng)用前，請確保應(yīng)用程序符合小米VR眼鏡應(yīng)用評審規(guī)范，具體的規(guī)范內(nèi)容請查閱《小米VR眼鏡應(yīng)用評審規(guī)范》其中以下幾點特別需要強調(diào)：

應(yīng)用必須全程以分屏的VR模式進行顯示

應(yīng)用全程保持60FPS及以上的幀數(shù)運行

應(yīng)用如需要使用手柄的體感功能（方向）進行精細的操作，在應(yīng)用啟動時必須在第一步進行手柄方向的校準，提示用戶將手柄正對正前方，并雙擊手柄圓圈鍵進行手柄方向校準

應(yīng)用對體感手柄的功能定義需符合小米VR眼鏡體感手柄按鍵定義規(guī)范

必須符合SDK文檔中的應(yīng)用程序Manifest規(guī)范

2.完成開發(fā)后，登陸http://dev.xiaomi.com/myitems?pageType=10進行應(yīng)用上傳，上傳應(yīng)用前你必須注冊成為小米開放平臺開發(fā)者：http://dev.xiaomi.com/

3.通過審核后即可上線小米VR平臺。

三.基本操作

1.小米VR眼鏡頂部的按鍵，點按為確定，長按為進入全局菜單。

2.手柄的上半?yún)^(qū)是一個觸控面板，滑動操作時規(guī)定目標物體與用戶手指滑動方向一致，例如用戶向上滑動，畫面中內(nèi)容跟隨向上移動，如下圖所示：

3.手柄的上半?yún)^(qū)的觸控面板按下為點擊鍵，點擊為確定功能，開發(fā)者需將應(yīng)用中的確認及最常用功能鍵定義為此按鍵

4.手柄的三角鍵為回退鍵，默認點擊返回上一層菜單，在第三方應(yīng)用中，允許開發(fā)者自定義該按鍵功能

5.手柄的圓圈鍵點按為退出應(yīng)用，會彈出退出應(yīng)用的提示畫面。

6.手柄的圓圈鍵雙擊為進行方向校準，將手柄當前方向作為正方向。

7.手柄的圓圈鍵長按2秒為呼出全局菜單

四.常見問題

問：為什么將手機插入小米VR眼鏡中沒有任何反應(yīng)？

答：請確保

·你的手機為小米手機6、小米手機5，小米手機5S，小米手機5S Plus，小米手機Note2。

·你的手機MIUI升級到最新開發(fā)版。

·你的手機安裝了最新的小米VR應(yīng)用（使用“小米VR應(yīng)用”文件夾中的APK）

·插入時用力足夠，確保正確插入到位置。

問：為什么我接入小米VR SDK后，開發(fā)的應(yīng)用直接在手機操作系統(tǒng)桌面打開后就直接顯示了不應(yīng)該是插入頭顯后才會顯示嗎？

答：為了方便開發(fā)者開發(fā)，我們增加了Simple Mode:<meta-data android:name=”com.mi.dlabs.vr.HMD_TYPE”android:value=”simple”/>可以在不插入VR眼鏡的時候顯示圖像，使用手機的IMU進行頭部跟蹤。當插入VR眼鏡后會自動切換到VR眼鏡中的IMU。在上傳小米VR應(yīng)用商店之前需要移除該標簽。具體請參見《小米VR Unity插件開發(fā)文檔》中“5.應(yīng)用程序的Manifest”的部分。

問：為什么在VR分屏模式下，轉(zhuǎn)動/移動手機會看到VR分屏畫框周邊會出現(xiàn)晃動？

答：這是正常現(xiàn)象這是ATW算法的特點，ATW算法可以幫助在少量掉幀的情況下平滑幀率，不會出現(xiàn)卡頓等導致眩暈的問題，其中一個特點就是會讓畫框出現(xiàn)一定程度的晃動。

問：為什么應(yīng)用接入SDK后無法打開或出現(xiàn)崩潰？

答：進行小米開放平臺開發(fā)者賬號申請。登錄http://dev.xiaomi.com注冊成為開發(fā)者。注冊開發(fā)者需要幾天工作日才能通過審核，請耐心等待。開發(fā)的應(yīng)用程序需要集成開發(fā)簽名文件，此文件用于在開發(fā)過程中訪問VR服務(wù)的底層接口，如果沒有這個文件，應(yīng)用程序?qū)o法訪問VR服務(wù)的底層接口，應(yīng)用程序無法正常啟動。開發(fā)者可以從網(wǎng)站上通過手機的序列號獲取簽名文件。每個簽名文件對應(yīng)一個特定的手機，更換手機需要同時更換安裝文件。否則應(yīng)用程序無法正常運行。必須注冊為開發(fā)者才能訪問此網(wǎng)頁。

問：為什么上傳應(yīng)用出現(xiàn)錯誤提示？

答：上傳應(yīng)用出現(xiàn)錯誤提示往往是由于應(yīng)用不符合小米VR的Manifest要求導致的請?zhí)貏e注意《小米VR Unity插件開發(fā)文檔》中的“應(yīng)用程序的Manifest”部分，開發(fā)的應(yīng)用程序必須完全符合文檔中的Manifest，否則應(yīng)用審核會無法通過。