OnSong^® Binder

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

Імпорт та експорт

Папки імпортуються як і будь-який інший файл: відкрийте один з програми Файли, Пошта, AirDrop або хмарної служби та виберіть OnSong. Імпорт папки, яка містить набір, перестворює набір і кожну пісню в ньому; імпорт папки, яка містить одну пісню, додає цю пісню.

Щоб створити один, скористайтеся Поділитися та виберіть OnSong Binder як формат.

Папки також те, що OnSong Connect надсилає між пристроями, коли один пристрій просить у іншого пісню або набір, тому той самий формат, який живе у вашій програмі Файли, — це той, який подорожує по мережі.

Оскільки папка — це ZIP простого JSON та звичайних медіа-файлів, це правильний формат, до якого слід звертатися, коли вам потрібно побачити, що насправді зберіг OnSong — або коли щось повинне прочитати ваш вміст, і це не OnSong.