初始準(zhǔn)備
1.Visual Studio2019肛宋。
2.WIndow10 SDK(10.0.18362.0)。
3.Unity2019束世。
4.Git酝陈。
5.NuGet。
Git設(shè)置
1.在GItHub上新建一個存儲庫毁涉,并將其在本地clone下來沉帮。如何創(chuàng)建?
git clone https://github.com/yourname/textsv.git
2.作為子模塊引入MixedReality-SpectorView贫堰。
git submodule add https://github.com/microsoft/MixedReality-SpectatorView.git sv
3.檢查確認(rèn)分支為master穆壕。
git branch
4.運行命令,等候時間稍長其屏。
tools\scripts\CreateUnityPackage.bat
Azure Spatial Anchors設(shè)置
1.注冊或登錄Azure賬戶喇勋, Microsoft Azure主頁。
2.點擊創(chuàng)建資源偎行,搜索Spatial Anchors(空間定位點)川背,點擊創(chuàng)建,參考文章蛤袒。
3.按下圖填寫信息熄云。
4.創(chuàng)建完成后,點擊創(chuàng)建的資源組妙真,選擇左側(cè)菜單欄的概述皱碘,可以查看賬戶ID,點擊左側(cè)菜單欄的訪問密鑰隐孽,可以查看主密鑰癌椿。(Unity配置中需要用到)
Unity設(shè)置
1.Unity打開SpectorView文件夾下Sample文件里的SpectatorView.Example.Unity健蕊。
2.選擇工具欄的Spectator View -> Edit Settings,勾選Broadcaster Settings組件下的Automatically Broadcast All Game Objects選項踢俄;添加組件Spatial Anchors Coordinate Localization Initializer缩功;復(fù)制先前創(chuàng)建好的Spatial Anchors賬戶的賬戶ID和主密鑰,填寫下方的Account id和Account Key都办。
Hololens部分
1.打開File -> Build Settings嫡锌,選擇Universal Windows Platform,設(shè)置如下琳钉,點擊Switch Platform势木。
2.選擇PlayerSettings,在列表中選擇Player -> Windows平臺 -> XR Settings歌懒。勾選Virtual Reality Supported啦桌,在下方Virtual Reality SDKs處添加Windows Mixed Reality。
3.打開File -> Build Settings及皂,在Scene中添加Hololens場景甫男,點擊Build。
Visual Studio設(shè)置
1.打開Unity打包項目验烧。
2.調(diào)試選擇Debug模式板驳,x86架構(gòu),部署目標(biāo)選擇設(shè)備碍拆。
3.第一次將應(yīng)用從電腦部署到Hololens時若治,系統(tǒng)會提示輸入目標(biāo)設(shè)備PIN,進(jìn)入Hololens設(shè)置中的Update and Security找到For Developers感混,點擊Pair端幼,將顯示的PIN輸入到電腦上。
4.選擇調(diào)試 -> 開始調(diào)試浩习。
5.戴上Hololens設(shè)備静暂,在應(yīng)用中找到示例項目,打開可以看到兩個立方體與一個球體谱秽。
Android部分
1.打開File -> Build Settings洽蛀,選擇Android,設(shè)置如下疟赊,點擊Switch Platform郊供。
2.選擇PlayerSettings,在列表中選擇XR Plug-in Management -> Android平臺近哟,勾選ARCore驮审。(若此處沒有該選項,打開Window -> Package Manager下載AR Core)
3.打開File -> Build Settings,在Scene中添加Hololens場景和Android場景疯淫,Android場景的序號為0地来,Hololens場景序號為1,點擊Build后通過adb命令將apk安裝到Android手機(jī)上熙掺。
連接測試
1.先用Hololens打開項目未斑,再用手機(jī)打開項目。
2.根據(jù)手機(jī)的提示輸入Hololens的IP地址币绩。(Hololens設(shè)置 -> 網(wǎng)絡(luò) -> 硬件屬性 -> 查看IP地址)
3.在Hololens上彈出的申請使用攝像頭提示蜡秽,點擊確認(rèn)。
4.使用Hololens掃描手機(jī)端的二維碼缆镣,掃描成功后手機(jī)上便有了第三人稱視角的項目芽突。
可能會遇到的錯誤
1.在命令行運行“tools\scripts\CreateUnityPackage.bat”時,提示定位不到MSBuild.exe文件董瞻,但通過搜索這個文件是存在的寞蚌。
Unable to locate MSBuild.exe
You can specify a -MSBuild variable specifying the path for MSBuild.exe if it isn't found at $MSBuildPath
解決辦法:通過命令行報錯提示的路徑位置發(fā)現(xiàn),默認(rèn)尋找路徑為Visual Studio的Enterprise版本力细,對“D:\Hololens\Spector\Spector\sv\tools\ci\scripts”路徑下的buildNativeProjectLocal.ps1進(jìn)行編輯睬澡,將路徑中的Enterprise改為電腦的Visual Studio版本(Community)即可固额。
2.在命令行運行“tools\scripts\CreateUnityPackage.bat”時眠蚂,提示如下錯誤:
Warning: The following VS instances are excluded because the English language pack is unavailable.
C:\Program Files (x86)\Microsoft Visual Studio\2019\Community
Please install the English language pack.
No suitable Visual Studio instances were found
解決辦法:在Visual Studio Installer處安裝英語語言包。
3.Unity中關(guān)于AR Kit的錯誤提示斗躏。
解決辦法:在Package Manager里更新AR Kit的版本逝慧,可能是版本過舊導(dǎo)致。
4.Unity中關(guān)于QRCode的錯誤提示啄糙。
解決辦法:查找官方文檔可知笛臣,在指定路徑缺少QRCode.dll文件,找到文件隧饼,復(fù)制到官方指定路徑沈堡。
5.Unity中在構(gòu)建安卓apk時出現(xiàn)的關(guān)于Gradle的錯誤提示。
Missing 'package' key attribute on element package at :arcore_client……燕雁。
解決辦法:打開 Preferences -> External Tools 把Gradle的路徑改為自己下載的Gradle路徑诞丽,然后再打開Project Settings -> Player -> Android -> Publishing Settings,勾選Custom Main Gradle Template和Custom Launcher Gradle Template后拐格,在選項下面對應(yīng)的路徑的地方會各生成一個文件僧免。
分別打開兩個文件,在第一行注釋下添加如下代碼捏浊,然后保存即可懂衩。參考文章。
buildscript {
repositories {
google()
jcenter()
}
dependencies {
// Must be Android Gradle Plugin 3.6.0 or later. For a list of
// compatible Gradle versions refer to:
// https://developer.android.com/studio/releases/gradle-plugin
classpath 'com.android.tools.build:gradle:3.6.0'
}
}
allprojects {
repositories {
google()
jcenter()
flatDir {
dirs 'libs'
}
}
}