vgmstream项目中的TXTP格式详解：音频播放的高级控制

vgmstream项目中的TXTP格式详解：音频播放的高级控制

vgmstream vgmstream - A library for playback of various streamed audio formats used in video games. 项目地址: https://gitcode.com/gh_mirrors/vg/vgmstream

什么是TXTP格式

TXTP是vgmstream项目中用于处理游戏音频的特殊文本格式，它相当于一个迷你播放列表或音频包装器，能够对可播放文件进行后处理操作。这种格式特别适合处理那些采用非标准或复杂方式组织音频的游戏资源。

基础使用方法

要使用TXTP，只需创建一个扩展名为.txtp的文件，在其中编写音频文件和相应的控制命令，然后用vgmstream直接打开这个文件即可播放。

典型应用场景

1. 连接前奏和循环段

stage01_intro.vag
stage01_loop.vag
loop_mode = auto

2. 混合声道层

bgm01_melody.hca
bgm01_vocals.hca
mode = layers

3. 播放特定子曲目

bgm01.fsb #5

4. 仅播放特定声道

field.bfstm #C3,4

TXTP播放模式详解

段模式(Segments Mode)

段模式用于处理那些将音频分割成多个完整文件段的游戏音频。例如：

BGM01_BEGIN.VAG
BGM01_LOOPED.VAG
loop_start_segment = 2

技术要点：

• 支持混合不同采样率的文件（自动使用最高采样率）
• 允许不同声道数的文件组合
• 4声道+2声道的组合效果较好，但1声道+2声道可能需要上混处理

层模式(Layers Mode)

层模式用于处理分层音频，如主旋律+人声轨道：

BGM_0_012_04.wem
BGM_0_012_07.wem
mode = layers

技术要点：

• 总声道数是所有层的总和（如三个2声道层会生成6声道文件）
• 如果所有层共享循环点，会自动保留
• 层间循环点不一致时可使用loop_mode = auto设置完整循环

混合组模式(Mixed Group Mode)

混合组模式允许在同一文件中组合段和层，适合复杂音频结构：

bgm1_intro.fsb
  bgm1_music.fsb
  bgm1_vocal.fsb
group = -L2
group = -S2
loop_mode = auto

高级命令详解

子曲目选择

bgm.sxd2#12  // 选择第12个子曲目

声道控制

music_Home.ps3.scd#C1,2  // 仅播放1和2声道

播放配置

• #L: 无限循环
• #i: 禁用循环点
• #e: 设置完整循环（仅当文件无循环点时）
• #E: 强制完整循环（覆盖原循环点）
• #F: 不淡出，继续播放原始结尾

播放时长控制

• #l(loops): 设置循环次数
• #b(time): 设置主体部分时长
• #f(fade): 设置淡出时长
• #d(delay): 设置淡出前延迟

文件修剪

intro.fsb #t -1.0  // 移除结尾1秒静音

强制循环点

bgm01.ogg #I32.231  // 从32.231秒开始循环

实际应用技巧

1. 处理多段音频时，建议先单独测试每个文件，再逐步构建复杂TXTP
2. 混合不同格式文件时，确保vgmstream能单独播放每个文件
3. 复杂音频结构可使用缩进提高可读性
4. 遇到播放问题时，尝试简化配置逐步排查

TXTP格式为游戏音频播放提供了极大的灵活性，通过合理组合各种模式和命令，可以完美还原游戏中复杂的音频结构。掌握这些技巧后，你将能够处理绝大多数游戏音频播放需求。

vgmstream vgmstream - A library for playback of various streamed audio formats used in video games. 项目地址: https://gitcode.com/gh_mirrors/vg/vgmstream