.. _midi功能章节:  

midi
=========================================

    | MIDI全称是乐器数字接口(Musical Instrument Digital Interface)，是20 世纪80 年代初为解决电声乐器之间的通信问题而提出的，编曲界最广泛的音乐标准格式。
    | 默认SDK提供的midi功能分为 midi解码 和 midi琴。
    | **midi解码** 用户可参考toy_midi.c模式。
    | **midi琴** 用户可参考toy_midi_ctrl.c模式。
    | 详细midi功能及说明请看SDK包里的《杰理AD1x-45678_MIDI应用说明文档.pdf》文档。
    | （注：该文档实际函数以AD14_voice_toy_v1.8.0工程为准，其余芯片SDK实际函数名会有出入，但实现原理不变）


*****************************

MIDI解码基本功能以及对应的命令如下：
  #. 配置midi使用模式（CMD_MIDI_CTRL_MODE）
  #. 配置OKON模式发声（CMD_MIDI_GOON / CMD_MIDI_OKON_MODE）
  #. 切换主旋律乐器（CMD_MIDI_SET_PROG）
  #. 配置主通道乐器或者所以通道的乐器（CMD_MIDI_SET_CHN_PROG）
  #. mark回调播放功能（CMD_MIDI_SET_MARK）
  #. 小节回调（CMD_MIDI_SEEK_BACK_N）
  #. 调节midi外部音量功能（CMD_MIDI_SET_EX_VOL）
  #. 移半音功能（CMD_MIDI_SET_SEMITONE）
  #. 更改节奏和衰减功能（CMD_MIDI_CTRL_TEMPO）
  #. 配置限幅器（CMD_MIDI_LIMITER_TRIGGER）

MIDI琴基本功能与对应的命令如下：
  #. 动态修改音色相关参数
  #. 更改节奏和衰减功能（CMD_MIDI_CTRL_TEMPO）
  #. 调节midi外部音量功能（CMD_MIDI_SET_EX_VOL）
  #. 移半音功能（CMD_MIDI_SET_SEMITONE）
  #. 配置限幅器（CMD_MIDI_LIMITER_TRIGGER）
  #. 琴键颤音功能
  #. 弯音轮功能
  #. 动态修改当前播放的乐器通道

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

    详细更多说明，请看 SDK包里 doc文件夹里的 《 **杰理AD1x-45678_MIDI应用说明文档.pdf** 》

    .. image:: midi_doc.png
        :alt: "midi文档位置"
        :align: center
    .. centered:: midi文档位置