@kmax/babylon-stereo

面向 Babylon.js 的 Kmax 立体显示 adapter。共享的投影和追踪能力来自 @kmax/stereo-core。

安装

npm install @kmax/babylon-stereo @kmax/stereo-core @babylonjs/core

基本用法

import {
  KBabylonStereoEffect,
  createBabylonKmaxFrustumProvider,
} from '@kmax/babylon-stereo';

const effect = new KBabylonStereoEffect(engine);
const provider = await createBabylonKmaxFrustumProvider();

effect.setFrustumProvider(provider);
effect.render(scene, camera);

窗口模式建议继续使用 Babylon.js 默认投影；进入全屏立体显示时，再由 KBabylonStereoEffect 对左右眼相机应用 Kmax projection。

追踪客户端

import { WSTrackClient } from '@kmax/babylon-stereo';

const track = new WSTrackClient({
  onStatusChange(status) {
    if (status === 'connected') {
      // 当前设备可用 Kmax 追踪服务，可启用立体显示模式。
    }

    if (status === 'unavailable') {
      // 未检测到追踪服务，应用应保持普通渲染。
    }
  },
});

WSTrackClient 从 @kmax/stereo-core 转导，默认自动连接 Kmax 追踪服务。