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

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

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

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

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

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