OnSong^® Папка

Формат файлу OnSong^® Binder — це спосіб, яким OnSong переміщує пісню, набір або цілу книгу між бібліотеками. Як і OnSong^® Archive, він містить усе необхідне для відновлення вмісту де-небудь ще — текст пісні, вкладення, стилі, параметри, транспозицію та анотації — але на відміну від архіву, який є одним непрозорим блобом, папка Binder містить звичайні файли. Це робить його читаним, інспектованим та здатним нести медіа, від якого залежить пісня, поруч із самою піснею незалежним від платформи способом.

Формат файлу 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.