Папка 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.