メインコンテンツまでスキップ

PlayCanvasでのWebXRの使用方法

Support​

WebXRのブラウザサポートはまだ全面的には実現されていません。以下のようにして確認できます。

if (app.xr.supported) {
    //WebXRはサポートされています
}

Starting an XR Session​

To start XR session, you can use method on the Camera Component or XrManager on the Application. To start an XR session, you need to provide CameraComponent and provide the type of XR session, reference space, and optional object with additional arguments:

app.xr.start(entity.camera, pc.XRTYPE_VR, pc.XRSPACE_LOCALFLOOR);

It is an asynchronous operation and is only possible to start on a user interaction, such as a button click, mouse click, or touch:

button.on('click', () => {
    // start XR session
});

To know when a session is started, you can subscribe to the start event:

app.xr.on('start', () => {
    // XR session has started
});

セッションタイプや参照スペースが特定のプラットフォームで利用できない場合、セッションを開始できず、コールバックでエラーが提供され、XrManagerでerror イベントが発生します。

entity.camera.startXr(pc.XRTYPE_VR, pc.XRSPACE_UNBOUNDED, {
    callback: (err) => {
        if (err) {
            // failed to start session
        }
    }
});

Ending an XR Session​

XRの終了はさまざまな方法でトリガーできます。コードからXRを終了することができます。

app.xr.end();

Also, the user might exit XR via some external process like the back button in the browser. XrManager will fire events associated with the session end:

app.xr.on('end', () => {
    // XR session has ended
});

Session Types​

それぞれのプラットフォームで、異なる種類のセッションがサポートされています。これらは以下の通りです。

  • VR(仮想現実)-一定レベルのビューアートラッキングを提供し、XRデバイスに独占アクセスを提供します。これは、アプリケーションがデバイスのフレームバッファにレンダリングされ、HTMLキャンバス要素にはレンダリングされないことを意味します。
  • AR (Augmented Reality) - This type of session provides exclusive access to the XR Device and content is meant to be blended with the real-world environment. In this mode, the camera's clear color should be transparent.

The availability of a session type can change during an application's lifetime, based on devices being plugged in or features on devices being enabled. To check if a session type is available do:

if (app.xr.isAvailable(pc.XRTYPE_VR)) {
    // VRは利用可能です
}

You can subscribe to availability change events too:

app.xr.on('available', (type, available) => {
    console.log('XR session', type, 'type is now', available ? 'available' : 'unavailable');
});

// or specific session type
app.xr.on('available:' + pc.XRTYPE_VR, (available) => {
    console.log('XR session VR type is now', available ? 'available' : 'unavailable');
});

Camera Position and Orientation​

When you are presenting in XR, the position and orientation of the camera are overwritten by data from the XR session. If you want to implement additional movement and rotation of the camera, you should add a parent entity to your camera and apply your manipulations to that entity.

Camera Offset

Position, orientation and rays of different XR objects: input sources, tracked meshes, tracked planes, tracked images, and others, are provided in world space.

なぜ自動的にXRモードを有効にできないのですか?​

Entering WebXR is required by browsers to be triggered by a user action. That means that it must be in response to a key press, a mouse click or a touch event. For that reason, there is no way to enter XR immediately on loading a page.