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

Імпортування та експортування

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

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

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

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