interface DigitalPerformanceNameplateOptions {
    className?: string;
    containerClassName?: string;
    containerStyle?: Record<string, string>;
    createElement?: ((context: DigitalPerformanceNameplateRenderContext) => HTMLElement);
    debugBoundingBox?: boolean;
    getText?: ((player: DigitalModelPlayer) => string);
    maxLength?: number;
    offset?: [number, number, number];
    style?: Record<string, string>;
    updateElement?: ((element: HTMLElement, context: DigitalPerformanceNameplateRenderContext) => void);
}

Properties

className?: string

名牌元素 class。

containerClassName?: string

overlay 容器 class。

containerStyle?: Record<string, string>

overlay 容器的额外内联样式。

createElement?: ((context: DigitalPerformanceNameplateRenderContext) => HTMLElement)

自定义名牌元素;不传时创建默认气泡 div。

debugBoundingBox?: boolean

调试:是否显示每个绑定模型的世界包围盒(THREE.BoxHelper),用于核对名牌锚点。 默认 false,不影响名牌本身。

getText?: ((player: DigitalModelPlayer) => string)

自定义名牌文本,默认使用 displayName ?? name。

maxLength?: number

名牌最多展示的 Unicode 字符数,默认 30。

offset?: [number, number, number]

相对模型包围盒顶部的世界坐标偏移,默认 [0, 0.12, 0]。

style?: Record<string, string>

名牌元素的额外内联样式。

updateElement?: ((element: HTMLElement, context: DigitalPerformanceNameplateRenderContext) => void)

自定义名牌更新逻辑;不传时将 textContent 更新为当前文本。