<h1 align="center">**伶伦转换器**</h1>

#	新手答疑指南

**考虑到某些用户电脑技术不是特别先进，且对这个项目充满了好奇心，但是又了解的不是很充分，为此，我特别在这里写一份新手指南，以满足各位的好奇心。放心，本文件全程中文。**

##	第一部分 关于 **音·创** 的作用

###	1.1  **音·创** 简介

**音·创 _Musicreater_** 是一款免费开源的针对 **《我的世界》** 的midi音乐转换库

而能够与人交互，以达到转换功能的，是 **音·创** 库的程序实现：**伶伦转换器**。

**伶伦转换器** 目前已经具备较为完善的[**教程**](./%E5%8A%9F%E8%83%BD%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E.md)，其中包括了下载安装一类，使你能够方便地进行转换。

**伶伦转换器**也是免费开源的，采用**带有特殊条款的Apache2.0**开源协议授权，详情请见[协议](../LICENSE.md)。

另外的，**伶伦转换器**并不是伶伦的主要开发方向，其功能也并非是 **伶伦** 本体（伶伦DAW）所提供的主要功能。**从 _音·创_ 到 _伶伦_ 的开发，其目的是为了方便 _《我的世界》_ 的音乐作者，进行 _《我的世界》_ 相关音乐的开发与创作**，而并不是转换MIDI文件！转换器的实现是在数字音频工作站的开发之前进行一定的技术探索，以更好地开发数字音乐工作站。

### 1.2  **音·创** 库到底有什么功能？
*	-	[x] 支持导入`.mid`文件
*	-	[x] 支持写入`.mcpack`文件
*	-	[x] 支持写入`.bdx`文件

*	不支持导入.mp3 .mp4 .wav等音频流文件

## 第二部分 关于格式的问题

### 2.1 关于.mid格式

其实对于经常玩音乐电子制作的朋友们来说，`MIDI`格式并不陌生，这里我简单介绍一下。

**MIDI文件的本质是电子乐谱，而不是记录声音波形文件的.mp3/.wav/.m4a等等文件。**
因此，我们将MIDI转换到《我的世界》播放器的过程，实际上就是把一类乐谱变为另一类乐谱的过程。而真正的演奏，是在游戏内实现的。

> mid格式是由MIDI继承而来。MID文件并不是一段录制好的声音，而是记录声音的信息，然后再告诉声卡如何再现音乐的一组指令。
> 这样一个MIDI文件每存1分钟的音乐只用大约5～10KB。今天，MID文件主要用于原始乐器作品、流行歌曲的业余表演、游戏音轨以及电子贺卡等。
> 
> ——百度百科
> 
> MIDI 音乐，保存在电脑上，就是 *.mid 类型的文件。和一般意义上的“音乐”不同，mid 类型的音乐通常并不是可直接发行供大众欣赏的音乐，
> 它更像是一种音乐创作者使用的工程文件。它没有歌词，不含有人类语言。如果说五线谱是给人类阅读的乐谱，
> MIDI音乐文件便是给计算机或其他电子设备使用的乐谱。对于“音乐”这个世界来说，它微不足道，却又是现代数字音乐的基石。虽不为大众所知，
> 但在 MIDI 音乐爱好者眼中，它却是非常有意思的东西。有了 MIDI 音乐技术和一台电脑，基本就等于拥有了一个乐队，加上相关的音乐知识，
> 就可以自己指挥这个“乐队”，创作音乐作品了！
> 同时，MIDI 技术由于数据结构简单，又与音乐有关，也成为了部分技术极客的爱好。有人使用MIDI技术+Arduino开源硬件制作了架子鼓，
> 有人通过分析大量MIDI乐曲结构，设计了人工智能作曲软件，还有更酷的人使用MIDI音乐制作了随节奏变幻的特斯拉线圈！
> 在MIDI 音乐的世界里，汇聚了一批喜欢音乐又热爱技术的人。我们有理由相信，玩MIDI音乐的你，定是多才多艺的。
> 
> ——midishow.com


### 2.2 关于.mid格式的获取

通过刚刚的介绍，你可能已经发现，`.MID`文件因为受众并不多而并没有被广泛熟知，因而你之前可能完全没见过这个文件，更何况要弄一首自己心仪的歌了。

这里介绍几个获取.mid格式的方法：

0.	最简单的方法是向你心仪的作编曲人投递一份申请，请求TA将其作编曲过程中的相关工程文件给你，这样，你就可以获得一首乐曲的电子曲谱，从而获得其MIDI文件。
1.	如果无法向作曲人申请相关文件的话，成为一个作编曲人也许是一个不错的选择，当然，很多人做不到这一点，但是有必要提到这一点，当你在下面的渠道中都无法获得想要的文件时，你应该考虑是不是需要自己创作内容，或者，请别人帮你创作内容。
2.	当你没有这样的文件时，问问别人或者从群里下载公开的文件也是个思路，不过这个办法通常使用次数有限且能找到的文件不多，不过，值得注意的是，[**音·创**开发交流群](https://jq.qq.com/?_wv=1027&k=hpeRxrYr)的**群文件中所含的MIDI文件均为网友分享学习交流使用，请在下载后一个小时内删除。**
3.	自己找MIDI：现在，我将给你提供一个完整的找mid的方法，请认真学习：

    **1.** 首先你需要在[MidiShow](www.midishow.com)网站中注册一个账号，并不复杂，你可能只需要一个QQ号便可以授权登录。
    **2.** 登录你的账号，主界面应该如下图所示：
       <img src="https://foruda.gitee.com/images/1672644995747340749/36c9c143_10062986.png">
    **3.** 在显眼的搜索框中，输入你想要的歌曲名称，接下来的教程，我以`夜空中最亮的星`这首歌及它的mid来演示下载流程。点击搜索框，完成这一步。
       <img src="https://foruda.gitee.com/images/1672645340943813483/44d0db69_10062986.png">
    **4.** 接下来看到搜索结果如下，你可以点进去一个听听，决定你是否要下载；也有可能你什么都没搜到，那你就得换首歌或者换个途径了。
       <img src="https://foruda.gitee.com/images/1672645574402099694/6b7e18e5_10062986.png">
    **5.** 点击播放按钮试听，网站上的效果可能一般，但是会听音乐的人应该很快就能决定你是否需要下载这个音乐。如果需要下载，你可以进行到下一步，
    如果不行，那你可以退回刚刚的页面换一个。
       <img src="https://foruda.gitee.com/images/1672645752246438160/47cead78_10062986.png">
    **6.** 翻到最下面，如图，你可以对这首歌进行打分，打分可以使积分+1，如果你喜欢这首乐曲的话，建议打5分；你可以对这首歌进行评论，一次有意义的评论可以+3分。而下载一首歌需要-3积分，如果你先完成了这两项操作再下载，那你还会再赚1积分。所以推荐这样做！
       <img src="https://foruda.gitee.com/images/1672646433045265565/26ea29b2_10062986.png">
    **完成后会像这样：** 
       <img src="https://foruda.gitee.com/images/1672646242419857480/5e8809b8_10062986.png">
    **7.** 接下来下载，往上翻网页，找到这个标识，然后单击。
       <img src="https://foruda.gitee.com/images/1672646275215822535/63b402db_10062986.png">
    **8.** 确认完毕后点击下载。
       <img src="https://foruda.gitee.com/images/1672646309787744490/f459adac_10062986.png">
    **9.** 完成下载，如图：
       <img src="https://foruda.gitee.com/images/1672646335942429563/2449ed0b_10062986.png">
4.	使用音频（波形）转换MIDI的工具也是一个选择。不得不说，科技的进步带来了许多便利，让这样困难的事情也变得简单。如果上述方法仍然没有解决你的问题，那么你可以在下一章节中找到有关这个途径的说明。

### 2.3 波形格式转换为.mid格式

**注意，使用这个技术有一定难度，酌情使用！**

文件转换：此技术是将记录声音波形文件的.mp3/.wav/.m4a等等文件转换为.mid数字乐谱文件的。

概述：波形转mid需要把**模拟的波形频谱信号转为数字乐谱信号**，这个过程**一定有损失**，而且损失非常大。

请各位以后不要在答疑群中问类似于我这个转换效果为什么不好这样的问题，谢谢。

如果直接用**widi**的话相当于对声音进行了[**傅里叶变换**](https://baike.baidu.com/item/%E5%82%85%E9%87%8C%E5%8F%B6%E5%8F%98%E6%8D%A2/7119029)，你确实可以分离出其中的音高，但是效果在不同情况下差异较大，尤其是有架子鼓啊啥的玩也的时候，比较**差**。
（[widi工具链接](https://pan.baidu.com/s/1j_Jui0piQ6rMOXM0GJtqTg) 提取码：b0lw ）

如果**只有钢琴**的谱子需要分离，有一个完美的选择：[Giant MIDI-Piano](https://zhuanlan.zhihu.com/p/270999354)

如果不然有其他的乐器也需要分离，那么可能就有点困难，像**cakewalk**就确实也可以把音频变成mid，但是可能要
**先把原MP3分离成人声音轨、贝斯音轨等再傅里叶变换。**

当然我也可能了解的不全，没准现在已经有船新的技术可以分离的更好了，那就太棒了！(〃'▽'〃)

另外，我们开发者也象征性的找了一些相关的网站，我们没使用过，不担保效果。
[serocs.cn](https://www.serocs.cn/transcription/)

同时，midishow论坛里有一些大佬也提供了解决方案，看看他们的发言也是一个不错的选择。我就只给个论坛链接了，经常有人问这种问题，你可以去那里随便找到一篇帖子看看。[MidiShow论坛](https://www.midishow.com/question)

### 2.4 输出格式的问题

在前面说到，输出主要有`.mcpack`和`.bdx`文件的输出，接下来我会围绕这两个文件进行简单的说明。

#### 2.4.1 .mcpack是什么

输出.mcpack文件其实对于一个**资深《我的世界：基岩版》玩家**应该并不陌生。

`.mcpack`文件其实就是《我的世界：基岩版》的附加包文件，里面一般分为行为包和材质包

我们生成的命令组属于**行为包** (下图就是一个例子)

<img src="https://foruda.gitee.com/images/1672647779755793187/884abaa9_10062986.png">

如果你是使用桌面平台游玩基岩版，像我一样，是可以直接打开这个文件、并将这个包导入我的世界的。当然，移动平台也很简单，在游戏资源包界面有导入本地资源包的选项，便可将其导入。

资源包导入世界之后的使用方法，我们也制作了[**简单的教程**](https://gitee.com/TriM-Organization/Musicreater/blob/master/docs/%E7%94%9F%E6%88%90%E6%96%87%E4%BB%B6%E7%9A%84%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E.md)，如果你对使用导入后的文件有所疑问，可以看看。

#### 2.4.2 .bdx是什么

.bdx 文件其实是一个新型结构文件，利用一些标识符对结构进行标记，可以使用相关软件导入到《我的世界：中国版》。

由于这不属于官方文件，且我并不是很熟悉这个结构，所以请对这个格式有问题的好兄弟加一下[QQ群](https://jq.qq.com/?_wv=1027&k=hpeRxrYr)，问问群里有导入经验的大佬。

## 第三部分 关于其他问题

如果你在仔细阅读以上内容之后，仍然感觉有所困惑，可以加我们的[QQ群](https://jq.qq.com/?_wv=1027&k=hpeRxrYr)来提问，但是请注意，**由于开发者们都很忙，群友们的耐心也都有限，所以恳请大家提出有意义的问题。**
如果您在使用过程中遇到报错，希望你能够把完整的报错内容复制给我们，而不是截一半的屏幕或者在群内大呼小叫。以下两张图给了你很好的解释说明。

<table><tr><td><img src=https://foruda.gitee.com/images/1673053210913625261/37197693_9911226.png></td><td><img src=https://foruda.gitee.com/images/1673052430511255221/6a279fae_9911226.png></td></tr></table>

这里附一个关于[智慧地提问](https://github.com/tvvocold/How-To-Ask-Questions-The-Smart-Way)的文章，大家可以看看。

希望不要我把这个文件在聊天中甩给你，那说明我可能已经没有耐心了。

看完这份说明，如果你打算开始使用我们的工具的话，请移步至[演示程序使用教程](./%E5%8A%9F%E8%83%BD%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E.md)。

## 第三部分 结尾

**欢迎加群：[861684859](https://jq.qq.com/?_wv=1027&k=hpeRxrYr)**

**欢迎加群：[861684859](https://jq.qq.com/?_wv=1027&k=hpeRxrYr)**

**欢迎加群：[861684859](https://jq.qq.com/?_wv=1027&k=hpeRxrYr)**

**如果遇到问题，仔细地再次[阅读教程](./%E5%8A%9F%E8%83%BD%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E.md)很重要！！！！！**

**如果遇到问题，仔细地再次[阅读教程](./%E5%8A%9F%E8%83%BD%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E.md)很重要！！！！！**

**如果遇到问题，仔细地再次[阅读教程](./%E5%8A%9F%E8%83%BD%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E.md)很重要！！！！！**

（重要的事情说三遍）

**(有能力的同志麻烦给仓库star一下)**

**(有能力的同志麻烦给仓库star一下)**

**(有能力的同志麻烦给仓库star一下)**
