Папка OnSong^®

Формат файла OnSong^® Binder — это способ, которым OnSong перемещает песню, сет или целую книгу между библиотеками. Как и OnSong^® Archive, он содержит всё необходимое для восстановления содержимого в другом месте — текст песни, вложения, стили, параметры, транспозицию и аннотации — но если архив представляет собой один непрозрачный блоб, то папка — это папка обычных файлов. Это делает её читаемой, проверяемой и позволяет переносить медиаконтент, от которого зависит песня, вместе с самой песней независимым от платформы способом.

Формат файла OnSong^® Binder имеет расширение .onsongbinder или .binder и тип MIME application/onsong-binder.

Содержимое

Папка — это ZIP-архив. Распакуйте его, и вы найдете папку с названием, основанным на идентификаторе элемента, содержащую:

• manifest.json — сам элемент, сериализованный. Каждое свойство, известное OnSong, в том же формате, который использует веб-API OnSong.
• Его файл, если он есть. Вложение сохраняет своё исходное имя файла, поэтому PDF или MP3 внутри папки — это просто этот PDF или MP3.
• Папки для его дочерних элементов, названные по типу — songs, attachments — каждая содержит папки точно такой же структуры.

Эта структура повторяется во всех уровнях: сет содержит песни, песня содержит вложения, и каждая — это папка со своим манифестом рядом со своими файлами. Папка, содержащая книгу из двухсот песен, имеет тот же формат, что и папка с одной партитурой.

Внутри манифеста ссылки на дочерние элементы помечены префиксом $binder., чтобы читатель мог различить значение, принадлежащее элементу, и значение, указывающее на папку рядом с ним.

Что она содержит

• Песни — аккордовую партитуру и всё, что к ней прикреплено.
• Сеты — песни в их порядке с собственной аранжировкой сета.
• Книги — целую коллекцию.
• Вложения — PDF-файлы, изображения, аудио и любые другие файлы, связанные с песней. Вы можете выбрать включение только используемых вложений, а не каждой версии, когда-либо добавленной.

Папка или архив?

Оба верно воспроизводят содержимое библиотеки, поэтому выбор зависит от того, что вам нужно от файла:

• OnSong^® Archive — более старый формат, используется для совместимости с более ранними версиями OnSong.
• OnSong^® Binder — текущий формат. Используйте его для обмена с более новыми версиями OnSong — и когда вам нужен файл, который можно открыть и изучить.

Импорт и экспорт

Папки импортируются как любые другие файлы: откройте одну из программы «Файлы», почты, AirDrop или облачного сервиса и выберите OnSong. Импорт папки, содержащей сет, воссоздает сет и каждую песню в нём; импорт папки с одной песней добавляет эту песню.

Чтобы создать папку, используйте Поделиться и выберите OnSong Binder в качестве формата.

Папки также используются в OnSong Connect для отправки между устройствами, когда одно устройство запрашивает у другого песню или сет, поэтому тот же формат, который находится в приложении «Файлы», передаётся по сети.

Поскольку папка — это ZIP-архив простого JSON и обычных медиафайлов, это правильный формат, к которому следует обратиться, когда вам нужно увидеть, что OnSong действительно сохранил — или когда что-то другое должно прочитать ваше содержимое и это не OnSong.