Magic Leap開發指南（2）-- Hello,Cube！

這篇文章主要是教你們運行Lumin並在現實環境中顯示一個Cube。

Step 1:開發前的準備

• Magic Leap One眼鏡完成開發人員設置。

• 打開並解鎖你的設備。

• 打開你的控制器。

• 確保設備已準備好進行開發。

• 安裝任何版本的Microsoft Visual Studio 2017 (Windows)或Microsoft Visual Studio Code (Windows / macOS)。

• Package Manager安裝Lumin Runtime Editor和Lumin運行時的SDK。

• 建立開發人員證書。

對以上流程不熟悉的話，能夠參考文章：juejin.im/post/5d1896…

Step 2:安裝和配置Magic Leap Visual Studio 2017擴展(Windows)

該擴展爲Visual Studio 2017添加了Magic Leap特有的功能。

1.安裝並配置Magic Leap Visual Studio 2017擴展。

• 在Package Manager中，在Common Packages下，安裝Visual Studio 2017 Extension。

• 單擊右邊窗口中的Launch Installer。以下圖：

​

2.將開發人員證書添加到Visual Studio。

• 單擊Tools > Options。

• 從列表中展開Magic Leap-SDKs，而後在Package Signing Certificate File中添加Magic Leap開發人員證書的路徑。以下圖：

​

Step 3:安裝和配置Magic Leap Visual Studio代碼擴展(Windows / macOS)

1.使用 Magic Leap Package Manager下載這個Common Packages > Visual Studio Code Extension package。

2.啓動Visual Studio Code。

3.單擊左邊的Extensions圖標。

4.單擊……圖標，單擊Install from VSIX，而後選擇Visual Studio代碼擴展名. VSIX文件。一般狀況下,路徑是 /Users/user/MagicLeap/tools/visual_studio_code/vx.x.x./ mlextension-x.x.x.vsix ，以下圖：

​

5.從新加載Visual Studio Code。

6.點擊左側的這個圖標​ 。

7.在Lumin SDK窗口標題中，單擊​圖標，而後設置Lumin SDK的路徑。一般路徑是,/Users/user/MagicLeap/mlsdk/v0.x.x。

8.在Signing Certificate窗口標題中，單擊​圖標，而後設置.cert包簽名證書文件的路徑。

Step 4:建立一個新的Lumin Runtime Editor項目

咱們打開Lumin Runtime 編輯器來建立咱們的場景（這將在後臺自動生成代碼，將場景加載到Visual Studio或Visual Studio代碼項目中）。

1.在Package Manager中，向下滾動到Lumin Runtime Editor，而後單擊右窗口的Launch按鈕。以下圖：

​

2.在Lumin Runtime 點擊 New Project。

​

3.填寫項目的相關信息，示例以下圖：

​

4.單擊Create Project。建立項目時，會彈出一個對話框，點擊OK便可。以下圖：

​

5.順利進入咱們的項目場景中。

​

Step 5:設置你的External Editor

在對項目進行更改以前，確保Lumin Runtime編輯器使用Visual Studio或Visual Studio Code來編輯代碼。

1.在File菜單中，點擊Editor Preferences。

2.在編輯器首選項對話框中，點擊Src Editor (Ext)。

3.若是Editor和Path爲空，則選擇你的編輯器，並將路徑添加到編輯器中。好比：

• 對於Visual Studio (Windows):

​

• 對於Visual Studio Code (Windows / macOS):

​

4.點擊Apply and Close。

Step 6:Add in assets

1.在 Asset Library，Model右鍵單擊，選中Import File。以下圖：

​

2.在這個SourceArt\Model\Primitives文件夾下，選擇這個Cube_P.FBX文件。可能你須要導航到Magic Leap\mlsdk\<SDK version>\lumin\runtime\editor\template\pipeline\SourceArt這個文件夾下。

3.而後點擊OK。

此時Cube就會生成，效果以下圖：

​

Step 7:建立你的Scene

如今咱們須要將Cube添加到場景中去。

1.在場景層次結構中，右鍵單擊root。而後插入一個模型。點擊Insert > Core > Model。以下圖：

​

2.點擊Model這個文件夾，選中剛剛生成的Cube_P.FBX。以下圖：

​

3.設置Cube的一些參數（如下數據可供參考）：

• Id: cube

• Shader: UnlitTextured

• Opaque: selected

• Transform Position: to 0.0, -0.25, -0.75.

• Transform Scale: to 0.5, 0.5, 0.5

​

4.保存場景。

​

Step 8:在Visual Studio (Windows)中構建應用程序

1.先在Lumin Runtime編輯器的Project菜單上，點擊Code Generation > Open code in External Editor。而後用Visual Studio打開你的項目。

2.當提示時，單擊Yes建立Visual Studio項目。

​

3.將應用程序構建爲.mpk文件並將其部署到設備上。

• 把你的設備插入電腦。

• 選擇Debug-ML。

​

4.運行APP，效果以下圖：

​

構建一個x64應用程序並在Magic Leap Remote上調試。（對Magic Leap Remote不瞭解的話，能夠參考：Magic Leap開發指南（1）--開發前準備）

• 啓動Remote程序。

• 選擇Debug-ML。

​

• 單擊Local Windows Debugger運行應用程序。

​

Step 9:在Visual Studio代碼(Windows / macOS)中構建應用程序

1.先在Lumin Runtime編輯器的Project菜單上，點擊Code Generation > Open code in External Editor。而後用Visual Studio打開你的項目。

2.當出現此窗口時，單擊OK:

​

3.在Visual Studio Code打開你的項目。生成.mpk文件並在在設備上debug調試。

• 把你的設備插入電腦。

• 單擊左邊的圖標​。

• 將調試目標設置爲Lumin OS Debug。

• 單擊三角形圖標開始調試。

4.構建一個x86應用程序並在Magic Leap Remote上調試:

• 啓動Magic Leap Remote。

• 單擊左邊的圖標​。

• 將調試目標設置爲Host OS Debug。

• 單擊三角形圖標開始調試。

總體的流程與步驟8的操做相似。

Tips：

1.若是是第一次在設備上部署應用程序，則會打開一個安裝證書的通知。接受證書安裝應用程序便可。

2.若是你什麼也沒看到，嘗試轉動頭部看看你周圍的環境。

3.注意:設備啓動時所面對的方向決定了它在世界上的初始方向。

------AR Portal（AR開發者社區）整理

關注微信公衆號（AR開發者交流社區，提供AR開發乾貨，推進AR內容發展）：AR開發者社區