Deprecated: parse_url(): Passing null to parameter #1 ($url) of type string is deprecated in /www/wwwroot/blog_qqvbc_com/usr/plugins/Access/Access_Core.php on line 339

Deprecated: parse_url(): Passing null to parameter #1 ($url) of type string is deprecated in /www/wwwroot/blog_qqvbc_com/usr/plugins/Access/Access_Core.php on line 392

Deprecated: parse_url(): Passing null to parameter #1 ($url) of type string is deprecated in /www/wwwroot/blog_qqvbc_com/usr/plugins/Access/Access_Core.php on line 394
Joyber 发布的文章 - Joyber 的博客

Joyber 发布的文章

核心结论

  1. MIDI会记录乐器标识(Program Change,音色号),但不是全部乐器;打击乐通道(ch9,MIDI通道10)是特殊规则,不用Program Change。
  2. 理论上:解码MIDI,在对应时间触发对应音符+对应音色,就能播放出整首曲子;
  3. 但是:MIDI本身不带音频采样,音色好坏、能不能发出声音,完全依赖「音源」。

一、乐器标识怎么记录的

MIDI通道 0~15:

  • 普通旋律通道(ch0~ch8, ch11~ch15):用 Program Change(程序改变事件),一个0~127数字。
    这个数字对应GM标准音色库:

    • 0=钢琴,24=原声吉他,40=小提琴,等等。

      比如事件:PROGRAM ch0 prog 0 → 0号通道切换为钢琴。
      之后这个通道的NoteOn音符,就用钢琴音色发声。
  • 打击乐通道 ch9(MIDI标准叫通道10)
    这个通道不使用Program Change!
    这个通道里音符编号本身就代表不同鼓/镲。
    note36=底鼓,note38军鼓,note42闭踩镲……
    不管你发什么Program Change,GM音源都会忽略,永远按打击乐表映射。

注意:

  1. Program Change只是选择音色编号,不是保存声音;
  2. 标准是 GM / GM2 / GS / XG。如果MIDI是GS/XG扩展音色,普通GM音源播放会音色错乱。

二、是不是解码+按时触发音符就能播放?

原理上是的,完整流程:

  1. 解析MIDI,得到所有事件:时间点、通道、音色号、音符、力度。
  2. 准备一个音源(SoundFont / 硬件音源):里面存放所有乐器的音频采样(wav采样)。
  3. 按计算出来的时间,在对应时刻通知音源:

    通道X,音色N,音符Y,力度V → 播放这个采样;NoteOff就停止/释放采样。

两个关键坑(非常重要)

坑1:音源不一样,听感完全不一样

MIDI只写「要用0号钢琴」,不写钢琴的音频。

  • 用简陋GM软音源:钢琴听起来像电子玩具;
  • 用高质量SoundFont(比如大钢琴sf2):听起来很真实;

    同一个MIDI文件,换音源,整首歌质感天差地别。

坑2:还有很多附加控制事件,漏掉会很难听

MIDI不止音符,还有:

  • CC控制器:音量、声像、踩镲开闭、延音踏板、表情;
  • 弯音Pitch Wheel:滑音;
    如果你的播放器只处理NoteOn/NoteOff,忽略CC事件:
  • 踩镲不会开合;
  • 延音踏板失效;
  • 音量没有强弱起伏;
    曲子会变得干巴巴,甚至鼓组踩镲声音错乱(DTX鼓谱非常依赖CC踩镲信号)。

三、结合你PHP解码器来说

你现在PHP代码只能做到解析读取MIDI事件,PHP本身不能直接播放声音。
两种方案实现播放:

  1. 方案A:PHP解析MIDI → 提取事件+时间轴 → 交给前端JS音源(比如WebMIDI、SoundFont.js)在浏览器播放。
  2. 方案B:PHP解析,导出事件列表 → 送入后端软音源(如fluidsynth)渲染导出wav音频文件。
适合你的电鼓场景:
解析ch9打击乐通道,提取 [time, note, velocity] 列表,就可以用来做DTX谱、动态鼓谱,不一定需要渲染完整音乐。

四、一句话总结

MIDI记录了用哪个音色、什么时候按下哪个音符、力度多大、各种控制器参数;
只要有音源(乐器采样库),并且按时序执行全部事件(音符+CC),就可以还原整首乐曲;
MIDI本身不带任何声音采样,没有音源就发不出声音。

<?php
class MidiDecoder
{
    public string $raw;
    public int $ptr = 0;
    public array $header = [];
    public array $tracks = [];

    // 新增:全局时间参数
    public int $tpqn;
    public float $microsecondsPerQuarter = 500000; // 默认 120BPM: 500000微秒/四分音符
    public float $bpm = 120.0;
    public array $tempoEvents = []; // 保存所有tempo变更点 delta => microseconds
    public array $allTrackEvents = []; // 合并全部事件,用于时间计算

    public function loadFile(string $filePath): bool
    {
        if (!is_file($filePath)) return false;
        $this->raw = file_get_contents($filePath);
        $this->ptr = 0;
        $this->tempoEvents = [];
        $this->allTrackEvents = [];
        return $this->parseHeader();
    }

    // 读取N字节,大端序
    protected function readBig(int $bytes): int
    {
        $bin = substr($this->raw, $this->ptr, $bytes);
        $this->ptr += $bytes;
        $unpack = unpack('N', str_pad($bin, 4, chr(0), STR_PAD_LEFT));
        return $unpack[1];
    }

    // VLQ变长整数解码
    protected function readVLQ(): int
    {
        $val = 0;
        while (true) {
            $b = ord($this->raw[$this->ptr++]);
            $val = ($val << 7) | ($b & 0x7F);
            if (($b & 0x80) === 0) break;
        }
        return $val;
    }

    protected function parseHeader(): bool
    {
        $id = substr($this->raw, $this->ptr, 4);
        $this->ptr += 4;
        if ($id !== 'MThd') return false;

        $len = $this->readBig(4);
        $fmt = $this->readBig(2);
        $trackCount = $this->readBig(2);
        $tpqn = $this->readBig(2);

        $this->header = [
            'format' => $fmt,
            'track_count' => $trackCount,
            'tpqn' => $tpqn
        ];
        $this->tpqn = $tpqn;

        for ($t = 0; $t < $trackCount; $t++) {
            $this->parseTrack($t);
        }
        return true;
    }

    protected function parseTrack(int $trackIndex)
    {
        $id = substr($this->raw, $this->ptr, 4);
        $this->ptr +=4;
        $trackLen = $this->readBig(4);
        $trackEnd = $this->ptr + $trackLen;

        $events = [];
        $runningStatus = 0;
        $tickTotal = 0;

        while ($this->ptr < $trackEnd) {
            $delta = $this->readVLQ();
            $tickTotal += $delta;

            $byte = ord($this->raw[$this->ptr]);
            if (($byte & 0x80) === 0) {
                $status = $runningStatus;
            } else {
                $status = $byte;
                $runningStatus = $byte;
                $this->ptr++;
            }

            $type = ($status >> 4) & 0x0F;
            $ch = $status & 0x0F;

            $ev = [
                'delta' => $delta,
                'tick' => $tickTotal,
                'track' => $trackIndex
            ];

            if ($status === 0xFF) {
                $metaType = ord($this->raw[$this->ptr++]);
                $metaLen = $this->readVLQ();
                $metaData = substr($this->raw, $this->ptr, $metaLen);
                $this->ptr += $metaLen;
                $ev['type'] = 'meta';
                $ev['meta_type'] = $metaType;
                $ev['data'] = $metaData;

                // BPM Tempo元事件 FF 51 03
                if ($metaType === 0x51 && $metaLen === 3) {
                    $ms = unpack('N', chr(0) . $metaData);
                    $this->tempoEvents[$tickTotal] = $ms[1];
                }
            } elseif ($status === 0xF0 || $status === 0xF7) {
                $sysexLen = $this->readVLQ();
                $data = substr($this->raw, $this->ptr, $sysexLen);
                $this->ptr += $sysexLen;
                $ev['type'] = 'sysex';
                $ev['status'] = $status;
                $ev['data'] = $data;
            } else {
                switch ($type) {
                    case 0x9:
                        $note = ord($this->raw[$this->ptr++]);
                        $vel = ord($this->raw[$this->ptr++]);
                        $ev['type'] = 'note_on';
                        $ev['ch'] = $ch;
                        $ev['note'] = $note;
                        $ev['vel'] = $vel;
                        break;
                    case 0x8:
                        $note = ord($this->raw[$this->ptr++]);
                        $vel = ord($this->raw[$this->ptr++]);
                        $ev['type'] = 'note_off';
                        $ev['ch'] = $ch;
                        $ev['note'] = $note;
                        $ev['vel'] = $vel;
                        break;
                    case 0xB:
                        $ccNum = ord($this->raw[$this->ptr++]);
                        $val = ord($this->raw[$this->ptr++]);
                        $ev['type'] = 'cc';
                        $ev['ch'] = $ch;
                        $ev['cc'] = $ccNum;
                        $ev['value'] = $val;
                        break;
                    case 0xC:
                        $prog = ord($this->raw[$this->ptr++]);
                        $ev['type'] = 'program';
                        $ev['ch'] = $ch;
                        $ev['program'] = $prog;
                        break;
                    case 0xE:
                        $b1 = ord($this->raw[$this->ptr++]);
                        $b2 = ord($this->raw[$this->ptr++]);
                        $pitch = ($b2 <<7) | $b1;
                        $ev['type'] = 'pitch';
                        $ev['ch'] = $ch;
                        $ev['value'] = $pitch;
                        break;
                    default:
                        $ev['type'] = 'unknown';
                        $ev['status'] = $status;
                        break;
                }
            }
            $events[] = $ev;
            $this->allTrackEvents[] = $ev;
        }
        $this->tracks[] = $events;
    }

    /**
     * 根据tick计算真实时间(秒),支持多段BPM变速
     */
    public function tickToSeconds(int $targetTick): float
    {
        ksort($this->tempoEvents);
        $lastTick = 0;
        $lastMicro = 500000;
        $totalSec = 0.0;

        foreach ($this->tempoEvents as $tick => $micro) {
            if ($targetTick <= $lastTick) break;
            $useTick = min($tick, $targetTick);
            $deltaTick = $useTick - $lastTick;
            $totalSec += $deltaTick * $lastMicro / $this->tpqn / 1000000;
            $lastTick = $tick;
            $lastMicro = $micro;
        }
        // 剩余tick
        if ($targetTick > $lastTick) {
            $deltaTick = $targetTick - $lastTick;
            $totalSec += $deltaTick * $lastMicro / $this->tpqn / 1000000;
        }
        return $totalSec;
    }

    // 打印全部事件,附带时间,增加过滤打击乐通道ch=9
    public function dumpWithTime(bool $onlyDrumChannel = false)
    {
        echo "==== MIDI HEADER ====\n";
        print_r($this->header);
        echo "\n==== TPQN: {$this->tpqn} ====\n";

        foreach ($this->tracks as $tkIdx => $events) {
            echo "\n--- Track #$tkIdx , total events: ".count($events)."\n";
            foreach ($events as $e) {
                $sec = $this->tickToSeconds($e['tick']);
                if ($onlyDrumChannel) {
                    if (!isset($e['ch']) || $e['ch'] !== 9) continue;
                }
                echo sprintf("tick:%6d | time:%.3fs | ", $e['tick'], $sec);
                echo match($e['type']) {
                    'note_on' => "NOTE_ON ch{$e['ch']} note{$e['note']} vel{$e['vel']}",
                    'note_off' => "NOTE_OFF ch{$e['ch']} note{$e['note']} vel{$e['vel']}",
                    'cc' => "CC ch{$e['ch']} cc{$e['cc']} val{$e['value']}",
                    'program' => "PROGRAM ch{$e['ch']} prog{$e['program']}",
                    'meta' => "META type{$e['meta_type']} len=".strlen($e['data']),
                    'sysex' => "SYSEX",
                    default => "UNKNOWN"
                };
                echo "\n";
            }
        }
    }
}

// ========= 使用示例 =========
$decoder = new MidiDecoder();
$midFile = './test.mid';
if ($decoder->loadFile($midFile)) {
    // 第二个参数true:只输出打击乐通道 ch=9(电鼓音符)
    $decoder->dumpWithTime(true);
} else {
    echo "解析失败,文件不存在或者不是合法MIDI";
}
?>

核心逻辑说明

  1. 收集所有FF 51 03 tempo事件,记录在哪个tick点变速
  2. tickToSeconds() 分段累加时间:
    [
    \text{秒数} = \frac{\text{tick数量} \times \text{每四分音符微秒数}}{\text{TPQN}} \div 1000000
    ]

    • microsecondsPerQuarter:一个四分音符占用多少微秒
    • BPM = 60000000 / microsecondsPerQuarter
    • 例:500000微秒/四分音符 → BPM=120
  3. 新增开关 $onlyDrumChannel = true,直接过滤只输出鼓通道ch=9,专门用于DTX/手卷鼓MIDI分析

用法

  • 只看鼓点并附带时间:$decoder->dumpWithTime(true);
  • 看全部音轨所有事件:$decoder->dumpWithTime(false);

扩展可选

如果你后续需要,我可以再加:

  1. 导出鼓点数组 [['time'=>0.5, 'note'=>36, 'vel'=>90],...] 直接存入数据库
  2. 过滤掉 vel=0 的NoteOn(MIDI标准里vel=0等价NoteOff,很多谱会这么写)
  3. 输出JSON

PHP MIDI 文件解码器(读取 .mid,解析MThd/MTrk、VLQ、事件)

说明:PHP 7.4+ 可用,仅解析 MIDI 1.0 标准文件,支持读取文件头、多音轨、VLQ变长整数解码、MIDI事件、Meta事件。
不做音频渲染,只解析MIDI二进制指令,刚好适配你电鼓MIDI分析需求。
<?php
class MidiDecoder
{
    public string $raw;
    public int $ptr = 0;
    public array $header = [];
    public array $tracks = [];

    public function loadFile(string $filePath): bool
    {
        if (!is_file($filePath)) return false;
        $this->raw = file_get_contents($filePath);
        $this->ptr = 0;
        return $this->parseHeader();
    }

    // 读取N字节,大端
    protected function readBig(int $bytes): int
    {
        $bin = substr($this->raw, $this->ptr, $bytes);
        $this->ptr += $bytes;
        $unpack = unpack('N', str_pad($bin, 4, chr(0), STR_PAD_LEFT));
        return $unpack[1];
    }

    // VLQ 变长整数解码(MIDI核心编码)
    protected function readVLQ(): int
    {
        $val = 0;
        while (true) {
            $b = ord($this->raw[$this->ptr++]);
            $val = ($val << 7) | ($b & 0x7F);
            if (($b & 0x80) === 0) break;
        }
        return $val;
    }

    // 解析文件头 MThd
    protected function parseHeader(): bool
    {
        $id = substr($this->raw, $this->ptr, 4);
        $this->ptr += 4;
        if ($id !== 'MThd') return false;

        $len = $this->readBig(4);
        $fmt = $this->readBig(2);
        $trackCount = $this->readBig(2);
        $tpqn = $this->readBig(2);

        $this->header = [
            'format' => $fmt,
            'track_count' => $trackCount,
            'tpqn' => $tpqn
        ];

        // 解析全部音轨 MTrk
        for ($t = 0; $t < $trackCount; $t++) {
            $this->parseTrack();
        }
        return true;
    }

    // 解析单条MTrk音轨
    protected function parseTrack()
    {
        $id = substr($this->raw, $this->ptr, 4);
        $this->ptr +=4;
        $trackLen = $this->readBig(4);
        $trackEnd = $this->ptr + $trackLen;

        $events = [];
        $runningStatus = 0;

        while ($this->ptr < $trackEnd) {
            $delta = $this->readVLQ();
            $byte = ord($this->raw[$this->ptr]);

            // Running Status复用
            if (($byte & 0x80) === 0) {
                $status = $runningStatus;
            } else {
                $status = $byte;
                $runningStatus = $byte;
                $this->ptr++;
            }

            $type = ($status >> 4) & 0x0F;
            $ch = $status & 0x0F;

            if ($status === 0xFF) {
                // Meta事件 FF
                $metaType = ord($this->raw[$this->ptr++]);
                $metaLen = $this->readVLQ();
                $metaData = substr($this->raw, $this->ptr, $metaLen);
                $this->ptr += $metaLen;
                $events[] = [
                    'delta' => $delta,
                    'type' => 'meta',
                    'meta_type' => $metaType,
                    'data' => $metaData
                ];
            } elseif ($status === 0xF0 || $status === 0xF7) {
                // SysEx系统独占事件
                $sysexLen = $this->readVLQ();
                $data = substr($this->raw, $this->ptr, $sysexLen);
                $this->ptr += $sysexLen;
                $events[] = [
                    'delta' => $delta,
                    'type' => 'sysex',
                    'status' => $status,
                    'data' => $data
                ];
            } else {
                // MIDI通道事件 NoteOn / NoteOff / CC / ProgramChange
                switch ($type) {
                    case 0x9: // Note On
                        $note = ord($this->raw[$this->ptr++]);
                        $vel = ord($this->raw[$this->ptr++]);
                        $events[] = [
                            'delta' => $delta,
                            'type' => 'note_on',
                            'ch' => $ch,
                            'note' => $note,
                            'vel' => $vel
                        ];
                        break;
                    case 0x8: // Note Off
                        $note = ord($this->raw[$this->ptr++]);
                        $vel = ord($this->raw[$this->ptr++]);
                        $events[] = [
                            'delta' => $delta,
                            'type' => 'note_off',
                            'ch' => $ch,
                            'note' => $note,
                            'vel' => $vel
                        ];
                        break;
                    case 0xB: // CC控制器
                        $ccNum = ord($this->raw[$this->ptr++]);
                        $val = ord($this->raw[$this->ptr++]);
                        $events[] = [
                            'delta' => $delta,
                            'type' => 'cc',
                            'ch' => $ch,
                            'cc' => $ccNum,
                            'value' => $val
                        ];
                        break;
                    case 0xC: // Program Change 音色切换
                        $prog = ord($this->raw[$this->ptr++]);
                        $events[] = [
                            'delta' => $delta,
                            'type' => 'program',
                            'ch' => $ch,
                            'program' => $prog
                        ];
                        break;
                    case 0xE: // 弯音
                        $b1 = ord($this->raw[$this->ptr++]);
                        $b2 = ord($this->raw[$this->ptr++]);
                        $pitch = ($b2 <<7) | $b1;
                        $events[] = [
                            'delta' => $delta,
                            'type' => 'pitch',
                            'ch' => $ch,
                            'value' => $pitch
                        ];
                        break;
                    default:
                        // 其他未实现事件,跳过字节
                        $events[] = ['delta'=>$delta, 'type'=>'unknown','status'=>$status];
                        break;
                }
            }
        }
        $this->tracks[] = $events;
    }

    // 打印解析结果
    public function dump()
    {
        echo "==== MIDI HEADER ====\n";
        print_r($this->header);
        echo "\n==== TRACK COUNT: {$this->header['track_count']} ====\n";

        foreach ($this->tracks as $tkIdx => $events) {
            echo "\n--- Track #$tkIdx , total events: ".count($events)."\n";
            foreach ($events as $e) {
                echo "delta:{$e['delta']} | ";
                echo match($e['type']) {
                    'note_on' => "NOTE_ON ch{$e['ch']} note{$e['note']} vel{$e['vel']}",
                    'note_off' => "NOTE_OFF ch{$e['ch']} note{$e['note']} vel{$e['vel']}",
                    'cc' => "CC ch{$e['ch']} cc{$e['cc']} val{$e['value']}",
                    'program' => "PROGRAM ch{$e['ch']} prog{$e['program']}",
                    'meta' => "META type{$e['meta_type']} len=".strlen($e['data']),
                    'sysex' => "SYSEX",
                    default => "UNKNOWN"
                };
                echo "\n";
            }
        }
    }
}

// ========= 使用示例 =========
$decoder = new MidiDecoder();
$midFile = './test.mid'; // 替换成你的midi文件路径
if ($decoder->loadFile($midFile)) {
    $decoder->dump();
} else {
    echo "解析失败,文件不存在或者不是合法MIDI";
}
?>

功能说明

  1. VLQ 变长整数解码(MIDI最核心部分)
  2. 解析 MThd 文件头:MIDI格式、轨道数量、TPQN
  3. 解析 MTrk 音轨块,支持 Running Status 运行状态压缩
  4. 支持事件类型:

    • NoteOn / NoteOff(鼓音符,通道10打击乐)
    • CC控制器、ProgramChange音色切换、弯音
    • Meta元事件(BPM、拍号、文本、轨道结束标记)
    • SysEx系统消息
  5. 输出每条事件的 delta tick

针对你的电鼓MIDI补充

MIDI打击乐固定在 通道9(程序里ch=9,对应MIDI文档叫通道10)
鼓键映射参考:
36=底鼓Kick,38=军鼓Snare,42=闭踩镲HH Closed,46开踩镲,49叮叮镲Ride,51吊镲Crash

使用要点

  1. 保存为 midi_decode.php,把 test.mid 放到同目录
  2. 命令行执行:php midi_decode.php
  3. 大MIDI文件可以把dump打印关掉,改成存入数组做后续分析

可扩展方向(你可以按需加)

  • 把tick换算成真实时间(依靠meta事件里的BPM)
  • 过滤只输出打击乐通道ch=9事件(只提取鼓点,DTX谱分析)
  • 导出为JSON,存入数据库

MIDI 文件基础:记录什么 + 编码原理

MIDI不是音频!不存声音波形,只存「演奏指令」,这是最核心区别。

一、MIDI文件里面记录哪些信息

1. 核心事件(MIDI Event)

  1. 音符事件(Note On / Note Off)

    • Note On:按下琴键/鼓垫

      • 参数:通道(0~15)、音号(0-127,代表音高)、力度(0-127)
      • 注:力度=0的Note On等价于Note Off
    • Note Off:松开按键

      • 参数:通道、音号、释放力度
  2. 控制器事件 CC(Control Change)

    • 通道音量、声像、踩镲控制、弯音轮、表情、延音踏板等。
    • 例如CC64=延音踏板,CC10=声像,CC7=通道音量
  3. 程序改变 Program Change

    • 切换音色:比如通道1改成钢琴,通道10默认是打击乐通道(鼓组,这就是电鼓DTX用到的)
  4. 弯音 Pitch Wheel:滑音、音高偏移
  5. 通道触后、音符触后:键盘压力感应(手卷鼓一般不用)

2. 元事件(Meta Event,只存在MIDI文件,不发给硬件)

  • 节拍、BPM(速度)、拍号(4/4)、调号
  • 音轨名称、歌曲标题、版权、歌词文本
  • 时间基准(TPQN,每四分音符多少tick):决定时间分辨率,常见480tick/四分音符

3. 时间信息:Tick + Delta-time(增量时间)

MIDI不是记录绝对时间,用Delta-Time(增量tick):

两个事件之间间隔多少tick,而不是“第2秒按下音符”
tick → 根据BPM换算成真实秒数。

4. 文件结构信息

  • 音轨数量(Track):多轨MIDI可以鼓一轨、钢琴一轨分开。
  • 格式:MIDI0(单轨) / MIDI1(多轨同步,最常用) / MIDI2(多轨异步很少用)

二、MIDI文件编码(标准:MIDI 1.0,.mid二进制文件)

MIDI文件由文件头块 + 多个音轨块组成,全部是大端(Big-Endian)二进制存储。

1. 文件头块(Header Chunk)

固定结构:

4字节块标识:MThd
4字节块长度:固定00 00 00 06
2字节:MIDI格式(0/1/2)
2字节:音轨数量
2字节:时间基准 TPQN

示例十六进制:4D 54 68 64 00 00 00 06 00 01 00 02 01 E0

  • 4D546864 = ASCII MThd
  • 后面6字节:格式=1,2条音轨,TPQN=480

2. 音轨块(Track Chunk,每条音轨一个MTrk)

4字节标识:MTrk
4字节:本音轨所有事件的总字节长度
然后:一连串【Delta-Time + MIDI事件】

4D 54 72 6B = ASCII MTrk

重点:Delta-Time 编码 → 可变长度变长整数(VLQ,Variable Length Quantity)

这是MIDI最有特点的编码!

  • 1~4字节,最高位bit7作为标记
  • bit7=1:后面还有下一个字节;bit7=0:这是最后一个字节
  • 每个字节只用低7bit存数值。

举例子:
数字 0x80 (128)
拆成7bit分段:01 0000000
编码:81 00

0x81:最高位=1,低7bit=1;0x00最高位0,低7bit=0

规则:从高位往低位,每7bit一组,除最后一组外,所有字节最高位置1。

MIDI事件编码(状态字节 + 数据字节)

状态字节高4bit=事件类型,低4bit=MIDI通道(0~15)

  • 9x = Note On(x=通道),后面2字节:音号、力度
  • 8x = Note Off,后面2字节:音号、释放力度
  • Ax = 音符触后
  • Bx = CC控制器
  • Cx = Program Change(只1个数据字节,音色号)
  • Dx = 通道触后
  • Ex = 弯音(2字节)
运行状态(Running Status)优化:连续同类型同通道事件,可以省略状态字节,只写数据,减少文件体积,MIDI文件常用。

Meta元事件(FF开头)

状态字节固定0xFF,后面1字节元事件类型,1字节VLQ长度,再是内容。
例:FF 51 03 07 A1 20 → 设置BPM(微秒/四分音符)

三、简化编码流程(写一个MIDI文件的步骤)

  1. 写Header块:MThd + 长度 + 格式、轨道数、TPQN
  2. 对每一条音轨:

    1. 写入MTrk标识 + 预留长度(写完事件后回填)
    2. 遍历所有演奏事件,按时间先后排序
    3. 计算两个事件之间tick差值,用VLQ编码Delta-Time
    4. 写入事件状态+数据(使用running status压缩)
  3. 音轨结束事件:FF 2F 00(元事件:轨道结束)
  4. 回填MTrk块的长度字段

四、补充,和你电鼓相关

MIDI通道10(MIDI协议里是通道9,索引从0开始)固定打击乐通道:
每个音号对应不同鼓件:36底鼓、38军鼓、42闭踩镲、46开踩镲、49叮叮镲等。
所以DTX游戏、手卷鼓输出MIDI,就是输出Note On/Note Off到通道10。

五、举最小样例(极简MIDI示意)

四分音符TPQN=480,一个C4音符按下再松开。

  1. DeltaTime=0,NoteOn 通道1,音号60,力度100
  2. DeltaTime=480,NoteOff 通道1,音号60,力度80

Yii2 内置全部常用缓存依赖

1. FileDependency 文件依赖

yii\caching\FileDependency
原理:校验文件最后修改时间,文件改动则缓存失效。
适用:配置文件、静态模板、json元数据。

use yii\caching\FileDependency;

$query->cache(60, new FileDependency([
    'fileName' => '@config/menu.json'
]))

2. ExpressionDependency PHP表达式依赖

yii\caching\ExpressionDependency
原理:每次读取缓存,执行一段PHP表达式;返回值变化,缓存失效。
适用:自定义逻辑,比如读取Redis里的版本号、全局配置版本。

use yii\caching\ExpressionDependency;

$query->cache(0, new ExpressionDependency([
    'expression' => 'Yii::$app->redis->get("global_version")'
]));

3. TagDependency 标签依赖(业务开发最推荐)

yii\caching\TagDependency
原理:缓存打上标签;不需要自动检测,代码手动根据标签批量清除缓存。

你当前统计count场景非常适合这个,比DbDependency少一条额外SQL。

示例:

use yii\caching\TagDependency;

// 写入缓存,绑定标签 estate-{$merchantId}
$count = PropertyCommunity::find()
    ->where(['estate_id' => $merchantId])
    ->cache(0, new TagDependency([
        'tags' => ["estate:{$merchantId}"]
    ]))
    ->count();

// 新增/修改/删除数据后,一行代码清空该标签下所有缓存
TagDependency::invalidate(Yii::$app->cache, ["estate:{$merchantId}"]);

优点:读缓存时不会额外执行SQL;缺点:数据变更需要手动调用 invalidate。

4. ChainedDependency 组合依赖

yii\caching\ChainedDependency
原理:组合多个依赖,任意一个依赖触发变更 → 缓存失效。

use yii\caching\ChainedDependency;

new ChainedDependency([
    'dependencies' => [
        new FileDependency(['fileName'=>'@config/conf.json']),
        new TagDependency(['tags'=>['estate:1001']])
    ]
]);

5. DbQueryDependency(DbDependency升级版)

yii\caching\DbQueryDependency
接收 QueryInterface 对象,而不是原生SQL字符串,支持参数绑定,防SQL注入。

use yii\caching\DbQueryDependency;
use yii\db\Query;

new DbQueryDependency([
    'query' => (new Query())
        ->select('MAX(updated_at)')
        ->from('property_community')
        ->where(['estate_id' => $merchantId])
]);

选型对比(结合你的项目)

依赖读缓存额外SQL触发方式适合场景
DbDependency✅ 每次读执行1条SQL自动检测SQL结果低并发,不想手动清缓存
DbQueryDependency✅ 同上自动检测Query结果同上,推荐替代DbDependency
TagDependency❌ 无额外SQL代码手动清除标签高并发统计count,优先选这个
FileDependency❌文件修改时间配置文件
ExpressionDependency❌php表达式返回值Redis版本号、自定义变量
ChainedDependency看子依赖任一子依赖变更多条件组合

重点建议

你现在 PropertyCommunity count统计:优先 TagDependency。
理由:
DbDependency每次访问count都会额外跑一条MAX(updated_at),并发上来会增加数据库压力;TagDependency在新增/删除数据时手动 invalidate 标签,读的时候没有额外开销。