本文へスキップ

XR8.PlayCanvas.runXr() (非推奨)

XR8.PlayCanvas.runXr( {pcCamera, pcApp}, [extraModules], config ).

説明​

カメラを開き、PlayCanvas シーン内で XR World Tracking または Image Targets の実行を開始します。

パラメータ​

パラメータ説明
pcCameraARでドライブするPlayCanvasシーンカメラ。
pcAppPlayCanvas アプリ、通常は this.app。
extraModules [オプション］インストールする追加パイプラインモジュールの配列（オプション）。
コンフィグXR8.run()`](/legacy/api/xr8/run) に渡す設定パラメータ。

config`は以下のプロパティを持つオブジェクトである：

プロパティタイプデフォルト説明
キャンバスHTMLCanvasElement`カメラフィードが描画されるHTMLキャンバス。 通常、これは「application-canvas」である。
webgl2 [オプション］ブーリアンfalse`trueの場合、WebGL2が利用可能であればWebGL2を使用し、そうでなければWebGL1にフォールバックします。 false の場合、常に WebGL1 を使用します。
ownRunLoop [オプション］ブーリアンfalse`もしtrueなら、XRはそれ自身のランループを使うはずだ。 falseの場合、実行ループを自分で用意し、XR8.runPreRender()とXR8.runPostRender()を自分で呼び出す必要があります。
cameraConfig： {direction} [オプション］オブジェクト{direction：XR8.XrConfig.camera().BACK}。使用したいカメラ 使用可能なdirectionの値はXR8.XrConfig.camera().BACKまたはXR8.XrConfig.camera().FRONTです。
glContextConfig [オプション]。WebGLContextAttributes`。null`。WebGL canvas コンテキストを設定する属性。
allowedDevices [オプション］XR8.XrConfig.device()XR8.XrConfig.device().MOBILE`。パイプラインを実行するデバイスのクラスを指定する。 現在のデバイスがそのクラスでない場合、カメラを開く前に実行が失敗します。 allowedDevicesがXR8.XrConfig.device().ANYの場合、常にカメラを開きます。 ワールドトラッキングはXR8.XrConfig.device().MOBILEでのみ使用できることに注意してください。

{#returns}を返す。​

なし

例​

var xrcontroller = pc.createScript('xrcontroller')

// オプションで、ワールドトラッキングを無効にして、イメージターゲットをトラッキングする際の効率を上げることができる。
xrcontroller.attributes.add('disableWorldTracking', {type: 'Boolean'})

xrcontroller.prototype.initialize = function() {
  const disableWorldTracking = this.disableWorldTracking

  // XRが完全にロードされた後、カメラフィードを開き、AR表示を開始します。
  const runOnLoad = ({pcCamera, pcApp}, extramodules) => () => {
    XR8.xrController().configure({disableWorldTracking})
    // canvas名を渡します。通常は 'application-canvas' です。
    const config = {canvas: document.getElementById('application-canvas') } // キャンバス名を渡します。
    XR8.PlayCanvas.runXr({pcCamera, pcApp}, extraModules, config)
  } // PlayCanvas 内のカメラを探します。


  //
  const pcCamera = XRExtras.PlayCanvas.findOneCamera(this.entity)

  // XRがまだロードしている間に、役に立つものをいくつか表示する。
  // もうすぐです：ユーザーの環境が Web ar をサポートできるかどうかを検出し、サポートしていない場合は
  // エクスペリエンスを表示する方法のヒントを表示します。
  // ロード中: カメラの許可を求めるプロンプトを表示し、表示の準備が整うまでシーンを隠します。
  // ランタイムエラー：予期しないことが発生した場合、エラー画面を表示します。
  XRExtras.Loading.showLoading({onxrloaded: runOnLoad({pcCamera, pcApp: this.app}, [
    // 開発者がカスタマイズまたはテーマ化したいオプションモジュール。
    XRExtras.AlmostThere.pipelineModule(), // サポートされていないブラウザを検出し、ヒントを与えます。
    XRExtras.Loading.pipelineModule(), // 起動時のローディング画面を管理します。
    XRExtras.RuntimeError.pipelineModule(), // ランタイムエラー時にエラー画像を表示します。
  ])})
}