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

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

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

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

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

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