OnSong^® 活页夹

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

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

内部结构

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

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

该结构一直向下重复：套曲包含歌曲，歌曲包含附件，每个都是一个带有自己的 manifest 和自己文件的文件夹。包含两百首歌曲的书的 Binder 与包含单个乐谱的 Binder 格式相同。

在 manifest 内部，对子项的引用标记有 $binder. 前缀，因此读者可以区分属于项的值和指向其旁边文件夹的值。

它包含的内容

• 歌曲 — 和弦图表及其附带的一切。
• 套曲 — 按顺序排列的歌曲，以及套曲自己的编排。
• 书 — 整个集合。
• 附件 — PDF、图像、音频及任何与歌曲关联的其他文件。你可以选择仅包括实际使用的附件，而不是曾添加的每个版本。

Binder 还是 Archive？

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

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

导入和导出

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

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

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

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