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

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

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

Що він переносить

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

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

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

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

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

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

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

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

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