本文へスキップ

AFrameイベント

このセクションでは、A-Frame コンポーネントの xrwebxrfacexrhand が発するイベントについて説明する。

Webアプリケーションでこれらのイベントをリッスンして、イベントを処理する関数を呼び出すことができます。

xrconfig` {#events-emitted}が発するイベント

以下のイベントは xrconfig から発行される(xrweb, xrface, xrhand または xrlayers のみを使用している場合は自動的に追加される):

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

xrweb` {#events-emitted-by-xrweb}が発するイベント

イベント説明
xrimageloadingこのイベントは、検出画像のロードが開始されたときに発行されます。
xrimagescanningこのイベントは、すべての検出画像がロードされ、スキャンが開始されたときに発行される。
xrimagefoundこのイベントは、イメージターゲットが最初に見つかったときに発行される。
xrimageupdatedこのイベントは、イメージターゲットが位置、回転、スケールを変更したときに発行されます。
xrimagelostこのイベントは、イメージターゲットが追跡されなくなったときに発行される。
xrmeshfoundこのイベントは、開始後またはrecenter()の後にメッシュが最初に見つかったときに発行されます。
xrmeshupdatedこのイベントは、最初に見つかった**メッシュの位置や回転が変化したときに発行されます。
xrmeshlostこのイベントは recenter() が呼ばれたときに発生する。
xrprojectwayspotscanningこのイベントは、すべてのプロジェクトウェイスポットがスキャン用にロードされたときに発行されます。
xrprojectwayspotfoundこのイベントは、プロジェクト・ウェイスポットが最初に見つかったときに発行されます。
xrprojectwayspotupdatedこのイベントは、プロジェクトウェイスポットの位置や回転が変化したときに発行されます。
xrprojectwayspotlostこのイベントは、プロジェクトウェイスポットが追跡されなくなったときに発行されます。
xrtrackingstatusこのイベントはXR8.XrControllerが起動し、トラッキングのステータスや理由が変更された時に発行されます。

xrface` {#events-emitted-by-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このイベントは、ハンドがトラッキングされなくなったときに発行される。