OnSong^® 活页夹

OnSong^® Binder 文件格式是 OnSong 在库之间移动歌曲、曲目集或整本歌本的方式。与 OnSong^® Archive 一样，它携带重建内容所需的一切——歌词文本、附件、样式、设置、移调和注释——但与存档是单个不透明的二进制文件不同，Binder 是一个普通文件的文件夹。这使其易于阅读、检查，并能以平台无关的方式携带歌曲所依赖的媒体。

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

内部结构

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

• manifest.json — 项目本身，已序列化。OnSong 知道的每个属性，格式与 OnSong web API 使用的形状相同。
• 它的文件（如果有的话）。附件保留其原始文件名，因此 Binder 中的 PDF 或 MP3 就是那个 PDF 或 MP3。
• 其子项的文件夹，以其名称命名——songs、attachments——每个文件夹中包含更多具有完全相同结构的文件夹。

这个结构一直重复下去：曲目集包含歌曲，歌曲包含附件，每个都是一个文件夹，其旁边有自己的清单和自己的文件。包含两百首歌曲的歌本的 Binder 与包含单个乐谱的 Binder 格式相同。

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

携带的内容

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

Binder 还是 Archive？

两者都能忠实地往返库的内容，所以选择取决于你对文件的需求：

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

导入和导出

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

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

Binder 也是 OnSong Connect 在设备之间发送的格式，当一个设备向另一个设备请求歌曲或曲目集时会使用，因此驻留在你 Files 应用中的格式与在网络上传输的格式相同。

由于 Binder 是普通 JSON 和普通媒体文件的 ZIP，当你需要查看 OnSong 实际存储了什么——或者当某些东西需要读取你的内容而不是 OnSong 时——这是正确的格式。