Unreal 中的 QR 代碼

如果您不熟悉 QR 代碼,建議您檢閱我們的 QR 代碼追蹤概觀

HoloLens 2 可以使用網路攝影機查看世界空間中的 QR 代碼,這會在每個代碼的真實世界位置中將其呈現為全息投影。 HoloLens 2 也可以在相同位置的多個裝置上呈現全像投影,以建立共用體驗。 確定您遵循將 QR 代碼新增至應用程式的最佳作法:

  • 寧靜區域
  • 光源和底圖
  • 大小、距離和角度位置

將 QR 代碼放在您的應用程式時,請特別注意環境考量。 您可以在我們的 QR 代碼追蹤概觀檔中,找到有關如何下載所需NuGet套件之每個主題的詳細資訊和指示。

警告

QR 代碼是現成可供 HoloLens 追蹤的唯一影像類型,HoloLens 上不支援 Unreal 的 UARTrackedImage 模組。 如果您需要追蹤自訂影像,則可以使用第三方影像辨識程式庫來存取裝置的網路攝影機並處理影像。

啟用 QR 偵測

因為 HoloLens 2 需要使用網路攝影機來查看 QR 代碼,所以您必須在專案設定中將其啟用:

  • 開啟[編輯 > Project 設定],捲動至 [平臺] 區段,然後選取[HoloLens]。
    • 展開 [功能] 區段,並勾選 [網路攝影機]。  
  • 您也必須新增 ARSessionConfig 資產,來加入 QR 代碼追蹤。

如果您使用的是 UE 4.26,建議您使用下列藍圖設定新增較小的延遲,因為在啟動 AR 工作階段之後,必須初始化 QR 代碼追蹤:

Blueprint of the Toggle ARCapture function with delay

設定已追蹤的 QR 代碼

QR 代碼會透過 Unreal 的 AR 追蹤幾何系統呈現為追蹤的影像。 若要讓此作業運作,您必須:

  1. 建立動作項目藍圖並新增 ARTrackableNotify 元件:

QR AR Trackable Notify

  1. 選取 [ARTrackableNotify],然後展開 [詳細資料] 面板中的 [事件] 區段:

QR Events

  1. 按一下 +[新增追蹤幾何]旁的 ,將節點新增至事件Graph。

Add node to On Add Tracked Geometry

使用已追蹤的 QR 代碼

下圖中的事件圖形會顯示用來在 QR 代碼中心呈現點的 OnUpdateTrackedImage 事件,並印出其資料。

以下是後續動作:

  1. 首先,追蹤的影像會強制轉型為 ARTrackedQRCode,以檢查目前更新的影像是否為 QR 代碼。
  2. 編碼的資料是從 QRCode 變數中擷取的。 您可以從 GetLocalToWorldTransform 的位置,以及具有 GetEstimateSize 的維度,到達 QR 代碼的左上角。

您也可以在程式碼中取得 QR 代碼的座標系統

尋找唯一識別碼

每個 QR 代碼都有唯一的 guid 識別碼,您可以透過下列方式找到該識別碼:

  • 拖放 As ARTracked QRCode 釘選並搜尋 [取得唯一識別碼]。

QR Guid

下一個開發檢查點

如果您遵循我們配置的 Unreal 開發檢查點旅程 ,您可以繼續進行下一個主題:

或者,直接跳到在裝置或模擬器上部署應用程式的主題:

您可以隨時回到 Unreal 開發檢查點

另請參閱