@reall3d/reall3dviewer 2.5.2 → 2.5.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/pkg.d.ts CHANGED
@@ -54,6 +54,63 @@ export declare interface CameraInfo {
54
54
  lookUp?: number[];
55
55
  }
56
56
 
57
+ /**
58
+ * 圆形音频可视化遮罩配置项
59
+ * 控制音频可视化的外观、行为、音频分析参数
60
+ */
61
+ export declare interface CircularAudioMaskOptions {
62
+ /** 音频源URL */
63
+ audioUrl?: string;
64
+ /** 音量 */
65
+ volume?: number;
66
+ /** 渲染容器:支持DOM元素或CSS选择器 */
67
+ container?: HTMLElement | string;
68
+ /** 画布宽度,支持数值或CSS尺寸 */
69
+ width?: number | string;
70
+ /** 画布高度,支持数值或CSS尺寸 */
71
+ height?: number | string;
72
+ /** 是否启用全屏覆盖模式 */
73
+ fullScreen?: boolean;
74
+ /** 圆形遮罩基础半径(静止状态半径) */
75
+ baseRadius?: number;
76
+ /** 音频响应最大扩张幅度 */
77
+ maxExpansion?: number;
78
+ /** 圆形分段数量,值越高曲线越平滑,性能消耗越高 */
79
+ segments?: number;
80
+ /** 遮罩层填充颜色 */
81
+ maskColor?: string;
82
+ /** 遮罩层不透明度 0~1 */
83
+ maskOpacity?: number;
84
+ /** 边缘发光颜色 */
85
+ glowColor?: string;
86
+ /** 发光效果模糊半径 */
87
+ glowBlur?: number;
88
+ /** 发光边缘宽度 */
89
+ glowWidth?: number;
90
+ /** 是否显示发光轮廓效果 */
91
+ showGlow?: boolean;
92
+ /** FFT大小,必须是2的幂,决定音频分析精度 */
93
+ fftSize?: number;
94
+ /** 音频平滑时间常数,值越大动画越平滑延迟越高 */
95
+ smoothingTimeConstant?: number;
96
+ /** 最小分贝值,低于此值将被视为静音 */
97
+ minDecibels?: number;
98
+ /** 最大分贝值,用于归一化音频数据 */
99
+ maxDecibels?: number;
100
+ /** 自定义频率波段配置数组 */
101
+ frequencyBands?: FrequencyBand[];
102
+ /** 实例初始化完成回调 */
103
+ onReady?: () => void;
104
+ /** 错误捕获回调 */
105
+ onError?: (error: Error) => void;
106
+ /** 节拍检测回调,返回节拍强度 0~1 */
107
+ onBeat?: (intensity: number) => void;
108
+ /** 画布CSS层级z-index */
109
+ zIndex?: number;
110
+ /** 圆形旋转速度 */
111
+ rotateSpeed?: number;
112
+ }
113
+
57
114
  declare class Events {
58
115
  private map;
59
116
  constructor();
@@ -64,6 +121,21 @@ declare class Events {
64
121
  clear(): void;
65
122
  }
66
123
 
124
+ /**
125
+ * 音频频率波段配置
126
+ * 用于定义不同频率范围的音频响应参数
127
+ */
128
+ export declare interface FrequencyBand {
129
+ /** 波段唯一标识名称 */
130
+ name: string;
131
+ /** 频率范围 [起始频率(Hz), 结束频率(Hz)] */
132
+ range: [number, number];
133
+ /** 波段权重值,数值越大对可视化效果影响越强 */
134
+ weight: number;
135
+ /** 波段对应渲染颜色(可选) */
136
+ color?: string;
137
+ }
138
+
67
139
  /**
68
140
  * Metadata
69
141
  */
@@ -88,12 +160,16 @@ export declare interface MetaData {
88
160
  mobileDownloadLimitSplatCount?: number;
89
161
  /** Maximum download count for PC splats */
90
162
  pcDownloadLimitSplatCount?: number;
163
+ /** disable transition effect on load; defaults to false */
164
+ disableTransitionEffectOnLoad?: boolean;
91
165
  /** Meter scale factor */
92
166
  meterScale?: number;
93
167
  /** Text watermark */
94
168
  watermark?: string;
95
- /** Display watermark */
169
+ /** Display watermark (default false) */
96
170
  showWatermark?: boolean;
171
+ /** Display marks (default true) */
172
+ showMark?: boolean;
97
173
  /** Display bounding box */
98
174
  showBoundBox?: boolean;
99
175
  /** Camera parameters */
@@ -177,6 +253,73 @@ export declare interface MetaData {
177
253
  addVirtualGround?: boolean;
178
254
  /** default to true */
179
255
  autuUpdateVirtualGroundPosition?: boolean;
256
+ minimap?: MinimapOptions;
257
+ audioMask?: CircularAudioMaskOptions;
258
+ }
259
+
260
+ export declare interface MinimapOptions {
261
+ /** 小地图边长 */
262
+ size?: number;
263
+ /** 小地图位置 */
264
+ corner?: string;
265
+ /** 小地图边距X */
266
+ marginX?: number;
267
+ /** 小地图边距Y */
268
+ marginY?: number;
269
+ /** 小地图视口坐标范围minX */
270
+ minX?: number;
271
+ /** 小地图视口坐标范围maxX */
272
+ maxX?: number;
273
+ /** 小地图视口坐标范围minZ */
274
+ minZ?: number;
275
+ /** 小地图视口坐标范围maxZ */
276
+ maxZ?: number;
277
+ /** 小地图底图链接 */
278
+ url?: string;
279
+ /** 小地图底图透明度 */
280
+ bgOpacity?: number;
281
+ /** 小地图边长(手机) */
282
+ mobileSize?: number;
283
+ /** 小地图位置(手机) */
284
+ mobileCorner?: string;
285
+ /** 小地图边距X(手机) */
286
+ mobileMarginX?: number;
287
+ /** 小地图边距Y(手机) */
288
+ mobileMarginY?: number;
289
+ /** 圆环内径,默认6像素 */
290
+ ringInnerRadius?: number;
291
+ /** 圆环外径,默认10像素 */
292
+ ringOuterRadius?: number;
293
+ /** 圆环颜色,默认'#eeeeee' */
294
+ ringColor?: number | string;
295
+ /** 圆环透明度,默认0.9 */
296
+ ringOpacity?: number;
297
+ /** 朝向三角的长,默认18像素 */
298
+ arrowLength?: number;
299
+ /** 朝向三角的宽,默认14像素 */
300
+ arrowWidth?: number;
301
+ /** 朝向三角的偏移量,默认圆环外径+0.01 */
302
+ arrowOffset?: number;
303
+ /** 朝向三角颜色,默认'#eeeeee' */
304
+ arrowColor?: number | string;
305
+ /** 朝向三角透明度,默认0.9 */
306
+ arrowOpacity?: number;
307
+ /** 视锥整体向前的偏移量,默认0 */
308
+ frustumOffset?: number;
309
+ /** 视锥近端的纵向距离,默认10像素 */
310
+ frustumNear?: number;
311
+ /** 视锥远端的纵向距离,默认50像素 */
312
+ frustumFar?: number;
313
+ /** 视锥颜色,默认'#666666' */
314
+ frustumColor?: number | string;
315
+ /** 视锥近端颜色透明度,用于近实远淡渐变,默认0.9 */
316
+ frustumNearOpacity?: number;
317
+ /** 视锥远端颜色透明度,用于近实远淡渐变,默认0.1 */
318
+ frustumFarOpacity?: number;
319
+ /** 最小FOV,限制范围调优指示器外观用 */
320
+ frustumMinHFov?: number;
321
+ /** 最大FOV,限制范围调优指示器外观用 */
322
+ frustumMaxFov?: number;
180
323
  }
181
324
 
182
325
  /**