使用 Jetpack XR 的 ARCore 在應用程式中擷取深度資訊

適用的 XR 裝置
本指南可協助您為這類 XR 裝置打造體驗。
XR 頭戴式裝置
有線 XR 眼鏡

應用程式可以透過 ARCore for Jetpack XR 擷取深度資訊,判斷實體物件與裝置的距離。

建立 ARCore for Jetpack XR 工作階段

透過 ARCore for Jetpack XR Session 取得深度資訊。如果您使用 Jetpack Compose for XR 強化空間 UI,請從 Jetpack Compose for XR 存取工作階段。如果您使用 Jetpack SceneCore 程式庫中的空間化實體,請從 Jetpack XR Runtime 存取工作階段。

設定工作階段

根據預設,XR 工作階段不會啟用深度圖擷取功能。如要啟用深度圖擷取功能,請設定工作階段並設定 DepthEstimationMode:

val newConfig = Config.Builder(session.config)
    .setDepthEstimation(DepthEstimationMode.SMOOTH_ONLY)
    .build()
when (val result = session.configure(newConfig)) {
    is SessionConfigureSuccess -> TODO(/* Success! */)
    else ->
        TODO(/* The session could not be configured. See SessionConfigureResult for possible causes. */)
}

DepthEstimationMode 的可用值如下:

  • DISABLED:未提供場景深度資訊。
  • RAW_ONLY:啟用深度估算功能,並提供原始深度和信心值。
  • SMOOTH_ONLY:啟用深度估算功能,並提供平滑深度和信心值。
  • SMOOTH_AND_RAW:啟用深度估算功能,並提供原始和流暢的深度和信心值。

原始深度圖可提供更準確的深度估算值,但原始深度圖片可能不包含相機圖片中所有像素的深度估算值。相較之下,平滑深度圖會提供每個像素的預估深度,但由於深度預估值的平滑化和內插,每個像素的深度資料可能較不準確。

檢查深度圖功能

不同裝置的功能各異。配備立體相機設定的裝置,可提供左右相機的深度估算圖。同樣地,只有單一相機的裝置只能提供單一相機的深度估算圖。

如要查看裝置支援哪些深度圖,請使用 XrDevice.isRenderingModeSupported:

val xrDevice = XrDevice.getCurrentDevice(context)
val hasMonoDepth = xrDevice.isRenderingModeSupported(RenderingMode.MONO)
val hasStereoDepth = xrDevice.isRenderingModeSupported(RenderingMode.STEREO)

擷取深度資料

如要取得特定相機的深度資料,請使用 Depth:

if (hasStereoDepth) {
    val depthMap = Depth.left(session)
}

計算深度值

您可以從產生的深度圖中取得深度和信心值:

if (hasStereoDepth) {
    val depthMap = Depth.left(session)
}

視使用的設定而定,請使用 smoothDepthMap 或 rawDepthMap 存取對應的深度圖。這些地圖中的測量值以公尺表示。您也可以使用 smoothConfidenceMap 和 rawConfidenceMap 存取信心值。這些值的範圍介於 0 到 255 之間,255 代表可信度最高。

如要轉譯深度圖以進行偵錯或視覺化,請參閱 ARCore 測試應用程式的深度部分。