メインコンテンツへスキップ

PlayCanvasイベント

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

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

発生するイベント​

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

XR8.XrControllerの発生イベント​

XR8.XrController.pipelineModule()がextraModulesでXR8.PlayCanvas.run()に渡されて追加されると、以下のイベントが発生します。

発生するイベント説明
xr:imageloadingこのイベントは、検出画像の読み込みが始まると発生します。
xr:imagescanningこのイベントは、すべての検出画像が読み込まれてスキャンが開始されたときに発生します。
xr:imagefoundこのイベントは、イメージ・ターゲットが最初に見つかったときに発生します。
xr:imageupdatedこのイベントは、イメージ・ターゲットの位置、回転、拡大縮小が変化したときに発生します。
xr:imagelostこのイベントは、イメージ・ターゲットが追跡されなくなったときに発生します。
xr:meshfoundこのイベントは、開始後またはrecenter()の後にメッシュが初めて見つかったときに発生します。
xr:meshupdatedこのイベントは、最初に見つかった メッシュの位置や回転が変化したときに発生します。
xr:meshlostこのイベントは、 recenter() が呼び出されたときに発生します。
xr:projectwayspotscanningこのイベントは、すべてのProject Wayspotがスキャン用にロードされたときに発生します。
xr:projectwayspotfoundこのイベントは、Project Wayspotが初めて発見されたときに発生します。
xr:projectwayspotupdatedこのイベントは、Project Wayspotの位置や回転が変化したときに発生します。
xr:projectwayspotlostこのイベントは、Project Wayspotが追跡されなくなったときに発生します。

XR8.LayersControllerの発生イベント​

XR8.LayersController.pipelineModule()がextraModulesでXR8.PlayCanvas.run()に渡されて追加されると、以下のイベントが発生します。

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

XR8.FaceControllerの発生イベント​

XR8. FaceController.pipelineModule()がextraModulesでXR8.PlayCanvas.run()に渡されて追加されると、以下のイベントが発生します。

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

XR8.HandControllerが発信するイベント​

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

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