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 时，这是合适的格式。