OnSong^® 活页夹

OnSong^® Binder 文件格式是 OnSong 在库之间移动歌曲、歌单或整本歌册的方式。与 OnSong^® 归档 一样，它包含重建其他地方所需的所有内容——歌词文本、附件、样式、设置、移调和注释——但不同的是，归档是单个不透明的大文件，而 Binder 是一个普通文件的文件夹。这使得它具有可读性、可检查性，并能够以平台无关的方式将歌曲所依赖的媒体与歌曲本身一起携带。

OnSong^® Binder 文件格式的文件扩展名为 .onsongbinder 或 .binder，MIME 类型为 application/onsong-binder。

内部结构

Binder 是一个 ZIP 归档文件。解压后，您会找到一个以项目标识符命名的文件夹，其中包含：

• manifest.json — 项目本身，已序列化。OnSong 已知的每个属性，采用与 OnSong 网络 API 相同的格式。
• 它的文件（如果有的话）。附件保持其原始文件名，因此 Binder 中的 PDF 或 MP3 就是该 PDF 或 MP3。
• 其子项的文件夹，按其类型命名——songs、attachments——每个文件夹中都包含相同结构的更多文件夹。

这个结构一直延伸到底层：一个歌单包含歌曲，一首歌曲包含附件，每个都是一个带有自己清单和自己文件的文件夹。包含两百首歌曲的歌册 Binder 的格式与包含单个乐谱的 Binder 相同。

在清单中，对子项的引用标记有 $binder. 前缀，因此读取器可以区分属于该项的值和指向其旁边文件夹的值。

包含内容

• 歌曲 — 和弦谱及其所有附件。
• 歌单 — 按顺序排列的歌曲，带有歌单自己的编排。
• 歌册 — 整个集合。
• 附件 — PDF、图像、音频和与歌曲关联的任何其他文件。您可以选择仅包含实际使用中的附件，而不是曾经添加过的每个版本。

Binder 还是归档？

两者都能忠实地往返库的内容，因此选择取决于您需要从文件中获得什么：

• OnSong^® 归档 是较旧的格式，用于与早期版本的 OnSong 兼容。
• OnSong^® Binder 是当前格式。将其用于与较新版本的 OnSong 共享——以及当您想要一个可以打开并查看内部内容的文件时。

导入和导出

Binder 的导入方式与任何其他文件相同：从"文件"、邮件、AirDrop 或云服务打开一个，然后选择 OnSong。导入包含歌单的 Binder 会重新创建该歌单及其中的每首歌曲；导入包含单首歌曲的 Binder 会添加该歌曲。

要创建一个，使用共享并选择 OnSong Binder 作为格式。

当一个设备向另一个设备请求歌曲或歌单时，OnSong Connect 在设备之间发送的也是 Binder，因此存在于您"文件"应用中的相同格式也是在网络上传输的格式。

由于 Binder 是纯 JSON 和普通媒体文件的 ZIP 包，当您需要查看 OnSong 实际存储的内容时，或当某些需要读取您的内容但不是 OnSong 的东西时，它是正确的格式。