Папка 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 — кожна з яких містить більше папок точно такої ж структури.

Ця структура повторюється aж до найнижчого рівня: набір містить пісні, пісня містить вкладення, і кожна — це папка зі своїм маніфестом поряд зі своїми файлами. Папка, що містить книгу з двохсот пісень, має той же формат, що й папка з одним чартом.

Усередині маніфесту посилання на дочірні елементи позначаються префіксом $binder., тому читач може розрізнити значення, яке належить елементу, та те, яке вказує на папку поряд з ним.

Що він містить

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

Папка чи архів?

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

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

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

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

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

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

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