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——每个文件夹都包含完全相同结构的更多文件夹。

这种结构一直重复：歌单包含歌曲，歌曲包含附件，每个项都是一个文件夹，其中有自己的 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 时——它是最合适的格式。