Class DigitalPerformanceNameplate

DigitalPerformance 的 2D 名牌层。

它只负责「模型世界坐标 → 播放器 overlay DOM」和名牌生命周期，由 Legacy/V2 controller 在各自的模型帧更新完成后调用 update()，因此两个播放器共用同一套 DOM 规则。

Index

Constructors

Methods

dispose enableAutoMount isEnabled mount setBindings setBoundingBoxVisible setEnabled unmount update updateName

Constructors

constructor

new DigitalPerformanceNameplate(five, options?): DigitalPerformanceNameplate
Parameters
- five: Five
- options: DigitalPerformanceNameplateOptions = {}
Returns DigitalPerformanceNameplate
- Defined in plugins/src/DigitalPerformancePlugin/core/DigitalPerformanceNameplate.ts:110

Methods

dispose

dispose(): void
Returns void
- Defined in plugins/src/DigitalPerformancePlugin/core/DigitalPerformanceNameplate.ts:258

enableAutoMount

enableAutoMount(options?): void
内置自动挂载：把 overlay 挂到 five canvas 的父容器（与 canvas 同级），调用方无需提供容器。 canvas 尚未进入 DOM 时不报错，会在后续 update() 中自动重试挂载。
Parameters
- Optionaloptions: DigitalPerformanceNameplateOptions
Returns void
- Defined in plugins/src/DigitalPerformancePlugin/core/DigitalPerformanceNameplate.ts:143

isEnabled

isEnabled(): boolean
Returns boolean
- Defined in plugins/src/DigitalPerformancePlugin/core/DigitalPerformanceNameplate.ts:218

mount

mount(parent, options?): void
将 overlay 挂到 Five canvas 的父级或业务提供的全屏相对定位容器。
Parameters
- parent: HTMLElement
- Optionaloptions: DigitalPerformanceNameplateOptions
Returns void
- Defined in plugins/src/DigitalPerformancePlugin/core/DigitalPerformanceNameplate.ts:117

setBindings

setBindings(bindings): void
更新当前章节的角色绑定；id 是角色唯一键，同一模型复用时也不会互相覆盖。
Parameters
- bindings: DigitalPerformanceNameplateBinding[]
Returns void
- Defined in plugins/src/DigitalPerformancePlugin/core/DigitalPerformanceNameplate.ts:162

setBoundingBoxVisible

setBoundingBoxVisible(visible): void
调试：显示/隐藏每个绑定模型的世界包围盒（THREE.BoxHelper）。包围盒与名牌锚点使用的是同一个 Box3（setFromObject(model)），用于核对名牌定位。默认关闭；不影响名牌本身。
Parameters
- visible: boolean
Returns void
- Defined in plugins/src/DigitalPerformancePlugin/core/DigitalPerformanceNameplate.ts:204

setEnabled

setEnabled(enabled): void
Parameters
- enabled: boolean
Returns void
- Defined in plugins/src/DigitalPerformancePlugin/core/DigitalPerformanceNameplate.ts:193

unmount

unmount(): void
移除 overlay，但保留 bindings；重新挂载（含换容器）时会复用 bindings。

Returns void
- Defined in plugins/src/DigitalPerformancePlugin/core/DigitalPerformanceNameplate.ts:151

update

update(): void
在数字人模型变换完成后调用，更新所有当前章节名牌的位置和可见性。

Returns void
- Defined in plugins/src/DigitalPerformancePlugin/core/DigitalPerformanceNameplate.ts:223

updateName

updateName(id, value): void
实时更新指定角色名称，不需要重新加载模型或动画资源。
Parameters
- id: string
- value: string
Returns void
- Defined in plugins/src/DigitalPerformancePlugin/core/DigitalPerformanceNameplate.ts:187