OnSong^® 活页夹

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

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

内部结构

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

• manifest.json — 项目本身的序列化形式。OnSong 知道的每个属性，采用 OnSong web API 使用的相同结构。
• 其文件（如果有的话）。附件保留其原始文件名，所以活页夹中的 PDF 或 MP3 就是那个 PDF 或 MP3。
• 其子项的文件夹，按其类型命名 — songs、attachments — 每个都包含完全相同结构的更多文件夹。

这种结构从上到下重复：歌单包含歌曲，歌曲包含附件，每个都是一个文件夹，旁边有自己的清单和文件。包含两百首歌曲的书籍活页夹的格式与包含单个乐谱的活页夹相同。

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

它包含的内容

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

活页夹还是存档？

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

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

导入和导出

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

要创建一个活页夹，使用分享并选择 OnSong 活页夹 作为格式。

活页夹也是 OnSong Connect 在设备之间发送内容的格式——当一台设备向另一台设备请求歌曲或歌单时——因此存在于你的文件应用中的相同格式就是在网络上传输的格式。

因为活页夹是纯 JSON 和普通媒体文件的 ZIP，当你需要查看 OnSong 实际存储的内容时——或者当某些程序需要读取你的内容而它不是 OnSong 时——这是正确的格式。