本文へスキップ

XR8.XrController.configure()

XrController.configure({ disableWorldTracking, enableLighting, enableWorldPoints, enableVps, imageTargets：[]、leftHandedAxes、mirroredDisplay、projectWayspots、scale })。

説明​

XrController`が実行する処理を設定する（設定によってはパフォーマンスに影響する場合がある）。

パラメータ​

パラメータタイプデフォルト説明
disableWorldTracking [オプション]。ブーリアンfalse`もしtrueなら、効率化のためにSLAMトラッキングをオフにする。 これは、XR8.run()が呼び出される **前に行う必要があります。
enableLighting［オプション］ブーリアンfalse`true の場合、lighting は XR8.XrController.pipelineModule() によって processCpuResult.reality.lighting として提供される。
enableWorldPoints [オプション］ブーリアンfalse`trueの場合、worldPointsはXR8.XrController.pipelineModule()からprocessCpuResult.reality.worldPointsとして提供されます。
enableVps [オプション］ブーリアンfalse`もしそうなら、プロジェクト・ロケーションとメッシュを探す。 返されるメッシュはプロジェクト・ロケーションとは関係なく、プロジェクト・ロケーションが設定されていなくても返されます。 VPS を有効にすると、scale と disableWorldTracking の設定が上書きされる。
imageTargets [オプション］配列検出する画像ターゲットの名前のリスト。 実行時に変更可能。 注意：現在アクティブなイメージターゲットはすべて、このリストで指定されたものに置き換えられます。
leftHandedAxes [オプション]。ブーリアンfalse`trueの場合、左手座標を使用する。
mirroredDisplay［オプション］ブーリアンfalse`trueの場合、出力の左右を反転する。
projectWayspots [オプション］配列[]ローカライズ専用のプロジェクトロケーション名のサブセット。 空の配列が渡された場合、近くにあるすべてのプロジェクトロケーションをローカライズします。
scale [オプション］文字列レスポンシブレスポンシブ」または「アブソリュート」のいずれか。 responsiveはフレーム1のカメラが[XR8.XrController.updateCameraProjectionMatrix()](updatecameraprojectionmatrix.md)で定義された原点に来るように値を返します。 absoluteはカメラ、イメージターゲットなどをメートル単位で返す。 absoluteを使用する場合、スケールが推定されると、開始ポーズのx-position、z-position、rotationは[XR8.XrController.updateCameraProjectionMatrix()`](updatecameraprojectionmatrix.md)で設定されたパラメータを尊重します。 y-positionは接地面からのカメラの物理的な高さに依存する。

重要: disableWorldTracking: true は、XR8.XrController.pipelineModule()とXR8.run()がコールされる前に設定する必要があります。

{#returns}を返す。​

なし

例​

XR8.XrController.configure({enableLighting: true, disableWorldTracking: false, scale: 'absolute'})

例 - VPS {#example---enable-vps}を有効にする​

XR8.XrController.configure({enableVps: true})

例 - ワールドトラッキングを無効にする​

//
XR8.XrController.configure({disableWorldTracking: true})
// カメラを開き、カメラランループの実行を開始
XR8.run({canvas: document.getElementById('camerafeed')})

例 - アクティブイメージターゲットセットの変更​

XR8.XrController.configure({imageTargets: ['image-target1', 'image-target2', 'image-target3']})