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 — каждая содержит дополнительные папки в точно такой же структуре.

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

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

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

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

Binder или Archive?

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

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

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

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

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

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

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