@kmax/stereo-core

Kmax 立体显示 SDK 的框架无关核心包，提供投影矩阵 provider 和 WebSocket 追踪客户端。

安装

npm install @kmax/stereo-core

投影矩阵

import { createKmaxProjectionProvider } from '@kmax/stereo-core';

const provider = await createKmaxProjectionProvider();
const matrix = provider.getProjectionMatrix({ x: 0, y: 0, z: 0.6 });

createKmaxProjectionProvider() 默认会加载包内 dist/assets/ 下的投影模块资源。业务代码通常不需要关心 kmax-stereo-bind.js 和 .wasm。

如果项目有特殊部署要求，可以传入高级资源配置：

await createKmaxProjectionProvider({
  assetBaseUrl: '/vendor/kmax-stereo/',
});

追踪客户端

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

const track = new WSTrackClient({
  onStatusChange(status) {
    if (status === 'connected') {
      console.log('已连接 Kmax 追踪服务');
    }

    if (status === 'unavailable') {
      console.log('未检测到 Kmax 追踪服务，应用可以降级为普通显示');
    }
  },
});
track.onData = (data) => {
  console.log(data);
};

WSTrackClient 默认自动连接 Kmax 追踪服务。特殊部署场景可以通过构造参数覆盖连接配置。

维护说明

当前 .wasm 依赖 Emscripten/Embind 生成的 glue 文件，kmax-stereo-bind.js 只是 SDK 内部兼容层，不是公共 API。未来如果拿到原始投影源码，建议重编译为扁平 ABI wasm 或纯 JavaScript 实现，再移除这层 glue。