@kmax/three-stereo

面向 Three.js 的 Kmax 立体显示 SDK，提供左右并排立体渲染、Kmax 投影矩阵写入、WebSocket 追踪转导，以及触控笔射线交互。

安装

npm install @kmax/three-stereo three

three 是对等依赖，需要由接入方应用安装。框架无关的投影和追踪能力来自 @kmax/stereo-core，会随本包自动安装。

基本用法

import {
  KStereoEffect,
  WSTrackClient,
  createKmaxFrustumProvider,
} from '@kmax/three-stereo';

const frustumProvider = await createKmaxFrustumProvider();

const effect = new KStereoEffect(renderer, { frustumProvider });
effect.setSize(window.innerWidth, window.innerHeight);

const track = new WSTrackClient();
track.onData = (data) => {
  camera.position.set(data.eye.pos.x, data.eye.pos.y, -data.eye.pos.z);
};

需要立体输出时调用 effect.render(scene, camera)；普通单眼渲染仍使用 renderer.render(scene, camera)。

追踪客户端

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

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

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

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