AFrame Events
このセクションでは、 xrweb 、 xrface 、 xrhand のA-Frameコンポーネントで発生するイベントについて説明します。
Webアプリケーションでこれらのイベントを待ち受け、イベントを処理する関数を呼び出すことができます。
xrconfig によって発生するイベント
xrconfig （ xrweb 、 xrface 、 xrhand または xrlayers のみを使用している場合は自動的に追加されます）によって、以下のイベントが発生します。
| 発生するイベント | 説明 |
|---|---|
| camerastatuschange | カメラの状態が変化したときに発生するイベントです。 状況の詳細については、 onCameraStatusChange XR8.addCameraPipelineModule() を参照してください。 |
| realityerror | このイベントは、8th Wall Webの初期化時にエラーが発生した場合に発生します。 これは、エラーメッセージを表示する推奨タイミングです。 XR8.XrDevice() API は、どのタイプのエラーメッセージを表示するかを決定するのに役立ちます。 |
| realityready | このイベントは、8th Wall Webが初期化され、少なくとも1つのフレームが正常に処理されたときに発生します。 これは、あらゆるローディング要素を非表示にするために推奨されるタイミングです。 |
| screenshoterror | このイベントは、 screenshotrequest イベントがエラーになると発生します。 |
| screenshotready | このイベントは、screenshotrequest イベントが正常に終了したことを受けて発生します。 AFrameのキャンバスをJPEG圧縮した画像が提供されます。 |
xrwebによって発生するイベント。
| 発生するイベント | 説明 |
|---|---|
| xrimageloading | このイベントは、検出画像の読み込みが始まると発生します。 |
| xrimagescanning | このイベントは、すべての検出画像が読み込まれてスキャンが開始されたときに発生します。 |
| xrimagefound | このイベントは、イメージ・ターゲットが最初に見つかったときに発生します。 |
| xrimageupdated | このイベントは、イメージ・ターゲットの位置、回転、拡大縮小が変化したときに発生します。 |
| xrimagelost | このイベントは、イメージ・ターゲットが追跡されなくなったときに発生します。 |
| xrmeshfound | このイベントは、開始後またはrecenter()の後にメッシュが初めて見つかったときに発生します。 |
| xrmeshupdated | このイベントは、最初に見つかった メッシュの位置や回転が変化したときに発生します。 |
| xrmeshlost | このイベントは、 recenter() が呼び出されたときに発 生します。 |
| xrprojectwayspotscanning | このイベントは、すべてのProject Wayspotがスキャン用にロードされたときに発生します。 |
| xrprojectwayspotfound | このイベントは、Project Wayspotが初めて発見されたときに発生します。 |
| xrprojectwayspotupdated | このイベントは、Project Wayspotの位置や回転が変化したときに発生します。 |
| xrprojectwayspotlost | このイベントは、Project Wayspotが追跡されなくなったときに発生します。 |
| xrtrackingstatus | このイベントは、 XR8.XrController が起動したとき、およびトラッキングの状態や理由が変化したときに発生します。 |
xrfaceによって発生するイベント。
| 発生するイベント | 説明 |
|---|---|
| xrfaceloading | このイベントは、追加のフェイスARリソースの読み込みを開始するときに発生します。 |
| xrfacescanning | このイベントは、ARリソースの読み込みが完了し、スキャンが開始された場合に発生します。 |
| xrfacefound | このイベントは、顔が最初に見つかったときに発生します。 |
| xrfaceupdated | このイベントは、その後に顔が見つかったときに発生します。 |
| xrfacelost | このイベントは、顔の追跡が終了したときに発生します。 |
| xrmouthopened | このイベントは、追跡中の顔の口が開いたときに発生します。 |
| xrmouthclosed | このイベントは、追跡中の顔の口が閉じたときに発生します。 |
| xrlefteyeopened | このイベントは、追跡中の顔の左目が開いたときに発生します。 |
| xrlefteyeclosed | このイベントは、追跡している顔の左目が閉じたときに発生します。 |
| xrrighteyeopened | このイベントは、追跡中の顔の右目が開いたときに発生します。 |
| xrrighteyeclosed | このイベントは、追跡している顔の右目が閉じたときに発生します。 |
| xrlefteyebrowraised | このイベントは、追跡中の顔の左眉が、顔発見時の位置から上がったときに発生します。 |
| xrlefteyebrowlowered | このイベントは、追跡中の顔の左眉が、顔を発見したときの初期位置まで下がったときに発生します。 |
| xrrighteyebrowraised | このイベントは、追跡中の顔の右眉が、顔を発見したときの初期位置から上がったときに発生します。 |
| xrrighteyebrowlowered | このイベントは、追跡中の顔の右眉が、顔を発見したときの初期位置まで下がったときに発生します。 |
| xrlefteyewinked | このイベントは、追跡中の顔の左目が閉じたり開いたりした後、右目が開いたままの状態が750ミリ秒続いた場合に発生します。 |
| xrrighteyewinked | このイベントは、追跡中の顔の右目が閉じたり開いたりした後、左目が開いたまま750ミリ秒続いた場合に発生します。 |
| xrblinked | このイベントは、追跡中の顔の目がまばたきしたときに発生します。 |
| xrinterpupillarydistance | このイベントは、追跡した顔の瞳孔の中心間の距離 (ミリメートル) を初めて検出したときに発生します。 |
xrhandが発するイベント
| 発生するイベント | 説明 |
|---|---|
| xrhandloading | このイベントは、追加のハンドARリソースのロードが開始されたときに発生します。 |
| xrhandscanning | このイベントは、ARリソースの読み込みが完了し、スキャンが開始されたときに発生します。 |
| xrhandfound | このイベントは、ハンド（手）が最初に見つかったときに発生します。 |
| xrhandupdated | このイベントは、その後にハンド（手）が見つかったときに発生します。 |
| xrhandlost | このイベントは、ハンド（手）がトラッキングされなくなったときに発生します。 |