@applemusic-like-lyrics/core 0.3.1 → 0.4.0
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/README.md +3 -3
- package/dist/amll-core.cjs +5020 -0
- package/dist/amll-core.cjs.map +1 -0
- package/dist/amll-core.d.cts +997 -0
- package/dist/amll-core.d.mts +997 -0
- package/dist/{amll-core.js → amll-core.mjs} +87 -5786
- package/dist/amll-core.mjs.map +1 -0
- package/dist/style.css +399 -0
- package/package.json +69 -84
- package/LICENSE +0 -661
- package/dist/amll-core.css +0 -2
- package/dist/amll-core.js.map +0 -1
- package/dist/bg-render/base.d.ts +0 -109
- package/dist/bg-render/img.d.ts +0 -4
- package/dist/bg-render/index.d.ts +0 -28
- package/dist/bg-render/mesh-renderer/cp-generate.d.ts +0 -6
- package/dist/bg-render/mesh-renderer/cp-presets.d.ts +0 -22
- package/dist/bg-render/mesh-renderer/index.d.ts +0 -76
- package/dist/bg-render/pixi-renderer.d.ts +0 -22
- package/dist/canvas-test.d.ts +0 -1
- package/dist/index.d.ts +0 -4
- package/dist/interfaces.d.ts +0 -106
- package/dist/lyric-player/base.d.ts +0 -327
- package/dist/lyric-player/bottom-line.d.ts +0 -29
- package/dist/lyric-player/canvas/index.d.ts +0 -24
- package/dist/lyric-player/canvas/lyric-line.d.ts +0 -24
- package/dist/lyric-player/canvas/text-layout.d.ts +0 -39
- package/dist/lyric-player/dom/index.d.ts +0 -59
- package/dist/lyric-player/dom/interlude-dots.d.ts +0 -22
- package/dist/lyric-player/dom/lyric-line.d.ts +0 -80
- package/dist/lyric-player/dom-slim/index.d.ts +0 -38
- package/dist/lyric-player/dom-slim/interlude-dots.d.ts +0 -22
- package/dist/lyric-player/dom-slim/lyric-line.d.ts +0 -69
- package/dist/lyric-player/index.d.ts +0 -29
- package/dist/mg-test.d.ts +0 -1
- package/dist/utils/debounce.d.ts +0 -2
- package/dist/utils/derivative.d.ts +0 -2
- package/dist/utils/eq-set.d.ts +0 -1
- package/dist/utils/flagsets.d.ts +0 -17
- package/dist/utils/is-cjk.d.ts +0 -1
- package/dist/utils/linear.d.ts +0 -21
- package/dist/utils/lyric-split-words.d.ts +0 -11
- package/dist/utils/matrix.d.ts +0 -25
- package/dist/utils/mutex.d.ts +0 -2
- package/dist/utils/optimize-lyric.d.ts +0 -9
- package/dist/utils/resource.d.ts +0 -4
- package/dist/utils/schedule.d.ts +0 -6
- package/dist/utils/spring.d.ts +0 -26
- package/dist/utils/wa-spring.d.ts +0 -27
|
@@ -1,327 +0,0 @@
|
|
|
1
|
-
import { Disposable, HasElement, LyricLine, LyricWord, OptimizeLyricOptions } from '../interfaces.ts';
|
|
2
|
-
import { Spring, SpringParams } from '../utils/spring.ts';
|
|
3
|
-
import { BottomLineEl } from './bottom-line.ts';
|
|
4
|
-
import { InterludeDots } from './dom/interlude-dots.ts';
|
|
5
|
-
import { LyricLineRenderMode, MaskObsceneWordsMode } from './index.ts';
|
|
6
|
-
/**
|
|
7
|
-
* 歌词播放器的基类,已经包含了有关歌词操作和排版的功能,子类需要为其实现对应的显示展示操作
|
|
8
|
-
*/
|
|
9
|
-
export declare abstract class LyricPlayerBase extends EventTarget implements HasElement, Disposable {
|
|
10
|
-
protected element: HTMLElement;
|
|
11
|
-
abstract get baseFontSize(): number;
|
|
12
|
-
protected currentTime: number;
|
|
13
|
-
/** @internal */
|
|
14
|
-
lyricLinesSize: WeakMap<LyricLineBase, [number, number]>;
|
|
15
|
-
/** @internal */
|
|
16
|
-
lyricLineElementMap: WeakMap<Element, LyricLineBase>;
|
|
17
|
-
protected currentLyricLines: LyricLine[];
|
|
18
|
-
protected processedLines: LyricLine[];
|
|
19
|
-
protected lyricLinesIndexes: WeakMap<LyricLineBase, number>;
|
|
20
|
-
protected hotLines: Set<number>;
|
|
21
|
-
protected bufferedLines: Set<number>;
|
|
22
|
-
protected isNonDynamic: boolean;
|
|
23
|
-
protected hasDuetLine: boolean;
|
|
24
|
-
protected scrollToIndex: number;
|
|
25
|
-
protected disableSpring: boolean;
|
|
26
|
-
protected interludeDotsSize: [number, number];
|
|
27
|
-
protected interludeDots: InterludeDots;
|
|
28
|
-
protected bottomLine: BottomLineEl;
|
|
29
|
-
protected enableBlur: boolean;
|
|
30
|
-
protected enableScale: boolean;
|
|
31
|
-
protected maskObsceneWords: MaskObsceneWordsMode;
|
|
32
|
-
protected maskObsceneWordChar: string;
|
|
33
|
-
protected hidePassedLines: boolean;
|
|
34
|
-
protected scrollBoundary: number[];
|
|
35
|
-
protected currentLyricLineObjects: LyricLineBase[];
|
|
36
|
-
protected isSeeking: boolean;
|
|
37
|
-
protected lastCurrentTime: number;
|
|
38
|
-
protected alignAnchor: "top" | "bottom" | "center";
|
|
39
|
-
protected alignPosition: number;
|
|
40
|
-
protected scrollOffset: number;
|
|
41
|
-
readonly size: [number, number];
|
|
42
|
-
protected allowScroll: boolean;
|
|
43
|
-
protected isPageVisible: boolean;
|
|
44
|
-
protected optimizeOptions: OptimizeLyricOptions;
|
|
45
|
-
protected initialLayoutFinished: boolean;
|
|
46
|
-
/**
|
|
47
|
-
* 标记用户是否正在进行滚动交互
|
|
48
|
-
*/
|
|
49
|
-
protected isUserScrolling: boolean;
|
|
50
|
-
protected wheelTimeout: ReturnType<typeof setTimeout> | undefined;
|
|
51
|
-
/**
|
|
52
|
-
* 视图额外预渲染(overscan)距离,单位:像素。
|
|
53
|
-
* 用于决定在视口之外多少距离内也认为是“可见”,以便提前创建/保留行元素。
|
|
54
|
-
*/
|
|
55
|
-
protected overscanPx: number;
|
|
56
|
-
protected posXSpringParams: Partial<SpringParams>;
|
|
57
|
-
protected posYSpringParams: Partial<SpringParams>;
|
|
58
|
-
protected scaleSpringParams: Partial<SpringParams>;
|
|
59
|
-
protected scaleForBGSpringParams: Partial<SpringParams>;
|
|
60
|
-
private onPageShow;
|
|
61
|
-
private onPageHide;
|
|
62
|
-
private scrolledHandler;
|
|
63
|
-
protected isScrolled: boolean;
|
|
64
|
-
/** @internal */
|
|
65
|
-
resizeObserver: ResizeObserver;
|
|
66
|
-
protected wordFadeWidth: number;
|
|
67
|
-
protected targetAlignIndex: number;
|
|
68
|
-
protected lastInterludeState: boolean;
|
|
69
|
-
constructor(element?: HTMLElement);
|
|
70
|
-
private beginScrollHandler;
|
|
71
|
-
private endScrollHandler;
|
|
72
|
-
private limitScrollOffset;
|
|
73
|
-
/**
|
|
74
|
-
* 设置文字动画的渐变宽度,单位以歌词行的主文字字体大小的倍数为单位,默认为 0.5,即一个全角字符的一半宽度
|
|
75
|
-
*
|
|
76
|
-
* 如果要模拟 Apple Music for Android 的效果,可以设置为 1
|
|
77
|
-
*
|
|
78
|
-
* 如果要模拟 Apple Music for iPad 的效果,可以设置为 0.5
|
|
79
|
-
*
|
|
80
|
-
* 如果想要近乎禁用渐变效果,可以设置成非常接近 0 的小数(例如 `0.0001` ),但是**不可以为 0**
|
|
81
|
-
*
|
|
82
|
-
* @param value 需要设置的渐变宽度,单位以歌词行的主文字字体大小的倍数为单位,默认为 0.5
|
|
83
|
-
*/
|
|
84
|
-
setWordFadeWidth(value?: number): void;
|
|
85
|
-
/**
|
|
86
|
-
* 是否启用歌词行缩放效果,默认启用
|
|
87
|
-
*
|
|
88
|
-
* 如果启用,非选中的歌词行会轻微缩小以凸显当前播放歌词行效果
|
|
89
|
-
*
|
|
90
|
-
* 此效果对性能影响微乎其微,推荐启用
|
|
91
|
-
* @param enable 是否启用歌词行缩放效果
|
|
92
|
-
*/
|
|
93
|
-
setEnableScale(enable?: boolean): void;
|
|
94
|
-
/**
|
|
95
|
-
* 获取当前是否启用了歌词行缩放效果
|
|
96
|
-
* @returns 是否启用歌词行缩放效果
|
|
97
|
-
*/
|
|
98
|
-
getEnableScale(): boolean;
|
|
99
|
-
/**
|
|
100
|
-
* 获取当前文字动画的渐变宽度,单位以歌词行的主文字字体大小的倍数为单位
|
|
101
|
-
* @returns 当前文字动画的渐变宽度,单位以歌词行的主文字字体大小的倍数为单位
|
|
102
|
-
*/
|
|
103
|
-
getWordFadeWidth(): number;
|
|
104
|
-
setIsSeeking(isSeeking: boolean): void;
|
|
105
|
-
/**
|
|
106
|
-
* 设置是否隐藏已经播放过的歌词行,默认不隐藏
|
|
107
|
-
* @param hide 是否隐藏已经播放过的歌词行,默认不隐藏
|
|
108
|
-
*/
|
|
109
|
-
setHidePassedLines(hide: boolean): void;
|
|
110
|
-
/**
|
|
111
|
-
* 设置是否启用歌词行的模糊效果
|
|
112
|
-
* @param enable 是否启用
|
|
113
|
-
*/
|
|
114
|
-
setEnableBlur(enable: boolean): void;
|
|
115
|
-
/**
|
|
116
|
-
* 设置歌词中不雅用语的掩码模式
|
|
117
|
-
* @param mode 掩码模式
|
|
118
|
-
* @see {@link MaskObsceneWordsMode}
|
|
119
|
-
*/
|
|
120
|
-
setMaskObsceneWords(mode: MaskObsceneWordsMode): void;
|
|
121
|
-
/**
|
|
122
|
-
* 设置不雅用语掩码使用的字符,默认为 `*`
|
|
123
|
-
* @param char 单个字符,用于替换不雅用语中的字符
|
|
124
|
-
*/
|
|
125
|
-
setMaskObsceneWordChar(char: string): void;
|
|
126
|
-
rebuildLyricLines(): void;
|
|
127
|
-
/**
|
|
128
|
-
* 根据当前配置处理不雅用语单词
|
|
129
|
-
* @param word 单词对象
|
|
130
|
-
* @internal
|
|
131
|
-
*/
|
|
132
|
-
processObsceneWord(word: LyricWord): string;
|
|
133
|
-
/**
|
|
134
|
-
* 设置目标歌词行的对齐方式,默认为 `center`
|
|
135
|
-
*
|
|
136
|
-
* - 设置成 `top` 的话将会向目标歌词行的顶部对齐
|
|
137
|
-
* - 设置成 `bottom` 的话将会向目标歌词行的底部对齐
|
|
138
|
-
* - 设置成 `center` 的话将会向目标歌词行的垂直中心对齐
|
|
139
|
-
* @param alignAnchor 歌词行对齐方式,详情见函数说明
|
|
140
|
-
*/
|
|
141
|
-
setAlignAnchor(alignAnchor: "top" | "bottom" | "center"): void;
|
|
142
|
-
/**
|
|
143
|
-
* 设置默认的歌词行对齐位置,相对于整个歌词播放组件的大小位置,默认为 `0.5`
|
|
144
|
-
* @param alignPosition 一个 `[0.0-1.0]` 之间的任意数字,代表组件高度由上到下的比例位置
|
|
145
|
-
*/
|
|
146
|
-
setAlignPosition(alignPosition: number): void;
|
|
147
|
-
/**
|
|
148
|
-
* 设置 overscan(视图上下额外缓冲渲染区)距离,单位:像素。
|
|
149
|
-
* @param px 像素值,默认 300
|
|
150
|
-
*/
|
|
151
|
-
setOverscanPx(px: number): void;
|
|
152
|
-
/** 获取当前 overscan 像素距离 */
|
|
153
|
-
getOverscanPx(): number;
|
|
154
|
-
/**
|
|
155
|
-
* 设置是否使用物理弹簧算法实现歌词动画效果,默认启用
|
|
156
|
-
*
|
|
157
|
-
* 如果启用,则会通过弹簧算法实时处理歌词位置,但是需要性能足够强劲的电脑方可流畅运行
|
|
158
|
-
*
|
|
159
|
-
* 如果不启用,则会回退到基于 `transition` 的过渡效果,对低性能的机器比较友好,但是效果会比较单一
|
|
160
|
-
*/
|
|
161
|
-
setEnableSpring(enable?: boolean): void;
|
|
162
|
-
/**
|
|
163
|
-
* 获取当前是否启用了物理弹簧
|
|
164
|
-
* @returns 是否启用物理弹簧
|
|
165
|
-
*/
|
|
166
|
-
getEnableSpring(): boolean;
|
|
167
|
-
/**
|
|
168
|
-
* 获取当前播放时间里是否处于间奏区间
|
|
169
|
-
* 如果是则会返回单位为毫秒的始末时间
|
|
170
|
-
* 否则返回 undefined
|
|
171
|
-
*
|
|
172
|
-
* 这个只允许内部调用
|
|
173
|
-
* @returns [开始时间,结束时间,大概处于的歌词行ID,下一句是否为对唱歌词] 或 undefined 如果不处于间奏区间
|
|
174
|
-
*/
|
|
175
|
-
protected getCurrentInterlude(): [number, number, number, boolean] | undefined;
|
|
176
|
-
/**
|
|
177
|
-
* 设置歌词的优化配置项,这些配置项默认全部开启
|
|
178
|
-
*
|
|
179
|
-
* 注意,如果在 `setLyricLines` 之后修改此配置,需要重新调用 `setLyricLines()` 才能对当前歌词生效
|
|
180
|
-
* @param options 优化配置选项
|
|
181
|
-
* @see {@link OptimizeLyricOptions}
|
|
182
|
-
*/
|
|
183
|
-
setOptimizeOptions(options: OptimizeLyricOptions): void;
|
|
184
|
-
/**
|
|
185
|
-
* 设置当前播放歌词,要注意传入后这个数组内的信息不得修改,否则会发生错误
|
|
186
|
-
* @param lines 歌词数组
|
|
187
|
-
* @param initialTime 初始时间,默认为 0
|
|
188
|
-
*/
|
|
189
|
-
setLyricLines(lines: LyricLine[], initialTime?: number): void;
|
|
190
|
-
/**
|
|
191
|
-
* 获取当前是否在播放
|
|
192
|
-
* @returns 当前是否在播放
|
|
193
|
-
*/
|
|
194
|
-
getIsPlaying(): boolean;
|
|
195
|
-
/**
|
|
196
|
-
* 设置当前播放进度,单位为毫秒且**必须是整数**,此时将会更新内部的歌词进度信息
|
|
197
|
-
* 内部会根据调用间隔和播放进度自动决定如何滚动和显示歌词,所以这个的调用频率越快越准确越好
|
|
198
|
-
*
|
|
199
|
-
* 调用完成后,可以每帧调用 `update` 函数来执行歌词动画效果
|
|
200
|
-
* @param time 当前播放进度,单位为毫秒
|
|
201
|
-
*/
|
|
202
|
-
setCurrentTime(time: number, isSeek?: boolean): void;
|
|
203
|
-
protected updateDynamicSpringParams(): void;
|
|
204
|
-
/**
|
|
205
|
-
* 重新布局定位歌词行的位置,调用完成后再逐帧调用 `update`
|
|
206
|
-
* 函数即可让歌词通过动画移动到目标位置。
|
|
207
|
-
*
|
|
208
|
-
* 函数有一个 `force` 参数,用于指定是否强制修改布局,也就是不经过动画直接调整元素位置和大小。
|
|
209
|
-
*
|
|
210
|
-
* 此函数还有一个 `reflow` 参数,用于指定是否需要重新计算布局
|
|
211
|
-
*
|
|
212
|
-
* 因为计算布局必定会导致浏览器重排布局,所以会大幅度影响流畅度和性能,故请只在以下情况下将其设置为 true:
|
|
213
|
-
*
|
|
214
|
-
* 1. 歌词页面大小发生改变时(这个组件会自行处理)
|
|
215
|
-
* 2. 加载了新的歌词时(不论前后歌词是否完全一样)
|
|
216
|
-
* 3. 用户自行跳转了歌曲播放位置(不论距离远近)
|
|
217
|
-
*
|
|
218
|
-
* @param sync 是否同步执行,通常用于初始化或 Resize 时立即布局
|
|
219
|
-
* @param force 是否绕过弹簧效果强制更新位置
|
|
220
|
-
*/
|
|
221
|
-
calcLayout(sync?: boolean, force?: boolean): Promise<void>;
|
|
222
|
-
protected calculateBlur(itemIndex: number, isActive: boolean, latestIndex: number): number;
|
|
223
|
-
/**
|
|
224
|
-
* 设置所有歌词行在横坐标上的弹簧属性,包括重量、弹力和阻力。
|
|
225
|
-
*
|
|
226
|
-
* @param params 需要设置的弹簧属性,提供的属性将会覆盖原来的属性,未提供的属性将会保持原样
|
|
227
|
-
* @deprecated 考虑到横向弹簧效果并不常见,所以这个函数将会在未来的版本中移除
|
|
228
|
-
*/
|
|
229
|
-
setLinePosXSpringParams(_params?: Partial<SpringParams>): void;
|
|
230
|
-
/**
|
|
231
|
-
* 设置所有歌词行在纵坐标上的弹簧属性,包括重量、弹力和阻力。
|
|
232
|
-
*
|
|
233
|
-
* @param params 需要设置的弹簧属性,提供的属性将会覆盖原来的属性,未提供的属性将会保持原样
|
|
234
|
-
*/
|
|
235
|
-
setLinePosYSpringParams(params?: Partial<SpringParams>): void;
|
|
236
|
-
/**
|
|
237
|
-
* 设置所有歌词行在缩放大小上的弹簧属性,包括重量、弹力和阻力。
|
|
238
|
-
*
|
|
239
|
-
* @param params 需要设置的弹簧属性,提供的属性将会覆盖原来的属性,未提供的属性将会保持原样
|
|
240
|
-
*/
|
|
241
|
-
setLineScaleSpringParams(params?: Partial<SpringParams>): void;
|
|
242
|
-
protected isPlaying: boolean;
|
|
243
|
-
/**
|
|
244
|
-
* 暂停部分效果演出,目前会暂停播放间奏点的动画,且将背景歌词显示出来
|
|
245
|
-
*/
|
|
246
|
-
pause(): void;
|
|
247
|
-
/**
|
|
248
|
-
* 恢复部分效果演出,目前会恢复播放间奏点的动画
|
|
249
|
-
*/
|
|
250
|
-
resume(): void;
|
|
251
|
-
/**
|
|
252
|
-
* 更新动画,这个函数应该被逐帧调用或者在以下情况下调用一次:
|
|
253
|
-
*
|
|
254
|
-
* 1. 刚刚调用完设置歌词函数的时候
|
|
255
|
-
* @param delta 距离上一次被调用到现在的时长,单位为毫秒(可为浮点数)
|
|
256
|
-
*/
|
|
257
|
-
update(delta?: number): void;
|
|
258
|
-
protected onResize(): void;
|
|
259
|
-
/**
|
|
260
|
-
* 获取一个特殊的底栏元素,默认是空白的,可以往内部添加任意元素
|
|
261
|
-
*
|
|
262
|
-
* 这个元素始终在歌词的底部,可以用于显示歌曲创作者等信息
|
|
263
|
-
*
|
|
264
|
-
* 但是请勿删除该元素,只能在内部存放元素
|
|
265
|
-
*
|
|
266
|
-
* @returns 一个元素,可以往内部添加任意元素
|
|
267
|
-
*/
|
|
268
|
-
getBottomLineElement(): HTMLElement;
|
|
269
|
-
/**
|
|
270
|
-
* 重置用户滚动状态
|
|
271
|
-
*
|
|
272
|
-
* 请在用户完成滚动点击跳转歌词时调用本事件再调用 `calcLayout` 以正确滚动到目标位置
|
|
273
|
-
*/
|
|
274
|
-
resetScroll(): void;
|
|
275
|
-
/**
|
|
276
|
-
* 获取当前歌词数组
|
|
277
|
-
*
|
|
278
|
-
* 一般和最后调用 `setLyricLines` 给予的参数一样
|
|
279
|
-
* @returns 当前歌词数组
|
|
280
|
-
*/
|
|
281
|
-
getLyricLines(): LyricLine[];
|
|
282
|
-
/**
|
|
283
|
-
* 获取当前歌词的播放位置
|
|
284
|
-
*
|
|
285
|
-
* 一般和最后调用 `setCurrentTime` 给予的参数一样
|
|
286
|
-
* @returns 当前播放位置
|
|
287
|
-
*/
|
|
288
|
-
getCurrentTime(): number;
|
|
289
|
-
getElement(): HTMLElement;
|
|
290
|
-
dispose(): void;
|
|
291
|
-
}
|
|
292
|
-
/**
|
|
293
|
-
* 所有标准歌词行的基类
|
|
294
|
-
* @internal
|
|
295
|
-
*/
|
|
296
|
-
export declare abstract class LyricLineBase extends EventTarget implements Disposable {
|
|
297
|
-
protected top: number;
|
|
298
|
-
protected scale: number;
|
|
299
|
-
protected blur: number;
|
|
300
|
-
protected opacity: number;
|
|
301
|
-
protected delay: number;
|
|
302
|
-
readonly lineTransforms: {
|
|
303
|
-
posY: Spring;
|
|
304
|
-
scale: Spring;
|
|
305
|
-
};
|
|
306
|
-
abstract getLine(): LyricLine;
|
|
307
|
-
abstract enable(time?: number, shouldPlay?: boolean): void;
|
|
308
|
-
abstract disable(): void;
|
|
309
|
-
abstract resume(): void;
|
|
310
|
-
abstract pause(): void;
|
|
311
|
-
onLineSizeChange(_size: [number, number]): void;
|
|
312
|
-
setTransform(top?: number, scale?: number, opacity?: number, blur?: number, _force?: boolean, delay?: number, _mode?: LyricLineRenderMode): void;
|
|
313
|
-
rebuildElement(): void;
|
|
314
|
-
/**
|
|
315
|
-
* 判定歌词是否可以应用强调辉光效果
|
|
316
|
-
*
|
|
317
|
-
* 果子在对辉光效果的解释是一种强调(emphasized)效果
|
|
318
|
-
*
|
|
319
|
-
* 条件是一个单词时长大于等于 1s 且长度小于等于 7
|
|
320
|
-
*
|
|
321
|
-
* @param word 单词
|
|
322
|
-
* @returns 是否可以应用强调辉光效果
|
|
323
|
-
*/
|
|
324
|
-
static shouldEmphasize(word: LyricWord): boolean;
|
|
325
|
-
abstract update(delta?: number): void;
|
|
326
|
-
dispose(): void;
|
|
327
|
-
}
|
|
@@ -1,29 +0,0 @@
|
|
|
1
|
-
import { Disposable, HasElement } from '../interfaces.ts';
|
|
2
|
-
import { Spring } from '../utils/spring.ts';
|
|
3
|
-
import { LyricPlayerBase } from './base.ts';
|
|
4
|
-
export declare class BottomLineEl implements HasElement, Disposable {
|
|
5
|
-
private lyricPlayer;
|
|
6
|
-
private element;
|
|
7
|
-
private left;
|
|
8
|
-
private top;
|
|
9
|
-
private delay;
|
|
10
|
-
lineSize: [number, number];
|
|
11
|
-
readonly lineTransforms: {
|
|
12
|
-
posX: Spring;
|
|
13
|
-
posY: Spring;
|
|
14
|
-
};
|
|
15
|
-
private isFocused;
|
|
16
|
-
private blur;
|
|
17
|
-
constructor(lyricPlayer: LyricPlayerBase);
|
|
18
|
-
measureSize(): Promise<[number, number]>;
|
|
19
|
-
private lastStyle;
|
|
20
|
-
show(): void;
|
|
21
|
-
hide(): void;
|
|
22
|
-
setFocused(focused: boolean): void;
|
|
23
|
-
private rebuildStyle;
|
|
24
|
-
getElement(): HTMLElement;
|
|
25
|
-
setTransform(left?: number, top?: number, blur?: number, force?: boolean, delay?: number): void;
|
|
26
|
-
update(delta?: number): void;
|
|
27
|
-
get isInSight(): boolean;
|
|
28
|
-
dispose(): void;
|
|
29
|
-
}
|
|
@@ -1,24 +0,0 @@
|
|
|
1
|
-
import { LyricLine } from '../../interfaces.ts';
|
|
2
|
-
import { LyricPlayerBase } from '../base.ts';
|
|
3
|
-
import { CanvasLyricLine } from './lyric-line.ts';
|
|
4
|
-
export declare class CanvasLyricPlayer extends LyricPlayerBase {
|
|
5
|
-
private canvasElement;
|
|
6
|
-
currentLyricLineObjects: CanvasLyricLine[];
|
|
7
|
-
/** @internal */
|
|
8
|
-
readonly ctx: CanvasRenderingContext2D;
|
|
9
|
-
/** @internal */
|
|
10
|
-
baseLineHeight: number;
|
|
11
|
-
/** @internal */
|
|
12
|
-
baseFontSize: number;
|
|
13
|
-
/** @internal */
|
|
14
|
-
baseFontFamily: string;
|
|
15
|
-
constructor();
|
|
16
|
-
setLyricLines(lines: LyricLine[], initialTime?: number): void;
|
|
17
|
-
onResize(): void;
|
|
18
|
-
/**
|
|
19
|
-
* @internal
|
|
20
|
-
* @param size
|
|
21
|
-
*/
|
|
22
|
-
setFontSize(emSize: number): void;
|
|
23
|
-
update(delta?: number): void;
|
|
24
|
-
}
|
|
@@ -1,24 +0,0 @@
|
|
|
1
|
-
import { LyricLine } from '../../interfaces.ts';
|
|
2
|
-
import { LyricLineBase } from '../base.ts';
|
|
3
|
-
import { CanvasLyricPlayer } from './index.ts';
|
|
4
|
-
export declare class CanvasLyricLine extends LyricLineBase {
|
|
5
|
-
private player;
|
|
6
|
-
private line;
|
|
7
|
-
constructor(player: CanvasLyricPlayer, line?: LyricLine);
|
|
8
|
-
getLine(): LyricLine;
|
|
9
|
-
private lineSize;
|
|
10
|
-
measureSize(): [number, number];
|
|
11
|
-
private layoutWords;
|
|
12
|
-
private translatedLayoutWords;
|
|
13
|
-
private romanLayoutWords;
|
|
14
|
-
private lineCanvas;
|
|
15
|
-
/** @internal */
|
|
16
|
-
relayout(): void;
|
|
17
|
-
enable(): void;
|
|
18
|
-
disable(): void;
|
|
19
|
-
resume(): void;
|
|
20
|
-
pause(): void;
|
|
21
|
-
setTransform(top?: number, scale?: number, opacity?: number, blur?: number, force?: boolean, delay?: number): void;
|
|
22
|
-
get isInSight(): boolean;
|
|
23
|
-
update(delta?: number): void;
|
|
24
|
-
}
|
|
@@ -1,39 +0,0 @@
|
|
|
1
|
-
export interface TextLayoutResult {
|
|
2
|
-
text: string;
|
|
3
|
-
index: number;
|
|
4
|
-
lineIndex: number;
|
|
5
|
-
width: number;
|
|
6
|
-
height: number;
|
|
7
|
-
x: number;
|
|
8
|
-
}
|
|
9
|
-
export interface TextLayoutConfig {
|
|
10
|
-
fontSize: number;
|
|
11
|
-
maxWidth: number;
|
|
12
|
-
lineHeight: number;
|
|
13
|
-
/**
|
|
14
|
-
* 是否统一空格宽度,即不论空白字符有多少个,都只占用一个字符的宽度
|
|
15
|
-
*/
|
|
16
|
-
uniformSpace: boolean;
|
|
17
|
-
}
|
|
18
|
-
export interface TextLayoutFinalState {
|
|
19
|
-
x: number;
|
|
20
|
-
lineIndex: number;
|
|
21
|
-
}
|
|
22
|
-
/**
|
|
23
|
-
* 对指定文本进行布局,返回每个字符的位置信息
|
|
24
|
-
* 目前仅可支持普通拉丁字符和 CJK 字符
|
|
25
|
-
* @param ctx 2D 画板上下文
|
|
26
|
-
* @param text 文本
|
|
27
|
-
* @param config 字体大小
|
|
28
|
-
* @param initialX 初始 X 坐标,对于需要布局多段文本的情况下有所帮助
|
|
29
|
-
*/
|
|
30
|
-
export declare function layoutWord(ctx: CanvasRenderingContext2D, text: string, config: TextLayoutConfig, initialX?: number): Generator<TextLayoutResult, TextLayoutFinalState, void>;
|
|
31
|
-
/**
|
|
32
|
-
* 对指定文本进行布局,返回每段文字的位置信息
|
|
33
|
-
* 目前仅可支持普通拉丁字符和 CJK 字符
|
|
34
|
-
* @param ctx 2D 画板上下文
|
|
35
|
-
* @param text 文本
|
|
36
|
-
* @param config 字体大小
|
|
37
|
-
* @param initialX 初始 X 坐标,对于需要布局多段文本的情况下有所帮助
|
|
38
|
-
*/
|
|
39
|
-
export declare function layoutLine(ctx: CanvasRenderingContext2D, text: string, config: TextLayoutConfig, initialX?: number): Generator<TextLayoutResult, void, void>;
|
|
@@ -1,59 +0,0 @@
|
|
|
1
|
-
import { LyricLine } from '../../interfaces.ts';
|
|
2
|
-
import { LyricLineBase, LyricPlayerBase } from '../base.ts';
|
|
3
|
-
import { LyricLineEl } from './lyric-line.ts';
|
|
4
|
-
/**
|
|
5
|
-
* 歌词行鼠标相关事件,可以获取到歌词行的索引和歌词行元素
|
|
6
|
-
*/
|
|
7
|
-
export declare class LyricLineMouseEvent extends MouseEvent {
|
|
8
|
-
/**
|
|
9
|
-
* 歌词行索引
|
|
10
|
-
*/
|
|
11
|
-
readonly lineIndex: number;
|
|
12
|
-
/**
|
|
13
|
-
* 歌词行元素
|
|
14
|
-
*/
|
|
15
|
-
readonly line: LyricLineBase;
|
|
16
|
-
constructor(
|
|
17
|
-
/**
|
|
18
|
-
* 歌词行索引
|
|
19
|
-
*/
|
|
20
|
-
lineIndex: number,
|
|
21
|
-
/**
|
|
22
|
-
* 歌词行元素
|
|
23
|
-
*/
|
|
24
|
-
line: LyricLineBase, event: MouseEvent);
|
|
25
|
-
}
|
|
26
|
-
export type LyricLineMouseEventListener = (evt: LyricLineMouseEvent) => void;
|
|
27
|
-
/**
|
|
28
|
-
* 歌词播放组件,本框架的核心组件
|
|
29
|
-
*
|
|
30
|
-
* 尽可能贴切 Apple Music for iPad 的歌词效果设计,且做了力所能及的优化措施
|
|
31
|
-
*/
|
|
32
|
-
export declare class DomLyricPlayer extends LyricPlayerBase {
|
|
33
|
-
currentLyricLineObjects: LyricLineEl[];
|
|
34
|
-
onResize(): void;
|
|
35
|
-
readonly supportPlusLighter: boolean;
|
|
36
|
-
readonly supportMaskImage: boolean;
|
|
37
|
-
readonly innerSize: [number, number];
|
|
38
|
-
private readonly onLineClickedHandler;
|
|
39
|
-
/**
|
|
40
|
-
* 是否为非逐词歌词
|
|
41
|
-
* @internal
|
|
42
|
-
*/
|
|
43
|
-
_getIsNonDynamic(): boolean;
|
|
44
|
-
private _baseFontSize;
|
|
45
|
-
get baseFontSize(): number;
|
|
46
|
-
constructor();
|
|
47
|
-
private rebuildStyle;
|
|
48
|
-
setWordFadeWidth(value?: number): void;
|
|
49
|
-
/**
|
|
50
|
-
* 设置当前播放歌词,要注意传入后这个数组内的信息不得修改,否则会发生错误
|
|
51
|
-
* @param lines 歌词数组
|
|
52
|
-
* @param initialTime 初始时间,默认为 0
|
|
53
|
-
*/
|
|
54
|
-
setLyricLines(lines: LyricLine[], initialTime?: number): void;
|
|
55
|
-
pause(): void;
|
|
56
|
-
resume(): void;
|
|
57
|
-
update(delta?: number): void;
|
|
58
|
-
dispose(): void;
|
|
59
|
-
}
|
|
@@ -1,22 +0,0 @@
|
|
|
1
|
-
import { Disposable, HasElement } from '../../interfaces.ts';
|
|
2
|
-
export declare class InterludeDots implements HasElement, Disposable {
|
|
3
|
-
private element;
|
|
4
|
-
private dot0;
|
|
5
|
-
private dot1;
|
|
6
|
-
private dot2;
|
|
7
|
-
private left;
|
|
8
|
-
private top;
|
|
9
|
-
private playing;
|
|
10
|
-
private lastStyle;
|
|
11
|
-
private currentInterlude?;
|
|
12
|
-
private currentTime;
|
|
13
|
-
private targetBreatheDuration;
|
|
14
|
-
constructor();
|
|
15
|
-
getElement(): HTMLElement;
|
|
16
|
-
setTransform(left?: number, top?: number): void;
|
|
17
|
-
setInterlude(interlude?: [number, number]): void;
|
|
18
|
-
pause(): void;
|
|
19
|
-
resume(): void;
|
|
20
|
-
update(delta?: number): void;
|
|
21
|
-
dispose(): void;
|
|
22
|
-
}
|
|
@@ -1,80 +0,0 @@
|
|
|
1
|
-
import { LyricLine, LyricWord } from '../../interfaces.ts';
|
|
2
|
-
import { LyricLineBase } from '../base.ts';
|
|
3
|
-
import { LyricLineRenderMode } from '../index.ts';
|
|
4
|
-
import { DomLyricPlayer } from '.';
|
|
5
|
-
interface RealWord extends LyricWord {
|
|
6
|
-
mainElement: HTMLSpanElement;
|
|
7
|
-
subElements: HTMLSpanElement[];
|
|
8
|
-
elementAnimations: Animation[];
|
|
9
|
-
maskAnimations: Animation[];
|
|
10
|
-
width: number;
|
|
11
|
-
height: number;
|
|
12
|
-
padding: number;
|
|
13
|
-
shouldEmphasize: boolean;
|
|
14
|
-
}
|
|
15
|
-
export declare class RawLyricLineMouseEvent extends MouseEvent {
|
|
16
|
-
readonly line: LyricLineBase;
|
|
17
|
-
constructor(line: LyricLineBase, event: MouseEvent);
|
|
18
|
-
}
|
|
19
|
-
type MouseEventMap = {
|
|
20
|
-
[evt in keyof HTMLElementEventMap]: HTMLElementEventMap[evt] extends MouseEvent ? evt : never;
|
|
21
|
-
};
|
|
22
|
-
type MouseEventTypes = MouseEventMap[keyof MouseEventMap];
|
|
23
|
-
type MouseEventListener = (this: LyricLineEl, ev: RawLyricLineMouseEvent) => void;
|
|
24
|
-
export declare class LyricLineEl extends LyricLineBase {
|
|
25
|
-
private lyricPlayer;
|
|
26
|
-
private lyricLine;
|
|
27
|
-
private element;
|
|
28
|
-
private splittedWords;
|
|
29
|
-
private built;
|
|
30
|
-
lineSize: number[];
|
|
31
|
-
private renderMode;
|
|
32
|
-
private currentBrightAlpha;
|
|
33
|
-
private currentDarkAlpha;
|
|
34
|
-
private targetBrightAlpha;
|
|
35
|
-
private targetDarkAlpha;
|
|
36
|
-
private segmenter;
|
|
37
|
-
constructor(lyricPlayer: DomLyricPlayer, lyricLine?: LyricLine);
|
|
38
|
-
private listenersMap;
|
|
39
|
-
private readonly onMouseEvent;
|
|
40
|
-
addMouseEventListener(type: MouseEventTypes, callback: MouseEventListener | null, options?: boolean | AddEventListenerOptions | undefined): void;
|
|
41
|
-
removeMouseEventListener(type: MouseEventTypes, callback: MouseEventListener | null, options?: boolean | EventListenerOptions | undefined): void;
|
|
42
|
-
areWordsOnSameLine(word1: RealWord, word2: RealWord): boolean;
|
|
43
|
-
private isEnabled;
|
|
44
|
-
enable(maskAnimationTime?: number, shouldPlay?: boolean): Promise<void>;
|
|
45
|
-
disable(): void;
|
|
46
|
-
private lastWord?;
|
|
47
|
-
resume(): Promise<void>;
|
|
48
|
-
pause(): Promise<void>;
|
|
49
|
-
setMaskAnimationState(maskAnimationTime?: number): void;
|
|
50
|
-
getLine(): LyricLine;
|
|
51
|
-
private _prevParentEl;
|
|
52
|
-
private lastStyle;
|
|
53
|
-
show(): void;
|
|
54
|
-
hide(): void;
|
|
55
|
-
private rebuildStyle;
|
|
56
|
-
rebuildElement(): void;
|
|
57
|
-
/** 设置翻译与音译行文本 */
|
|
58
|
-
private setSubLinesText;
|
|
59
|
-
private getRubyCharCount;
|
|
60
|
-
private getRubySegments;
|
|
61
|
-
private createWord;
|
|
62
|
-
private buildWord;
|
|
63
|
-
private initFloatAnimation;
|
|
64
|
-
private initEmphasizeAnimation;
|
|
65
|
-
private get totalDuration();
|
|
66
|
-
onLineSizeChange(_size: [number, number]): void;
|
|
67
|
-
updateMaskImageSync(): void;
|
|
68
|
-
private generateCalcBasedMaskImage;
|
|
69
|
-
private generateWebAnimationBasedMaskImage;
|
|
70
|
-
getElement(): HTMLElement;
|
|
71
|
-
private updateMaskAlphaTargets;
|
|
72
|
-
private applyAlphaToDom;
|
|
73
|
-
setTransform(top?: number, scale?: number, opacity?: number, blur?: number, force?: boolean, delay?: number, mode?: LyricLineRenderMode): void;
|
|
74
|
-
update(delta?: number): void;
|
|
75
|
-
_getDebugTargetPos(): string;
|
|
76
|
-
get isInSight(): boolean;
|
|
77
|
-
private disposeElements;
|
|
78
|
-
dispose(): void;
|
|
79
|
-
}
|
|
80
|
-
export {};
|
|
@@ -1,38 +0,0 @@
|
|
|
1
|
-
import { LyricLine } from '../../interfaces.ts';
|
|
2
|
-
import { LyricPlayerBase } from '../base.ts';
|
|
3
|
-
import { LyricLineEl } from './lyric-line.ts';
|
|
4
|
-
/**
|
|
5
|
-
* 歌词播放组件,本框架的核心组件
|
|
6
|
-
*
|
|
7
|
-
* 尽可能贴切 Apple Music for iPad 的歌词效果设计,且做了力所能及的优化措施
|
|
8
|
-
*/
|
|
9
|
-
export declare class DomSlimLyricPlayer extends LyricPlayerBase {
|
|
10
|
-
currentLyricLineObjects: LyricLineEl[];
|
|
11
|
-
private debounceCalcLayout;
|
|
12
|
-
onResize(): void;
|
|
13
|
-
readonly supportPlusLighter: boolean;
|
|
14
|
-
readonly supportMaskImage: boolean;
|
|
15
|
-
readonly innerSize: [number, number];
|
|
16
|
-
private readonly onLineClickedHandler;
|
|
17
|
-
/**
|
|
18
|
-
* 是否为非逐词歌词
|
|
19
|
-
* @internal
|
|
20
|
-
*/
|
|
21
|
-
_getIsNonDynamic(): boolean;
|
|
22
|
-
private _baseFontSize;
|
|
23
|
-
get baseFontSize(): number;
|
|
24
|
-
constructor();
|
|
25
|
-
private rebuildStyle;
|
|
26
|
-
setWordFadeWidth(value?: number): void;
|
|
27
|
-
/**
|
|
28
|
-
* 设置当前播放歌词,要注意传入后这个数组内的信息不得修改,否则会发生错误
|
|
29
|
-
* @param lines 歌词数组
|
|
30
|
-
* @param initialTime 初始时间,默认为 0
|
|
31
|
-
*/
|
|
32
|
-
setLyricLines(lines: LyricLine[], initialTime?: number): void;
|
|
33
|
-
pause(): void;
|
|
34
|
-
resume(): void;
|
|
35
|
-
update(delta?: number): void;
|
|
36
|
-
calcLayout(sync?: boolean): Promise<void>;
|
|
37
|
-
dispose(): void;
|
|
38
|
-
}
|
|
@@ -1,22 +0,0 @@
|
|
|
1
|
-
import { Disposable, HasElement } from '../../interfaces.ts';
|
|
2
|
-
export declare class InterludeDots implements HasElement, Disposable {
|
|
3
|
-
private element;
|
|
4
|
-
private dot0;
|
|
5
|
-
private dot1;
|
|
6
|
-
private dot2;
|
|
7
|
-
private left;
|
|
8
|
-
private top;
|
|
9
|
-
private playing;
|
|
10
|
-
private lastStyle;
|
|
11
|
-
private currentInterlude?;
|
|
12
|
-
private currentTime;
|
|
13
|
-
private targetBreatheDuration;
|
|
14
|
-
constructor();
|
|
15
|
-
getElement(): HTMLElement;
|
|
16
|
-
setTransform(left?: number, top?: number): void;
|
|
17
|
-
setInterlude(interlude?: [number, number]): void;
|
|
18
|
-
pause(): void;
|
|
19
|
-
resume(): void;
|
|
20
|
-
update(delta?: number): void;
|
|
21
|
-
dispose(): void;
|
|
22
|
-
}
|