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

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

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

一、開始開發(fā)

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

下載手機(jī)2D Companion app

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

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

2.注冊(cè)小米賬號(hào)，并通過小米開放平臺(tái)http://dev.xiaomi.com認(rèn)證成為開發(fā)者，開發(fā)者認(rèn)證可能需要2-3個(gè)工作日，請(qǐng)耐心等待。

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

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

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

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

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

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

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

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

-安裝APK包：adb install"c:1.apk

-卸載APK包：adb uninstall“c:1.apk

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

因?yàn)闆]有2D的界面也不會(huì)有icon，如果機(jī)器的界面進(jìn)入了別的界面，此時(shí)如果需要啟動(dòng)自己的APP，使用下面的命令去啟動(dòng)：

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

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

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

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

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

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

·在應(yīng)用啟動(dòng)時(shí)必須在第一步進(jìn)行手柄方向的校準(zhǔn)，提示用戶將手柄正對(duì)正前方，并長(zhǎng)按手柄圓圈鍵進(jìn)行手柄方向校準(zhǔn)

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

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

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

三.基本操作

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

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

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

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

5.手柄的圓圈鍵點(diǎn)按為退出應(yīng)用，長(zhǎng)按為進(jìn)行方向校準(zhǔn)，將手柄當(dāng)前方向作為正方向。

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

四.常見問題

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

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

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

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

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

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

一.開始開發(fā)

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

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

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

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

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

進(jìn)行小米開放平臺(tái)開發(fā)者賬號(hào)申請(qǐng)。登錄http://dev.xiaomi.com注冊(cè)成為開發(fā)者，注冊(cè)開發(fā)者需要幾天工作日才能通過審核，請(qǐng)耐心等待。

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

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

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

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

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

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

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

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

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

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

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

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

3.通過審核后即可上線小米VR平臺(tái)。

三.基本操作

1.小米VR眼鏡頂部的按鍵，點(diǎn)按為確定，長(zhǎng)按為進(jìn)入全局菜單。

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

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

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

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

6.手柄的圓圈鍵雙擊為進(jìn)行方向校準(zhǔn)，將手柄當(dāng)前方向作為正方向。

7.手柄的圓圈鍵長(zhǎng)按2秒為呼出全局菜單

四.常見問題

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

答：請(qǐng)確保

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

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

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

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

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

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

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

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

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

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

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

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