Папка OnSong^®

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

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

Что внутри

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

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

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

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

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

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

Binder или Archive?

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

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

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

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

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

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

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