@realsee/dnalogel 3.81.13 → 4.0.0-webgpu.4

package/dist/types/CruisePlugin/typing.d.ts

@@ -0,0 +1,159 @@
+import { MovePanoOptions, Pose, State } from '@realsee/five-webgpu';
+import { default as CruisePlugin } from '.';
+import { PluginData as GuideLinePluginData } from '../GuideLinePlugin/typing.js';
+import type * as BasePluginWithData from '../base/BasePluginWithData.js';
+import type * as BasePlugin from '../base/BasePlugin.js';
+type FivePoseAndState = Partial<Pose> & Partial<State>;
+export type MoveEffect = MovePanoOptions['effect'];
+export type CruiseData = {
+    /** 移动/旋转 */
+    effect: 'Move' | 'Rotate';
+    /** five走点动画 */
+    moveEffect?: MoveEffect;
+    /**
+     * @description 移动速度 m/ms
+     */
+    moveSpeed?: number;
+    /**
+     * @description 旋转速度 rad/ms
+     */
+    rotateSpeed?: number;
+    /**
+     * @description move effect独有，音频播放相关参数
+     */
+    audio?: {
+        url: string;
+        duration: number;
+    };
+} & FivePoseAndState;
+export interface CruiseKeyframe {
+    id: string;
+    index: number;
+    moveIndex: number;
+    stay?: number;
+    start?: number;
+    end?: number;
+    data: CruiseData;
+}
+export interface GuideLineConfig {
+    /**
+     * @description: 是否使用引导路线
+     * @default: false
+     */
+    useGuildLine?: boolean;
+    /** 传递给 GuildPlugin 的参数 */
+    guildPluginOptions?: GuideLinePluginData['config'];
+}
+export interface PluginData extends GuideLineConfig {
+    keyframesId: string;
+    keyframes: CruiseKeyframe[];
+}
+export interface MoveAction extends GuideLineConfig {
+    /** five走点动画 */
+    moveEffect?: MoveEffect;
+    /** 到第一个点的走点动画 / 续播到暂停处的走点动画 */
+    moveToFirstPanoEffect?: MoveEffect;
+    /** 到第一个点的走点时长 / 续播到暂停处的走点时长 */
+    moveToFirstPanoDuration?: number;
+    /** 漫游方式：justMove 为移动到指定点位，且朝向为下一个点的朝向；moveAndRotate 为先移动到指定点位且朝向不变，然后旋转到下一个点的朝向 */
+    moveType?: 'justMove' | 'moveAndRotate';
+    /** 停留时长 */
+    stay?: number;
+}
+export interface MoveWithPanoIndexAction extends MoveAction {
+    /** 点位列表 */
+    panoIndexList: number[];
+    /** for ts check, no care */
+    keyframes?: undefined;
+}
+export interface MoveWithKeyframesAction extends MoveAction {
+    keyframes: {
+        uuid?: string;
+        id?: string;
+        start?: number;
+        end?: number;
+        data: CruiseData;
+    }[];
+    /** for ts check, no care */
+    panoIndexList?: undefined;
+}
+export interface PluginServerData {
+    data: MoveWithKeyframesAction | MoveWithPanoIndexAction;
+}
+export interface PluginState extends BasePluginWithData.State {
+    /** 是否可见 */
+    visible: boolean;
+    /** 是否正在播放 */
+    playing: boolean;
+    /** 是否销毁 */
+    disposed: boolean;
+    /** 播放速度 */
+    speed: number;
+    config?: {
+        /** 速度配置 */
+        speedConfig?: Partial<{
+            /** 旋转速度 */
+            rotateSpeed: number;
+            /** 旋转速度单位 */
+            rotateSpeedUnit: 'rad/s' | 'rad/ms';
+            /** 移动速度 */
+            moveSpeed: number;
+            /** 移动速度单位 */
+            moveSpeedUnit: 'm/s' | 'm/ms';
+        }>;
+        /** five 走点动画 */
+        moveEffect?: MoveEffect;
+    };
+}
+export interface EventMap extends BasePluginWithData.EventMap<PluginState, PluginData> {
+    /** 展示 */
+    show: (options: {
+        userAction: boolean;
+    }) => void;
+    /** 隐藏 */
+    hide: (options: {
+        userAction: boolean;
+    }) => void;
+    /** 开启 */
+    enable: (options: {
+        userAction: boolean;
+    }) => void;
+    /** 关闭 */
+    disable: (options: {
+        userAction: boolean;
+    }) => void;
+    /** 播放状态改变，playingState: playing 表示播放；pause 表示暂停 */
+    playStateChange: (playingState: 'playing' | 'pause', options: {
+        userAction: boolean;
+    }) => void;
+    /** 开始播放，相当于 playStateChange: ('playing') => void */
+    play: (options: {
+        userAction: boolean;
+    }) => void;
+    /** 暂停播放，相当于 playStateChange: ('pause') => void */
+    pause: (options: {
+        userAction: boolean;
+    }) => void;
+    /** 播放的帧改变，index表示开始播放第{index}个帧 */
+    playIndexChange: (index: number, keyframe: CruiseKeyframe) => void;
+    /** 播放被手势操作打断，同时会触发 ”pause“ 事件 */
+    broke: () => void;
+    /** 当前播放失败；主动取消和过期播放不触发，状态已停止且不会触发 end */
+    error: (error: Error) => void;
+    /** 播放结束 */
+    end: () => void;
+    /** 播放速度改变，speed表示播放速度 */
+    speedChange: (speed: number, options: {
+        userAction: boolean;
+    }) => void;
+    /** MovePlugin 自定义路线漫游时，progress 更新时触发，范围 0~1 */
+    progressChange: (progress: number) => void;
+}
+export interface Config extends BasePlugin.Config {
+    /**
+     * @description: 漫游时是否加载路线
+     */
+    useGuideLine?: boolean;
+}
+export type CruisePluginExportType = ReturnType<typeof CruisePlugin>;
+export {};

package/dist/types/CruisePlugin/utils/coordinatesToVector.d.ts

@@ -0,0 +1,7 @@
+import * as THREE from 'three/webgpu';
+/** 坐标转换成单位向量 */
+declare function coordinatesToVector(coordinates: {
+    longitude: number;
+    latitude: number;
+}): THREE.Vector3;
+export { coordinatesToVector };

package/dist/types/CruisePlugin/utils/getFiveStateOnCurve.d.ts

@@ -0,0 +1,11 @@
+import * as THREE from 'three/webgpu';
+export declare function getFiveStateOnCurve(curve: THREE.Curve<THREE.Vector3>, progress: number, curveOffset: Partial<{
+    x: number;
+    y: number;
+    z: number;
+}>): {
+    offset: THREE.Vector3;
+    longitude: number;
+    latitude: number;
+    distance: number;
+};

package/dist/types/CurrentPanoImagePlugin/Controller.d.ts

@@ -0,0 +1,104 @@
+import { Five } from '@realsee/five-webgpu';
+import * as BasePlugin from '../base/BasePlugin.js';
+import type * as PluginType from './typings.js';
+export declare class CurrentPanoImagePluginController extends BasePlugin.Controller<PluginType.State, PluginType.EventMap> {
+    /** 插件当前状态 */
+    state: PluginType.State;
+    /** 插件配置项 */
+    get config(): {
+        width: number;
+        yOffset: number;
+        yRotate: number;
+        imageURL: string;
+        mediaManager?: import('../shared-utils/playback.js').PlaybackManager;
+        staticPrefix?: string;
+        i18n?: (key: string) => string;
+    };
+    /** 是否已经被销毁 */
+    get disposed(): boolean;
+    /** 查询问题使用的调试对象 */
+    checkMsg: {
+        /** mesh 隐藏的原因 */
+        meshHidden: string;
+        /** 插件 enabled 校验信息 */
+        pluginDisabled: string;
+        /** 插件 visible 校验信息 */
+        pluginHidden: string;
+    };
+    private group;
+    private mesh;
+    private textureLoadingPromise?;
+    private opacityAnimeTween?;
+    /** 是否正在走点动画中 */
+    private isInPanoMoveAnime;
+    /** 上一次走点的全景图索引 */
+    private lastArrivedPanoIndex;
+    /** config 的原始值 */
+    private _config;
+    /** disposed 的原始值 */
+    private _disposed;
+    constructor(five: Five, params?: PluginType.Params);
+    /**
+     * 启用插件，响应用户操作并展示UI
+     * @param options
+     */
+    enable(options?: BasePlugin.BaseOptions): void;
+    /** 禁用插件
+     * @param `options` `<Option> | <undefined>`
+     * @param `options.userAction` `<boolean> | <undefined>` 是否是用户操作。默认是 true。
+     */
+    disable(options?: BasePlugin.BaseOptions): void;
+    /** 插件内容整体展示
+     * @param `options` `<Partial<BaseOptions>> | <undefined>`
+     * @param `options.userAction` `<boolean> | <undefined>` 是否是用户操作。默认是 true。
+     */
+    show(options?: Partial<PluginType.ShowHideOptions>): Promise<void>;
+    /** 插件内容整体隐藏
+     * @param `options` `<Partial<BaseOptions>> | <undefined>`
+     * @param `options.userAction` `<boolean> | <undefined>` 是否是用户操作。默认是 true。
+     */
+    hide(options?: Partial<PluginType.ShowHideOptions>): Promise<void>;
+    /** 更改插件 State
+     * @param `state` `<Partial<Plugin.State>>` 插件属性 `state` 的子集。
+     * @param `options` `<Option> | <undefined>`
+     * @param `options.userAction` `<boolean> | <undefined>` 是否是用户操作。默认是 true。
+     */
+    setState(state: Partial<PluginType.State>, options?: BasePlugin.BaseOptions): void;
+    /** 更改插件 Config
+     * @param `config` `<Partial<Plugin.Config>>` 插件属性 `config` 的子集。
+     * @param `options` `<Option> | <undefined>`
+     */
+    updateConfig(config: Partial<PluginType.Config>, options?: BasePlugin.BaseOptions): void;
+    /**
+     * 销毁插件
+     * @todo 销毁贴图时，最好还是直接销毁贴图吧，this.mesh?.material.map 这种都是很深层的引用了。THREE 的建议我看也是自己去管理和销毁公共贴图。
+     */
+    dispose: () => void;
+    /** 问什么看不到模型 */
+    __whyCantSeeMesh(): string;
+    private updateState;
+    /** 根据各种条件更新 Mesh 的可见性 */
+    private updateMeshVisible;
+    private isCurrentOwnerWork;
+    /** 根据点位更新 Mesh 坐标 */
+    private updateMeshPosition;
+    /** 重新加载贴图，调用时会先清除已有的贴图 */
+    private reloadTexture;
+    /** north_rad 变化时，需要更新模型的旋转角度 */
+    private updateMeshQuaternion;
+    private checkMeshVisible;
+    private _enable;
+    private _disable;
+    private _show;
+    private _hide;
+    /** 贴图加载完成的回调 */
+    private onTextureLoaded;
+    /** Five load Work 后 */
+    private onFiveWillLoad;
+    /** 走点前 */
+    private onFivePanoWillArrive;
+    /** 走点后 */
+    private onFivePanoArrived;
+    private onMeshVisibleChange;
+    private onFiveModeChange;
+}

package/dist/types/CurrentPanoImagePlugin/index.d.ts

@@ -0,0 +1,7 @@
+import { FivePlugin } from '@realsee/five-webgpu';
+import { CurrentPanoImagePluginController } from './Controller.js';
+import type * as CurrentPanoImagePluginType from './typings.js';
+export declare const CurrentPanoImagePlugin: FivePlugin<CurrentPanoImagePluginType.Params, CurrentPanoImagePluginController>;
+export default CurrentPanoImagePlugin;
+export type CurrentPanoImagePluginExportType = CurrentPanoImagePluginController;
+export type { CurrentPanoImagePluginType };

package/dist/types/CurrentPanoImagePlugin/typings.d.ts

@@ -0,0 +1,58 @@
+import type * as BasePlugin from '../base/BasePlugin.js';
+export interface Config extends BasePlugin.Config {
+    /** 贴图宽度，单位：米 */
+    width: number;
+    /** 高度偏移量，单位：米 */
+    yOffset: number;
+    /** 沿着 Y 轴正方向旋转角度，单位：弧度 */
+    yRotate: number;
+    /** 贴图 URL */
+    imageURL: string;
+}
+export interface State extends BasePlugin.State {
+    visible: boolean;
+}
+export interface ShowHideOptions extends BasePlugin.BaseOptions {
+    userAction: boolean;
+}
+export interface EventMap extends BasePlugin.EventMap<State> {
+    /** visible 从 false 到 true 的回调
+     * @param event.userAction 是否是用户操作
+     */
+    show: (event: {
+        userAction: boolean;
+    }) => void;
+    /** visible 从 true 到 false 的回调
+     * @param event.userAction 是否是用户操作
+     */
+    hide: (event: {
+        userAction: boolean;
+    }) => void;
+    /** enabled 从 false 到 true 的回调
+     * @param event.userAction 是否是用户操作
+     */
+    enable: (event: {
+        userAction: boolean;
+    }) => void;
+    /** enabled 从 true 到 false 的回调
+     * @param event.userAction 是否是用户操作
+     */
+    disable: (event: {
+        userAction: boolean;
+    }) => void;
+    /** config 变更的回调
+     * @param event.prevConfig 变更前的 config
+     * @param event.config 变更后的 config
+     * @param event.userAction 是否是用户操作
+     */
+    configChange: (event: {
+        prevConfig: Config;
+        config: Config;
+        userAction: boolean;
+    }) => void;
+}
+/** 插件初始化参数 */
+export interface Params {
+    config?: Partial<Config>;
+    initialState?: Partial<State>;
+}

package/dist/types/DigitalPerformancePlugin/controller/index.d.ts

@@ -0,0 +1,227 @@
+import { Five } from '@realsee/five-webgpu';
+import { DigitalPlayground } from '../core/DigitalPlayground.js';
+import { DigitalHuman } from '../core/DigitalHuman.js';
+import { DigitalScript, DigitalChapter, DigitalPerformancePluginConfig, GlobalProgress, ChapterTimeInfo, ChapterLocation, ProgressListener } from '../typings/index.js';
+import { AnimationScriptAdapterOptions } from '../animation-script-adapter.js';
+export default class DigitalPerformancePluginController {
+    five: Five;
+    playground: DigitalPlayground;
+    config: DigitalPerformancePluginConfig;
+    state: {
+        enabled: boolean;
+        playing: boolean;
+        currentChapter: DigitalChapter | null;
+        currentScript: DigitalScript | null;
+        continuousPlaying: boolean;
+        playMode: 'single' | 'continuous';
+    };
+    NAME: string;
+    private totalDurationCache;
+    private chapterTimeMapCache;
+    private progressListeners;
+    private progressUpdateInterval;
+    private progressUpdateTimer;
+    private _autoPlayOnNaturalEnd;
+    private playingPlayersListeners;
+    private nameplate;
+    private readonly onNameplateRender;
+    constructor(five: Five, config?: DigitalPerformancePluginConfig);
+    /**
+     * 加载剧本数据
+     */
+    private loadRevision;
+    private disposed;
+    loadScript(script: DigitalScript): Promise<void>;
+    private init;
+    /**
+     * 预加载资源
+     */
+    private preloadResources;
+    /**
+     * 播放指定章节
+     */
+    playChapter(chapter: DigitalChapter): Promise<void>;
+    /**
+     * 播放指定章节（内部方法，用于连续播放）
+     */
+    private playChapterForContinuous;
+    /**
+     * 播放指定章节（通过索引）
+     */
+    playChapterByIndex(index: number): Promise<void>;
+    /**
+     * 暂停播放
+     */
+    pause(): void;
+    /**
+     * 继续播放
+     */
+    continue(): Promise<void>;
+    /**
+     * 连续播放模式下的继续播放（从暂停位置继续播放所有剩余章节）
+     */
+    private continueAllRemaining;
+    /**
+     * 从当前章节播放到最后一个章节（连续自动播放）
+     */
+    playAllRemaining(): Promise<void>;
+    /**
+     * 重置播放
+     */
+    reset(): void;
+    /**
+     * 设置时间线
+     */
+    setTimelineTo(time: number): void;
+    /**
+     * 启用插件
+     */
+    enable(): void;
+    /**
+     * 禁用插件
+     */
+    disable(): void;
+    /**
+     * 重置并清理（完全重置插件状态，包括对 five 的操作和 DigitalHuman）
+     */
+    private resetAndCleanup;
+    /**
+     * 销毁插件（彻底释放资源）
+     */
+    dispose(): void;
+    /**
+     * 获取当前状态
+     */
+    getState(): {
+        enabled: boolean;
+        playing: boolean;
+        currentChapter: DigitalChapter | null;
+        currentScript: DigitalScript | null;
+        continuousPlaying: boolean;
+        playMode: "single" | "continuous";
+    };
+    /**
+     * 获取可用章节列表
+     */
+    getChapters(): DigitalChapter[];
+    /**
+     * 获取数字人实例
+     */
+    getDigitalHuman(modelUrl: string, id?: string): DigitalHuman | null;
+    /** 实时修改角色名牌；不重新加载模型和动画资源。 */
+    updateModelName(id: string, value: string): void;
+    private syncNameplates;
+    /**
+     * 获取当前播放进度信息
+     */
+    getProgress(): {
+        currentTime: number;
+        totalTime: number;
+    } | null;
+    /**
+     * 对原始 res 数据进行 transformPosition 处理和章节分组，返回完整结构。
+     * 该方法保留用于兼容旧调用方，实际转换由共享纯函数执行。
+     */
+    transformScriptData(res: any, work?: any, totalDelay?: number): any;
+    /**
+     * 加载 raw animation detail。转换逻辑由 dnalogel 统一执行，随后复用 canonical loadScript。
+     */
+    loadAnimationDetail(detail: unknown, options?: AnimationScriptAdapterOptions): Promise<any>;
+    /**
+     * 清理进度缓存
+     */
+    private clearProgressCache;
+    /**
+     * 计算单个章节的时长
+     */
+    private calculateChapterDuration;
+    /**
+     * 获取所有章节的总时长（毫秒）
+     */
+    getTotalDuration(): number;
+    /**
+     * 获取章节时间映射信息
+     */
+    getChapterTimeMap(): ChapterTimeInfo[];
+    /**
+     * 获取全局进度信息
+     */
+    getGlobalProgress(): GlobalProgress;
+    /**
+     * 根据全局时间获取对应的章节信息
+     */
+    getChapterByGlobalTime(globalTime: number): ChapterLocation | null;
+    /**
+     * 跳转到指定的全局时间
+     */
+    seekToGlobalTime(globalTime: number, autoPlay?: boolean): Promise<void>;
+    /**
+     * 初始化章节用于跳转（不自动播放）
+     */
+    private initializeChapterForSeek;
+    /**
+     * 跳转到指定百分比位置
+     */
+    seekToPercentage(percentage: number, autoPlay?: boolean): Promise<void>;
+    /**
+     * 跳转到指定章节的指定时间
+     */
+    seekToChapter(chapterIndex: number, chapterTime?: number, autoPlay?: boolean): Promise<void>;
+    /**
+     * 从指定全局时间开始播放所有剩余内容
+     */
+    playFromGlobalTime(globalTime: number): Promise<void>;
+    /**
+     * 注册进度变化监听器
+     */
+    onProgressChanged(callback: ProgressListener): () => void;
+    /**
+     * 移除进度监听器
+     */
+    offProgressChanged(callback: ProgressListener): void;
+    /**
+     * 设置进度回调频率（毫秒）
+     */
+    setProgressUpdateInterval(interval: number): void;
+    /**
+     * 启动进度更新定时器
+     */
+    private startProgressUpdateTimer;
+    /**
+     * 停止进度更新定时器
+     */
+    private stopProgressUpdateTimer;
+    /**
+     * 播放完整的所有章节（从头开始）
+     */
+    playAllChapters(): Promise<void>;
+    /**
+     * 获取播放范围信息
+     */
+    getPlaybackRange(): {
+        startTime: number;
+        endTime: number;
+        estimatedDuration: number;
+    };
+    /**
+     * 停止所有 player 的播放状态
+     */
+    private stopAllPlayers;
+    private emit;
+    /**
+     * 注册监听当前正在播放的所有player变化
+     */
+    onPlayingPlayersChanged(callback: (players: any[]) => void): () => void;
+    /**
+     * 获取当前正在播放的所有player（数组）
+     */
+    private getCurrentPlayingPlayers;
+    /**
+     * 从指定章节获取正在播放的players
+     */
+    private getPlayingPlayersFromChapter;
+    /**
+     * 触发 playing-players-changed 事件
+     */
+    private emitPlayingPlayersChanged;
+}

package/dist/types/DigitalPerformancePlugin/core/DigitalHuman.d.ts

@@ -0,0 +1,98 @@
+import { GLTFObject } from '@realsee/five-webgpu/gltf-loader';
+import { DigitalStateMachine, DigitalModelKeyframe, DigitalModelPlayerItem, DigitalModelPlayerEffect } from './DigitalStateMachine.js';
+import * as THREE from 'three/webgpu';
+export declare class DigitalHuman {
+    model: GLTFObject;
+    keyframesManager: DigitalStateMachine;
+    keyframes: DigitalModelKeyframe[];
+    items: DigitalModelPlayerItem[];
+    effects: DigitalModelPlayerEffect[];
+    digitalPlayground: any;
+    state: {
+        currentTime: number;
+        currentAnimation: THREE.AnimationClip | null;
+        currentAnimationRepeat: boolean;
+        playing: boolean;
+    };
+    animationFrameId: number | null;
+    curveLine: THREE.Line;
+    effectsGroup: THREE.Group;
+    effectObjects: Map<string, THREE.Mesh>;
+    container: THREE.Group;
+    /**
+     * 运动轨迹线（curveLine）开关。默认关闭、不绘制、不显示。
+     * 仅 debug / 特殊需求时由业务经插件显式开启（见 setTraceVisible）。
+     */
+    showTrace: boolean;
+    private disposed;
+    private fadeTimers;
+    private mixer;
+    private action;
+    private itemMatrixMap;
+    private trace;
+    private processedNeedRenderKeyframeIndices;
+    private attachedItems;
+    private rightHandBone;
+    private externalTextures;
+    constructor(model: GLTFObject, digitalPlayground: any);
+    playAnimation({ animation, repeat, switchDuration }: {
+        animation: THREE.AnimationClip;
+        repeat: boolean;
+        switchDuration: number;
+    }): void;
+    /**
+     * seek/预览专用：立即「硬切」到目标动画（无 crossfade）。
+     *
+     * 背景：`playAnimation` 走 `crossFadeFrom(oldAction, switchDuration, true)` 做平滑过渡，依赖后续帧以
+     * 正的 delta 推进权重淡入淡出。但 seek/定格帧（delta===0）只做一次 `mixer.update(0)`，零时长的
+     * crossfade 不会推进——新动作权重可能仍≈0、旧动作权重仍≈1，且旧动作的 `stop()` 被 `setTimeout(…,0)`
+     * 推迟到本帧渲染之后执行。结果：跨动画 seek（如章节末「躺」姿回到起始帧「跑」）时旧姿态残留，
+     * 而位置/旋转因是直接拷贝关键帧的、已正确。
+     *
+     * 这里同步停旧动作、把新动作权重直接置 1，保证随后的 `mixer.update(0)` 立即定格到目标姿态。
+     */
+    private switchAnimationImmediately;
+    pauseAnimation(): void;
+    stopAnimation(): void;
+    continueAnimation(): void;
+    init(): void;
+    private findBone;
+    dispose(): void;
+    reset(): void;
+    play(option?: {
+        keyframes: DigitalModelKeyframe[];
+        items: DigitalModelPlayerItem[];
+        effects: DigitalModelPlayerEffect[];
+    }): Promise<boolean>;
+    /**
+     * 加法式新增：为「外部统一时钟驱动」做一次性准备（不启动 rAF、不累加时间）。
+     * 设置 keyframes/items/effects，绑定道具骨骼，预加载特效贴图到 externalTextures。
+     * 与既有 play() 互不影响：play() 仍走其内部自驱 rAF 路径。
+     */
+    prepareExternalDrive(option?: {
+        keyframes?: DigitalModelKeyframe[];
+        items?: DigitalModelPlayerItem[];
+        effects?: DigitalModelPlayerEffect[];
+    }): void;
+    /**
+     * 加法式新增：按外部给定的全局时间渲染当前帧（供 DigitalPerformanceV2Plugin 的统一时钟驱动）。
+     * 不持有 requestAnimationFrame、不累加自身时间、不 resolve；调用前请先 prepareExternalDrive。
+     * @param time 章节内全局时间(ms)
+     * @param delta 距上一帧的时间增量(ms)，用于推进骨骼动画 mixer
+     */
+    renderAtTime(time: number, delta: number): void;
+    /**
+     * 运动轨迹线开关（默认关闭、不显示）。仅 debug / 特殊需求由业务显式开启。
+     * - 开启：显示 curveLine，并回填当前时间点之前的轨迹（此后每帧继续累积）。
+     * - 关闭：隐藏并清空轨迹几何。
+     */
+    setTraceVisible(visible: boolean): void;
+    traceUpDate(): void;
+    clearTrace(): void;
+    clearProcessedNeedRenderKeyframeIndices(): void;
+    private hasProcessedNeedRenderForTimestamp;
+    private markNeedRenderProcessedForTimestamp;
+    private getRightHandBone;
+    private updateKeyframeItems;
+    private detachAllKeyframeItems;
+}