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.