ZMDX Player

ZMDX Player 是什么

ZMDX Player（原“MDX Flow”）是一款 macOS 与 iPhone 专用的音乐播放器，用于播放夏普 X68000 的 MDX 与 Z-MUSIC 乐曲。它通过本产品自主开发的驱动与芯片模拟器，合成并播放 YM2151（OPM）FM 音源，以及采样库（PDX / ZPD）中的 ADPCM（PCM）采样。

• 完全没有任何广告。
• MDX 的播放及围绕它的全部功能均免费。
• Z-MUSIC 的播放为一次性买断的附加项目。 购买前也可以用你自己的乐曲试听每首曲子的前 20 秒。支持家人共享。
• 献给热爱复古电脑音乐的你：在今天的 Mac 与 iPhone 上，忠实而轻快地还原当年的声音。

术语说明 — X68000：夏普于 1980 年代末至 90 年代推出的个人工作站。MDX：其代表性的音乐格式。PDX：MDX 乐曲所引用的采样（PCM 音色）库。Z-MUSIC：X68000 另一种代表性的音乐驱动／格式。ZPD：Z-MUSIC 所引用的采样库。YM2151（OPM）：当年的 FM 音源芯片。ADPCM／PCM：处理录音波形的音频方式。芯片音乐（chiptune）：用这类音源芯片制作的音乐。响度（LUFS）：接近人耳听感的音量单位。

主要特性

• 自有播放引擎 — YM2151（OPM）FM 音源与采样库的 ADPCM（PCM），由自主开发的 MDX 驱动与自主开发的 OPM 模拟器播放（数值以芯片数据手册为基准校准）。
• 同时支持 MDX 与 Z-MUSIC — 除已编译的 .zmd 之外，还可直接播放 MML 源码（.z3s / .zms），无需另行编译。
• 直接从云端读取 — 可从 iCloud Drive 及“文件”中的各类存储直接打开乐曲。
• 文件夹／播放列表视图 — 循环滚动（跑马灯）标题显示，以及钢琴键盘可视化。
• 搜索 — 按标题／文件名筛选，支持词与词的 AND、“短语”与排除。全角半角与大小写均不区分。
• 曲内循环 — 可按次数（macOS 为 1～9 / iPhone 为 1～99）或无限（∞）重复乐曲自身的循环点。列表还会以“前奏 + 次数 × 循环 + 尾奏”预测播放时长。
• 响度标准化（可选，默认关闭） — 以 EBU R128（BS.1770）测量，抑制各曲之间的音量差。初始状态为关闭。 开启后可选择目标值（Apple Music −16 LUFS〔默认〕／ ReplayGain −18 LUFS ／ YouTube · Spotify −14 LUFS）。
• PCM 音质 — 初始状态即真机原声。如有需要，可用孔径补偿仅补回 D/A 转换所损失的高频。播放过程中即可切换。
• PDX / ZPD 检查 — 在整个资料库中列出那些因无法加载采样库而导致 PCM 静音的乐曲。
• 无障碍 — 文字大小实时调节、日语／英语实时切换，并支持 VoiceOver。
• Now Playing 联动 — 支持控制中心／锁屏／菜单栏的播放信息与操作。

支持的文件与打开方式

支持的文件

扩展名	说明
.mdx	MDX 乐曲文件
.mdx.szip	压缩后的 MDX 文件
.pdx	MDX 所引用的采样库
.pdx.szip	压缩后的 PDX 采样库
.zmd	Z-MUSIC 乐曲文件（已编译）
.zmd.szip	压缩后的 ZMD 文件
.z3s / .zms	Z-MUSIC 的 MML 源码（由应用解释并播放）
.z3s.szip / .zms.szip	上述文件的压缩形式
.zpd	Z-MUSIC 所引用的采样库
.zpd.szip	压缩后的 ZPD 采样库

扩展名不区分大小写。请把所需的采样库（PDX / ZPD）放在 与乐曲文件相同的文件夹，或你所选择的文件夹内。

打开方式

• macOS：将乐曲文件或包含乐曲文件的文件夹拖放到窗口中。也可用 Command-O 从标准文件选择界面打开。
• iPhone：通过文件选择器（Document Picker），从 iCloud Drive 或各类云存储读取乐曲文件与文件夹。
• .mdx、.pdx、.zmd、.zpd、.z3s、.zms 已与应用建立关联。在“访达”或“文件”中双击／双点即可直接打开。
• 若找不到某首乐曲所需的采样库（PDX / ZPD），应用会显示缺失的文件名。请把正确的采样库放到与乐曲相同的位置，或所选文件夹内。
• 你还可以在设置的「PDX / ZPD」中，以列表查看那些无法加载所引用采样库（即未与采样库关联）的乐曲。缺失的采样库名称会按文件与文件夹归类显示，便于你集中、高效地一并修正。

Z-MUSIC 支持

ZMDX Player 现已支持 X68000 另一种代表性的音乐格式 Z-MUSIC。

• 除已编译的 .zmd 之外，还可直接播放 MML 源码（.z3s / .zms），无需事先编译。
• 使用 PCM 的乐曲，请把对应的 .zpd 采样库放在同一文件夹内。
• Z-MUSIC 的播放为一次性买断的附加项目（App 内购买／非消耗型）。一次购买后，同一 Apple 账户下的 Mac 与 iPhone 均可使用。
• 即便尚未购买，也可以试听每首曲子真实的前 20 秒（播放 20 秒后，用 5 秒淡出）。响起的是你自己的文件，而非演示曲。
• 这不影响 MDX。MDX 无需购买即可使用全部功能。

使用指南（播放操作）

• macOS 键盘：Space 播放／暂停。列表还支持“访达”风格的键盘操作。
• 在播放区域（macOS）／走带条（iPhone）中，可进行播放／暂停、前后切换、定位、调节音量，以及切换重复／随机。
• 通过 Now Playing（控制中心／锁屏／菜单栏）也可进行播放／暂停与前后切换。

搜索的用法

在文件夹、播放列表的搜索框中，可使用以下语法。

• 词 — 显示包含该词的项目（多个词需全部包含＝AND 条件）。
• “两个及以上的词” — 用引号括起，按含空格的连续匹配进行搜索（短语）。
• -词 — 显示不包含该词的项目（排除）。
• -“短语” — 显示不包含该短语的项目。

全角／半角（包括字母数字与假名的浊点、半浊点）不予区分，大小写也不予区分（例如全角“Ｓtar”可匹配“star”）。文件夹名也在搜索范围内。标题搜索使用元数据缓存，若要把尚未显示过的乐曲也纳入范围，请在设置中启用预扫描（或在 iPhone 启用“预先下载云端文件”）。按文件名搜索则始终可用。

曲内循环与重复的区别

• 曲内循环：重复乐曲内部所带的循环点。可设置次数（macOS 为 1～9 / iPhone 为 1～99）或无限（∞）（macOS 在播放区域，iPhone 在设置内）。∞ 仅对带有曲内循环点的乐曲无限重复；没有循环点的乐曲会进入下一曲。
• 重复／随机：在播放列表或文件夹内跨乐曲的重复／随机播放。它与曲内循环是不同的设置。
• 通过循环次数与淡出设置，可调整一首乐曲重复几次后进入下一曲，或是否淡出。

音质与响度

PCM 音质

• 初始状态为无插值（关闭）——未经处理的阶梯状输出。X68000 无论在电路板上还是芯片（MSM6258V）内部都没有重建低通滤波器，因此阶梯状波形会原样送达扬声器。这正是最接近真机的声音。
• 孔径补偿（可选）——仅把 D/A 转换的阶梯本身所带来的高频衰减（在源采样率的奈奎斯特频率处为 −3.9 dB），按其已知特性反转补回。并非凭空添加声音，因此噪声不会增加。在播放过程中也可即时切换。
• 咔哒噪声抑制（可选，默认关闭）——抑制采样末端出现的咔哒声（自下一首乐曲起生效）。

响度

• 响度标准化在初始状态下为关闭。 在设置中启用后，会以 EBU R128（BS.1770） 测量每首乐曲的响度，并统一到你所选择的目标响度，从而抑制各曲之间的音量差。
• 启用后，目标可在 Apple Music（−16 LUFS，默认）／ ReplayGain（−18 LUFS）／ YouTube · Spotify（−14 LUFS） 中选择。
• 还提供将小音量乐曲也提升至目标（带峰值限制）的选项。
• 同时支持曲间间隔、重复与随机。

设备与同步（iCloud）

• 若你使用 iCloud，应用的元数据缓存（乐曲的解析结果）会同步到你的私有 iCloud（由 Apple 管理）；我们无法访问。
• 社区元数据共享默认关闭（opt-in）。 开启后本应用仅共享乐曲文件的哈希（整个文件的 SHA-256）、基本曲目元数据（曲目标题、时长、响度、曲内循环点）以及随机生成的应用内标识符。绝不共享音乐文件本体、文件名、文件夹或其他个人信息。可随时关闭。
• 开启共享后发送的随机生成的应用内标识符，是与你的个人信息无关联的随机值。它仅用于按“每台设备一条”计数，以防止社区中位数被恶意操纵，绝不用于跟踪。该值因设备而异，不与其他应用或其他设备共享。删除应用即会丢失，但从设备备份恢复时会取回同一个值。
• 即使关闭共享，只要本地缺少曲目信息（响度、时长、曲内循环点或曲目标题），应用也会为查询该曲而发送乐曲文件的哈希。哈希用作查询键，上述元数据会随响应返回（本地已有的数值不会被覆盖）。该查询独立于共享设置运行，关闭共享也不会停止。 此时离开设备的只有哈希，绝不包含曲目标题、文件名或应用内标识符。
• 共享与查询的发送目标均为 Apple 的 CloudKit 公共数据库。该公共数据库并非仅限本公司读取，任何人都可读取，因此请将你共享的内容视为公开信息。本公司没有自有服务器，也不保存访问日志。
• 你共享的记录上，Apple 会自动附加「创建者 ID」。 该值源自你的 iCloud 账户。它不是由本公司发送的，但任何能读取该公共数据库的人都能看到。这个 ID 在你删除应用后也不会改变，同一 iCloud 账户的其他设备上也是同一个值。
• 该 ID 仅在本应用自身的范围内有意义，无法与其他应用的标识符相互比对。没有任何途径可以由它追溯到姓名或电子邮件地址，本公司同样做不到。 但来自同一账户的共享投稿，会被看作同一组。另外，关闭共享时的查询不会写入记录，因此不会留下该 ID，第三方也看不到。

价格与支持

价格

• 应用可免费下载，且在所有平台上都完全没有广告。
• MDX 的播放及围绕它的全部功能（资料库、搜索、循环、响度、音质、键盘可视化、iCloud、无障碍）均免费，无需任何购买。
• 仅 Z-MUSIC 的播放为一次性买断的附加项目（非消耗型；一次购买即可用于 Mac 与 iPhone）。购买前可试听每首曲子真实的前 20 秒。具体价格请在 App Store 确认。

Tip Jar（支持开发）

• 你可以通过可选的 Tip Jar（打赏） 支持开发。购买不会解锁任何功能——它与 Z-MUSIC 附加项目是两回事。
• 档位为 $5 / $10 / $20 / $50 / $100（价格以你所在地区 App Store 的货币显示）。

隐私

ZMDX Player 不跟踪、不做使用分析、不含广告 SDK。无论如何设置，你的音乐文件本体、文件名、文件夹、播放历史与使用情况都不会被发送。本地文件夹或 Document Provider 上的文件，均通过操作系统的文件访问机制处理。

离开设备的只有以下两项。

1. 曲目信息查询——无论共享设置如何都会运行。 当本地缺少曲目信息（响度、时长、曲内循环点或曲目标题）时，应用会发送乐曲文件的哈希（整个文件的 SHA-256）以识别该曲。仅发送哈希，绝不发送曲目标题、文件名或应用内标识符。关闭共享也不会停止该查询。
2. 社区元数据共享——默认关闭（opt-in）。 仅在你开启后，本应用才会发送乐曲文件的哈希、乐曲的标题、时长、响度与曲内循环点、随机生成的应用内标识符（仅用于防止社区中位数被恶意操纵，绝不用于跟踪），以及测量与解析所用算法的版本号（用于避免新版本采用旧版本的数值，绝不用于识别设备或个人）。关闭该设置即可停止此项发送。

两者的发送目标均为 Apple 的 CloudKit 公共数据库，并非仅限本公司读取，任何人都可读取。本公司没有自有服务器，也不保存访问日志。 第 2 项的投稿上，Apple 会自动附加「创建者 ID」（源自你的 iCloud 账户。并非本公司发送，但能读取的人都看得到；删除应用后不变，同一账户的其他设备上也相同）。该 ID 仅在本应用自身的范围内有意义，也没有任何途径可以由它追溯到姓名或电子邮件地址（本公司同样做不到），但来自同一账户的投稿会被看作同一组。第 1 项的查询不写入记录，因此不会留下该 ID。公共数据库中只有上面列出的这些项目，不包含姓名、电子邮件地址、音乐文件本体、文件名和播放记录。已共享的信息没有约定的保存期限，并且目前应用内没有可供你删除已共享信息的方式。由于本公司无法将应用内标识符与你本人关联，即使你与我们联系，我们也无法定位到你的记录。关闭共享后，后续的投稿会停止。

上述发送在 App Store 的隐私标签中申报为未与你关联的数据（设备ID与其他数据，用途为应用功能）。

常见问题

问：乐曲能响，但有部分声音缺失／没有 PCM（鼓等）。 答：可能未找到该乐曲所需的采样库（PDX / ZPD）。应用会显示缺失的文件名，请把对应的采样库放到与乐曲相同的文件夹，或所选文件夹内（扩展名不区分大小写）。你还可以在设置的「PDX / ZPD」中列出未与采样库关联的乐曲，并一并放置／修正。

问：能播放哪些文件？ 答：MDX（.mdx）与 Z-MUSIC（.zmd，以及 MML 源码 .z3s / .zms）乐曲、它们所引用的采样库 .pdx / .zpd，以及各自的压缩形式 .szip。

问：不购买就听不了 Z-MUSIC 的乐曲吗？ 答：即便尚未购买，也可以试听每首曲子真实的前 20 秒（播放 20 秒后用 5 秒淡出）。响起的是你自己的文件，而非演示曲。完整播放需要一次性买断的附加项目。

问：.z3s 与 .zms 需要先编译吗？ 答：不需要。应用会直接解释 MML 源码并播放。

问：付费后能解锁什么？ 答：付费分为两种，性质不同。Z-MUSIC 播放附加项目（一次性买断）会解锁 Z-MUSIC 乐曲的完整播放。Tip Jar（打赏）用于支持开发，购买不会解锁任何功能。另外，MDX 的播放及相关功能全部免费，两种购买都不需要。

问：PCM 会有“咔哒”声。 答：3.0.1 已解决。我们已查明并修复了发音首尾出现咔哒声的原因，请更新到最新版本。

问：会显示广告吗？ 答：不会。完全没有任何广告（所有平台均如此）。

问：我的乐曲文件或数据会被发送吗？ 答：不跟踪、不做使用分析。 无论如何设置，你的音乐文件本体、文件名与播放历史都不会被发送。离开设备的只有两项：(1) 为查询本地缺少的曲目信息而发送的乐曲文件的哈希，这无论共享设置如何都会发送，关闭共享也不会停止；(2) 开启社区元数据共享（默认关闭）后才会发送的哈希、乐曲标题、时长、响度、曲内循环点以及随机生成的应用内标识符。(2) 关闭后即停止。两者的发送目标均为任何人都可读取的 Apple CloudKit 公共数据库。 包括创建者 ID 在内的详细说明，请参见上面的「隐私」。

问：iPhone 与 Mac 之间会同步吗？ 答：若你使用 iCloud，应用的元数据缓存会同步到你的私有 iCloud。

问：有些乐曲按标题搜不到。 答：标题搜索使用元数据缓存，因此尚未打开（显示）过的乐曲可能无法按标题命中。在设置中启用预扫描，或在 iPhone 启用“预先下载云端文件”，即可扩大覆盖范围。按文件名搜索则始终可用。

问：我设成了“无限循环”，但还是进入了下一曲。 答：曲内循环（∞）仅对内部带有循环点的乐曲无限重复。没有循环点的乐曲会进入下一曲（这与播放列表的“重复”是不同的设置）。

问：在哪些系统上可运行？ 答：支持 macOS 14 Sonoma 及以上与 iOS 17 及以上。

运行环境

• 系统：macOS 14 Sonoma 及以上 / iOS 17 及以上
• 支持的设备：Mac / iPhone
• 分发：App Store（免费下载＋App 内购买）
• 界面语言：日语 / 英语（可在应用内切换）

关于文件权利

请仅播放你拥有权利、或已获得授权使用的 MDX / PDX / Z-MUSIC（ZMD、Z3S、ZMS、ZPD） 文件。