OnSong^® Папка

Формат файла OnSong^® Binder — это способ, которым OnSong перемещает песню, набор или целую книгу между библиотеками. Как 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 — каждая содержит больше папок точно такой же структуры.

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

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

Что он переносит

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

Binder или Archive?

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

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

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

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

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

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

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