OnSong^® Папка

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