本文へスキップ

PlayCanvas イベント

このセクションでは、PlayCanvas環境で8th Wallによって発生するイベントについて説明します。

Webアプリケーションでこれらのイベントをリッスンすることができます。

イベント​

イベント説明
xr:camerastatuschangeこのイベントはカメラのステータスが変更されたときに発行される。 可能なステータスの詳細については、XR8.addCameraPipelineModule() の onCameraStatusChange を参照してください。
xr:realityerrorこのイベントは8th Wall Webの初期化時にエラーが発生した場合に発行されます。 これは、エラーメッセージが表示されるべき推奨時間である。 XR8.XrDevice()` API](/legacy/api/xrdevice) は、どのようなエラーメッセージを表示するかを決めるのに役立ちます。
xr:realityreadyこのイベントは8th Wall Webが初期化され、少なくとも1つのフレームが正常に処理された時に発行される。 これは、あらゆるローディング要素を非表示にすべき推奨時間である。
xr:screenshoterrorこのイベントは、エラーが発生した screenshotrequest に応答して発行される。
xr:screenshotreadyこのイベントは、screenshotrequest イベントが正常に完了したことに応答して発行される。 AFrameキャンバスのJPEG圧縮画像が提供されます。

XR8.XrController 発生イベント​

XR8.PlayCanvas.run()の extraModulesにXR8.XrController.pipelineModule()` を渡して追加すると、これらのイベントが発生します：

イベント説明
xr:imageloadingこのイベントは、検出画像のロードが開始されたときに発行されます。
xr:imagescanningこのイベントは、すべての検出画像がロードされ、スキャンが開始されたときに発行される。
xr:imagefoundこのイベントは、イメージターゲットが最初に見つかったときに発行される。
xr:imageupdatedこのイベントは、イメージターゲットが位置、回転、スケールを変更したときに発行されます。
xr:imagelostこのイベントは、イメージターゲットが追跡されなくなったときに発行される。
xr:meshfoundこのイベントは、開始後またはrecenter()の後にメッシュが最初に見つかったときに発行されます。
xr:meshupdatedこのイベントは、最初に見つかった**メッシュの位置や回転が変化したときに発行されます。
xr:meshlostこのイベントは recenter() が呼ばれたときに発生する。
xr:projectwayspotscanningこのイベントは、すべてのプロジェクトロケーションがスキャンのためにロードされたときに発行されます。
xr:projectwayspotfoundこのイベントは、プロジェクトロケーションが最初に見つかったときに発行されます。
xr:projectwayspotupdatedこのイベントは、プロジェクトロケーションが位置や回転を変更したときに発行されます。
xr:projectwayspotlostこのイベントは、プロジェクトの場所が追跡されなくなったときに発行されます。

XR8.LayersController 発生するイベント​

XR8.PlayCanvas.run()の extraModulesにXR8.LayersController.pipelineModule()` を渡して追加すると、これらのイベントが発生します：

イベント説明
xr:layerloading追加のレイヤーセグメンテーションリソースのロードが始まるときに発生します。
xr:layerscanningすべてのレイヤーセグメンテーションリソースがロードされ、スキャンが開始されたときに発生する。 スキャンされるレイヤーごとに1つのイベントがディスパッチされる。
xr:layerfoundレイヤーが最初に見つかったときに発火する。

XR8.FaceController 発生イベント​

XR8.FaceController.pipelineModule()を XR8.PlayCanvas.run()のextraModules` に渡して追加すると、これらのイベントが発生します：

イベント説明
xr:faceloadingフェースARの追加リソースのロードが開始されたときに発生します。
xr:facescanningすべてのフェイスARリソースがロードされ、スキャンが開始されたときに発火する。
xr:facefound顔が最初に見つかったときに発火する。
xr:faceupdatedその後に顔が見つかると発火する。
xr:facelost顔が追跡されなくなったときに発生します。

XR8.HandController 発生イベント​

XR8.PlayCanvas.run()の extraModulesにXR8.HandController.pipelineModule()` を渡して追加すると、これらのイベントが発生します：

イベント説明
xr:handloadingハンドARの追加リソースのロード開始時に発火する。
xr:handscanningすべてのハンドARリソースがロードされ、スキャンが開始されたときに発火する。
xr:handfoundハンドが最初に見つかったときに発射される。
xr:handupdated続いて手が見つかったときに発射される。
xr:handlost手が追跡されなくなったときに発火する。