OnSong^® 活页夹

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

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

里面是什么

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

• manifest.json — 项目本身，已序列化。OnSong 对其了解的每一个属性，其形式与 OnSong 网络 API 使用的形式相同。
• 其文件，如果有的话。附件保留其原始文件名，因此绑定文件中的 PDF 或 MP3 就是那个 PDF 或 MP3。
• 其子项的文件夹，以其名称命名——songs、attachments——每个文件夹都包含形状完全相同的更多文件夹。

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

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

它包含什么

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

绑定文件还是存档？

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

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

导入和导出

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

要创建一个，使用共享并选择 OnSong 绑定文件作为格式。

绑定文件也是 OnSong Connect 在一个设备向另一个设备请求歌曲或歌单时在设备之间发送的内容，因此存储在你的文件应用中的相同格式是在网络上传输的格式。

由于绑定文件是普通 JSON 和常规媒体文件的 ZIP，当你需要查看 OnSong 实际存储的内容时，或者当某个东西需要读取你的内容但不是 OnSong 时，它是合适的格式。