カメラパイプラインモジュール
8th Wallカメラ・アプリケーションは、カメラ・パイプライン・モジュール・フレームワークを使用して構築 される。 アプリケーションは、実行時にアプリケーションの動作を制御するモジュールをインストールする。
アプリケーションにカメラパイプラインモジュールを追加する方法については、XR8.addCameraPipelineModule()を参照してください。
カメラパイプラインモジュールオブジェクトには、アプリケーション内で一意である .name 文字列が必要です。 以下のカメラ・ライフサイクル・メソッドの1つ以上を実装する必要があります。 これらのメソッドは、実行ループの適切な時点で実行される。
アプリケーションのメイン・ランタイム中、各カメラ・フレームは以下のサイクルを経る：
onBeforeRun->onCameraStatusChange (requesting->hasStream->hasVideo|failed) -> onStart->onAttach->onProcessGpu->onProcessCpu->onUpdate->onRender`.
カメラモジュールは、以下のカメラライフサイクルメソッドを1つ以上実装する必要があります：
| 機能 | 説明 |
|---|---|
| onAppResourcesLoaded | サーバーからアプリに添付されたリソースを受け取ったときに呼び出される。 |
| onAttach | モジュールが初めてフレームの更新を受け取る前に呼び出される。 パイプラインの実行前または実行後に追加されたモジュールに対して呼び出される。 |
| onBeforeRun | XR8.run()`](/legacy/api/xr8/run) の直後に呼び出される。 何らかの約束が返された場合、XRはすべての約束を待ってから続行する。 |
| onCameraStatusChange | カメラのアクセス許可要求中に変更が発生した場合に呼び出されます。 |
| onCanvasSizeChange | キャンバスのサイズが変更されたときに呼び出される。 |
| オンデタッチ | は、モジュールがフレームの更新を最後に受信した後に呼び出される。 これは、エンジンが停止した後か、モジュールがパイプラインから手動で取り外された後のどちらか早い方である。 |
| onDeviceOrientationChange | デバイスが横向き/縦向きに変わったときに呼び出される。 |
| onException | XRでエラーが発生したときに呼び出される。 エラーオブジェクトと共に呼び出される。 |
| オンポーズ | XR8.pause()`](/legacy/api/xr8/pause) が呼ばれたときに呼び出される。 |
| onProcessCpu | GPU処理の結果を読み取り、使用可能なデータを返すために呼び出される。 |
| onProcessGpu | GPU処理を開始するために呼び出される。 |
| onRemove | は、モジュールがパイプラインから削除されたときに呼び出される。 |
| onRender | onUpdateの後に呼び出される。 これはレンダリングエンジンがWebGLの描画コマンドを発行する時間です。 アプリケーションが独自のランループを提供し、XR8.runPreRender()とXR8.runPostRender()に依存している場合、このメソッドは呼び出されず、すべてのレンダリングは外部のランループによって調整されなければなりません。 |
| onResume | XR8.resume()`](/legacy/api/xr8/resume) が呼ばれたときに呼び出される。 |
| onStart | XRの開始時に呼び出される。 XR8.run()`](/legacy/api/xr8/run) が呼ばれた後の最初のコールバック。 |
| onUpdate | レンダリング前にシーンを更新するために呼び出される。 onProcessGpu](onprocessgpu.md)と[onProcessCpu`](onprocesscpu.md)のモジュールによって返されるデータは、processGpu.modulenameとprocessCpu.modulenameとして存在します。 |
| onVideoSizeChange | キャンバスのサイズが変更されたときに呼び出される。 |
| 必須パーミッション | モジュールは、許可要求が必要なブラウザの機能を示すことができます 。 これらは、もし適切なパーミッションがない場合、フレームワークが要求するために使用されるか、XRを実行する前に適切なパーミッションを要求するコンポーネントを作成するために使用される。 |
注：onProcessGpuまたはonProcessCpuを実装したカメラモジュールは、パイプラインの後続ステージにデータを提供することができます。 これはモジュール名によって行われる。