運行 Snapdragon Spaces 應用(yòng)程序 - ThinkReality A3

Snapdragon Spaces SDK 開發工(gōng)具(jù)包中(zhōng)包含一個安(ān)卓服務(wù)應用(yòng)程序，該程序支持運行感知算法、支持與眼鏡通信以及處理(lǐ) OpenXR Runtime。

安(ān)裝(zhuāng) Snapdragon Spaces Services

Snapdragon Spaces Services apk 目前包含在 SDK 下載中(zhōng)。一旦進入應用(yòng)商(shāng)店(diàn)，将會有(yǒu)可(kě)獲取的一個補充下載用(yòng)于運行專為(wèi) Snapdragon Spaces 設計的應用(yòng)程序。

目前，需要手動安(ān)裝(zhuāng)和設置。請遵循以下步驟：

前置條件

這一步驟，要求運行前，先在電(diàn)腦上安(ān)裝(zhuāng) Android debugbridge(ADB)

●設置移動設備以啓用(yòng)開發者選項，并啓用(yòng) USB 調試。

●将移動設備連接至電(diàn)腦，并授權 USB 調試。

●從開發門戶下載可(kě)用(yòng)的 SDK 之一，并将它們解壓到本地文(wén)件夾。

●在解壓文(wén)件夾的頂層找到 Snapdragon Spaces Services .apk，并通過 adb install 安(ān)裝(zhuāng)它們。

●檢查示例 Sample apk 的子文(wén)件夾，并使用(yòng) adb install 命令安(ān)裝(zhuāng)它們。

設置 Snapdragon Spaces Services

您需對 Snapdragon Services 進行配置，以獲得成功的開發者體(tǐ)驗：

●在應用(yòng)程序啓動器中(zhōng)找到 Snapdragon Spaces Services 應用(yòng)程序。

●長(cháng)按此按鈕并選擇 “應用(yòng)程序信息”。

●點擊 “權限” 并驗證允許 相機 權限，如果不想這樣設置，請點擊并将其設置為(wèi) “僅在使用(yòng)該應用(yòng)程序時允許”。

●Snapdragon Spaces Services 應用(yòng)程序可(kě)從應用(yòng)程序啓動器中(zhōng)進入，也可(kě)點擊應用(yòng)程序信息設置頁(yè)面中(zhōng)的 “打開” 按鈕進入。

●選擇 “在其他(tā)應用(yòng)程序之上顯示”，并對 Snapdragon Spaces Services 開啓此權限。

驗證應用(yòng)程序啓動

通過上述步驟配置 Snapdragon Spaces Services 後，此步驟将驗證設備是否已完全設置所提供的 Snapdragon Spaces 應用(yòng)程序。

●對于 A3 眼鏡：确保眼鏡與手機連接并啓動。該應用(yòng)程序可(kě)能(néng)會拆分(fēn)式的出現在眼鏡上，或者 ThinkReality 徽标可(kě)能(néng)出現在眼鏡上。其中(zhōng)任何一個都正常。

●在移動設備上，從 “所有(yǒu)應用(yòng)程序”層或主屏幕上點擊 Snapdragon Spaces Samples 應用(yòng)程序圖标。

●如果 Snapdragon Spaces Services 沒有(yǒu)正确安(ān)裝(zhuāng)或設置完整，請務(wù)必檢查上述安(ān)裝(zhuāng) Snapdragon Spaces Services 的步驟。

●首次運行應用(yòng)程序時可(kě)能(néng)會出現一些必要的權限彈出窗口。某些感知跟蹤功能(néng)（例如平面檢測、圖像跟蹤和手部跟蹤）需要相機權限，因此應該被允許。“在其他(tā)應用(yòng)程序上顯示”是應用(yòng)正确渲染的另一個必要設置，需要手動啓用(yòng)。

●在Spaces Services和權限檢查完成後，Controller Companion 應用(yòng)程序應會立即出現在手機上，而主應用(yòng)程序應在短暫延遲後出現在 AR 眼鏡上。（這是由于運行時需要啓動而導緻的，這可(kě)能(néng)需要幾秒(miǎo)鍾的時間。）

●在繼續之前驗證示例應用(yòng)程序是否運行。

安(ān)裝(zhuāng)并運行 Spaces 應用(yòng)程序

設備驗證後，Spaces Apps 現在可(kě)以在設備上安(ān)裝(zhuāng)和測試。

1、使用(yòng) adb install 從計算機安(ān)裝(zhuāng)應用(yòng)程序

2、從 Google Play 應用(yòng)商(shāng)店(diàn)安(ān)裝(zhuāng)應用(yòng)程序

3、使用(yòng) Unity 或虛幻引擎開發應用(yòng)程序

4、從聯想 UDC 客戶端接收應用(yòng)程序（需要按照硬件設置中(zhōng)注明的方式，由高通推送）

備注

以下是有(yǒu)關這些平台的附加說明。

關于 ThinkReality A3 應用(yòng)程序

ThinkReality A3 應用(yòng)程序不是 Spaces 應用(yòng)程序

在 A3 眼鏡上，請注意以下應用(yòng)程序不是 Snapdragon Spaces 的一部分(fēn)，而是另一個平台，即ThinkReality A3 平台的一部分(fēn)。

●聯想 UDC

●Companion

●A3 Home

●A3 Cast

●Model Viewer（模型查看器）

有(yǒu)關 ThinkReality 的更多(duō)信息，請查看聯想支持網站。請注意，您 不需要聯想 ID 或組織ID來設置設備，請參考 Spaces 門戶上的 ThinkReality A3 設置。

此外，Companion 應用(yòng)程序會默認自動啓動。可(kě)以通過 打開開發者模式 來更改此默認。

關于從手機設備上拔下 A3 眼鏡

在拔下 A3 眼鏡之前關閉正在運行的 Spaces 應用(yòng)程序

建議在拔下 A3 眼鏡之前，關閉或強制停止所有(yǒu) Spaces 應用(yòng)程序。如果在 Spaces 應用(yòng)程序運行時斷開眼鏡連接，将需要重新(xīn)啓動手機才能(néng)正确運行 OpenXR 應用(yòng)程序。為(wèi)了獲得最佳的開發者體(tǐ)驗，請按照 應用(yòng)程序關閉 中(zhōng)的步驟操作(zuò)。

應用(yòng)程序關閉

由于應用(yòng)程序的主要活動是在查看器上啓動的，因此它不會出現在 Android 中(zhōng)的多(duō)任務(wù)視圖/最近的應用(yòng)程序列表中(zhōng)。

要關閉 Snapdragon Spaces Unity 或 Unreal Engine 示例應用(yòng)，請執行以下操作(zuò)之一：

●長(cháng)按手機控制器的 MENU 鍵 2 秒(miǎo)（在SampleController.csUnity 中(zhōng)的腳本中(zhōng)實現），或者

●瞄準眼鏡中(zhōng)主菜單場景中(zhōng)的“退出”按鈕并激活它。

對于不提供退出功能(néng)的應用(yòng)程序，可(kě)以使用(yòng)Android 上的強制停止來關閉應用(yòng)程序，如下一節所述。

應用(yòng)程序強制停止

由于大多(duō)數 Spaces 應用(yòng)程序是通過在查看器上啓動來運行的（請參考架構），因此無法使用(yòng)傳統的 Android 系統通過系統優雅地關閉正在運行的應用(yòng)程序。因此，Spaces 應用(yòng)程序應該處理(lǐ)應用(yòng)内的 UI 以關閉應用(yòng)程序。如果此 UI 未實施或不可(kě)用(yòng)，則可(kě)能(néng)需要手動關閉應用(yòng)程序。

可(kě)以通過在應用(yòng)程序啓動器中(zhōng)長(cháng)按應用(yòng)程序圖标，直到出現顯示 應用(yòng)程序信息 的上下文(wén)菜單為(wèi)止。打開應用(yòng)程序信息視圖後，可(kě)以通過點擊 強制停止 按鈕來停止應用(yòng)程序。

故障排除

如果您在運行硬件或應用(yòng)程序時遇到問題，請查看本節中(zhōng)包含的可(kě)能(néng)遇到的一些常見問題。

檢查您的設置

請确保您按照最新(xīn)版本的硬件設置和相應的引擎設置指南操作(zuò)：

●設置手機和眼鏡的過程

●開始使用(yòng) Unity 引擎的 Snapdragon Spaces SDK

●開始使用(yòng)虛幻引擎的 Snapdragon Spaces SDK

如果您遇到上述技(jì )術無法解決的問題，請嘗試以下方法；

1、将眼鏡從手機上拔下。

2、确保手機電(diàn)量充足。

3、重啓手機，等待啓動完成。

4、插入眼鏡，等待它們完成啓動 - 大約 15 秒(miǎo)鍾，您就會看到 ThinkReality 标志(zhì)。

5、嘗試提供的 Spaces 應用(yòng)程序，例如 SDK 下載中(zhōng)的示例之一。

6、如果有(yǒu)效，請退出示例應用(yòng)程序并啓動您自己的應用(yòng)程序。

如果您仍然遇到問題，請聯系支持論壇以獲取更多(duō)幫助。