本文へスキップ

セルフホスティング プロジェクト

既存のセルフホスト・プロジェクトは、2027年2月28日まで変更なく機能する。 このガイドでは、8th Wallがホストするエンジンから8th Wallエンジン・バイナリへの移行プロセスについて説明します。

インフォメーション

8th Wallエンジンのバイナリは、クラウドに依存する機能や、以下のような私たちが配布するライセンスを持たない機能には**対応していません:

  • VPS / 地図
  • ハンドトラッキング
  • モジュール / バックエンド

セルフホストプロジェクトを更新して、8th Wallエンジンのバイナリを使用する:

  1. xr-standalone.zip](https://8th.io/xrjs)をダウンロードし、プロジェクトフォルダに解凍する。
  2. apps.8thwall.com/xrweb の script タグを削除し、` に置き換える。
  3. スクリプトタグに data-preload-chunks を追加するか、エンジンを起動する前にコード内で await XR8.loadChunk() を呼び出してください。 詳細は以下のセクションを参照のこと。
備考

data-preload-chunks="face,slam"`は、ワールドエフェクトとフェイスエフェクトの両方を使用するエクスペリエンスでもサポートされています。

ワールド・エフェクト

ワールドトラッキングを使用している場合は、スクリプトタグに data-preload-chunks="slam" を追加するか、エンジンを起動する前にコード内で await XR8.loadChunk('slam') を呼び出してください。

フェイス・エフェクト

顔トラッキングを使用している場合は、スクリプトタグにdata-preload-chunks="face"を追加するか、エンジンを起動する前にコード内でawait XR8.loadChunk('face')を呼び出してください。

イメージターゲット

イメージターゲットを使用している場合は、スクリプトタグに data-preload-chunks="slam" を追加するか、エンジンを起動する前にコード内で await XR8.loadChunk('slam') を呼び出してください。

イメージターゲットをダウンロード

イメージターゲットを8th Wallコンソールからダウンロードする:

あなたのイメージターゲットを含む.zipファイルを受け取ります。 このフォルダをセルフホスト・プロジェクトに移動する。

イメージターゲットの設定

経験開始時にイメージターゲットを設定する。

イメージターゲットを有効にするには、他のコードの前にXR8.XrController.configureを呼び出します:

const onxrloaded = () => {
XR8.XrController.configure({
imageTargetData: [
require('../image-targets/target1.json'),
require('../image-targets/target2.json'),
],
})
}
window.XR8 ? onxrloaded() : window.addEventListener('xrloaded', onxrloaded)
インフォメーション

オートロードされたターゲットは、jsonファイルに"loadAutomatically": trueプロパティを持つ。