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-файли, зображення, аудіо та будь-який інший файл, пов'язаний із піснею. Ви можете вибрати включення лише вкладень, які насправді використовуються, а не кожної версії, коли-небудь доданої.

Папка або архів?

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

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

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

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

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

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

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