Папка 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.