本文へスキップ

XR8.PlayCanvas.run()

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

説明​

指定したパイプラインモジュールを追加し、カメラを開きます。

パラメータ​

パラメータタイプ説明
pcCamerapc.CameraComponentARでドライブするPlayCanvasシーンカメラ。
pcApppc.ApplicationPlayCanvas アプリ、通常は this.app。
extraModules [オプション］オブジェクトインストールする追加パイプラインモジュールの配列（オプション）。
コンフィグcanvas、webgl2、ownRunLoop、cameraConfig、glContextConfig、allowedDevices、layers}`。XR8.run()](/legacy/api/xr8/run)に渡す設定パラメータと、PlayCanvas固有の設定（layers`など）。

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

プロパティタイプデフォルト説明
キャンバスHTMLCanvasElement`カメラフィードが描画されるHTMLキャンバス。 通常、これは document.getElementById('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でのみ使用できることに注意してください。
レイヤー [オプション］[][]GlTextureRendererを使って描画するレイヤーのリストを指定する。 キーは8th Wallのレイヤー名で、値は8th Wallレイヤーを使用してテクスチャとマスクにレンダリングするPlayCanvasレイヤー名のリストです。 値の例: {"sky"：["FirstSkyLayer", "SecondSkyLayer"]}`.

{#returns}を返す。​

なし

例​

var layerscontroller = pc.createScript('layerscontroller')

layerscontroller.prototype.initialize = function() {
  // XRが完全にロードされた後、カメラフィードを開き、AR表示を開始する。
  const runOnLoad = ({pcCamera, pcApp}, extramodules) => () => {
    // キャンバス名を渡す。
    const config = {
      canvas: document.getElementById('application-canvas'),
      layers：{"sky"：[空"]}。
    }
    XR8.PlayCanvas.run({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(), // ランタイムエラー時にエラー画像を表示する。
    XR8.LayersController.pipelineModule(), // スカイエフェクトのサポートを追加します。
  ])})
}