在前端开发中，很多时候需要使用一些包来辅助我们开发，其中 npm 包 @mohayonao/launch-control 可以帮助我们在音乐、游戏，甚至是其他的应用中控制时间和延迟效果，提供了一个方便的解决方案。本文将详细介绍该 npm 包的使用方法，并提供示例代码，帮助读者更好地理解和使用它。
一、安装
在终端中运行以下命令安装 @mohayonao/launch-control：
npm install @mohayonao/launch-control
安装完成后，可以在项目中引入该包：
var launchControl = require("@mohayonao/launch-control");二、基本功能
1. 启动时钟
使用 launchControl.createTimeline() 创建一个时间轴：
var timeline = launchControl.createTimeline();
然后使用 timeline.start() 启动时钟：
timeline.start();
2. 添加事件
使用 timeline.insertMIDIEvent() 将 MIDI 事件添加到时间轴中：
timeline.insertMIDIEvent(event, time);
其中，event 是一个 MIDI 事件对象，time 是该事件在时间轴中的位置。
以下是一个添加 MIDI 事件的示例：
-- -------------------- ---- -------
----- --------------- - ------- ---- -------
----- --------- - --- -- --
----- -------- - ----
--- ---- - - -- - - ----------------------- ---- -
-------------------------
- ----- --------- ----------- --------- - -- -------- --
- - ----
--
-------------------------
- ----- ---------- ----------- --------- - - --
- - ---- - ---
--
-3. 自定义时间轴
如果需要更多的自定义功能，可以使用 launchControl.createCustomTimeline() 创建一个自定义的时间轴。使用 timeline.insert() 插入事件，使用 timeline.setDuration() 设置时长。以下是一个自定义时间轴的示例：
var timeline = launchControl.createCustomTimeline({
duration: 10,
});
timeline.insert("noteon", 0, { noteNumber: 60, velocity: 0.8 });
timeline.insert("noteoff", 5, { noteNumber: 60 });
timeline.setDuration(20);
timeline.insert("noteon", 10, { noteNumber: 64, velocity: 0.7 });三、扩展功能
1. TimeTag
时间标签（TimeTag）是一个相对于时间轴开始时间的时间点。它可以表示绝对时间，也可以表示相对时间。使用 launchControl.TimeTag.create() 创建一个时间标签，并使用 launchControl.TimeTag.now() 获取当前时间标签。以下是一个 TimeTag 的示例：
var wait = launchControl.TimeTag.create(0.5);
var tag = launchControl.TimeTag.now();
timeline.insert("noteon", tag.add(wait), { noteNumber: 60, velocity: 0.8 });2. Clock
时钟（Clock）是一个可再生的时间源，它可以用于控制多个时间轴的播放速度。使用 launchControl.createClock() 创建一个时钟对象，使用 clock.start() 启动时钟。以下是一个 Clock 的示例：
-- -------------------- ---- ------- --- ----- - ---------------------------- --- --------- - ------------------------------- --- --------- - ------------------------------- --------------------------- ----- --------- ----------- --- --------- --- -- --- --------------------------- ----- ---------- ----------- -- -- ----- -------------- ------------------------ ------------------------
3. Envelope
包络线（Envelope）是一个控制音量的工具，它通过时间和值的映射来实现音量的变化。使用 launchControl.Envelope.create() 创建一个包络线，使用 envelope.gen() 获取输出值。以下是一个包络线的示例：
var envelope = launchControl.Envelope.create();
envelope.points.push({ time: 0, value: 0 }); // 0 秒时音量为 0
envelope.points.push({ time: 0.5, value: 1 }); // 0.5 秒时音量为 1
envelope.points.push({ time: 1, value: 0 }); // 1 秒时音量为 0
var vol = envelope.gen(timeline.getElapsed());四、总结
@mohayonao/launch-control 是一个强大的音乐管理工具包，它能够方便地控制时间和延迟效果。在本文中，我们详细介绍了如何使用 @mohayonao/launch-control 包来创建时间轴、添加事件，自定义时间轴、TimeTag、Clock、Envelope 等扩展功能。希望读者通过学习本文，能够更好地掌握该包的使用方法，并在实际的开发中灵活运用。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/60066bcc967216659e2447b9