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

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

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

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

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

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