OnSong^® Binder

פורמט קובץ ה‑OnSong^® Binder הוא האופן שבו OnSong מעביר שיר, סט או ספר שלם בין ספריות. כמו ה‑OnSong^® Archive, הוא מכיל את כל מה שנדרש כדי לשחזר את התוכן במקום אחר — טקסט השיר, קבצים מצורפים, סגנונות, הגדרות, טרנספוזיציה והערות — אך כאשר ארכיון הוא blob אטום יחיד, binder הוא תיקייה של קבצים רגילים. זה הופך אותו לקריא, בדיקה, וככל לשאת את המדיה שעליה שיר תלוי לצד השיר עצמו בצורה בלתי תלויה בפלטפורמה.

פורמט קובץ OnSong^® Binder כולל סיומת קובץ של .onsongbinder או .binder, וסוג MIME של application/onsong-binder.

מה בפנים

binder הוא ארכיון ZIP. בעת פתיחה שלו תמצא תיקייה הנקראת על שם מזהה הפריט, המכילה:

• manifest.json — הפריט עצמו, סדור. כל תכונה שOnSong יודע עליה, באותה צורה שה‑OnSong web API משתמש בה.
• הקובץ שלו, אם יש לו אחד. קובץ מצורף שומר על שם הקובץ המקורי שלו, כך שקובץ PDF או MP3 בתוך binder הוא פשוט הPDF או MP3 הזה.
• תיקיות לילדיו שלו, הנקראות על שם מה שהם — songs, attachments — כל אחת מחזיקה תיקיות נוספות בדיוק באותה צורה.

המבנה הזה חוזר על עצמו כל הדרך למטה: סט מכיל שירים, שיר מכיל קבצים מצורפים, וכל אחד הוא תיקייה עם manifest משלו לצד הקבצים שלו. binder המחזיק ספר של מאתיים שירים הוא אותו פורמט כמו אחד המחזיק תרשים יחיד.

בתוך manifest, הפניות לילדים מסומנות בקידומת $binder., כך שקורא יכול לדעת את ההבדל בין ערך ששייך לפריט לבין ערך שמצביע לתיקייה ליד אותו פריט.

מה הוא נושא

• שירים — תרשים האקורד וכל דבר המצורף אליו.
• סטים — השירים בסדר שלהם, עם סידור ההתאמה של הסט.
• ספרים — אוסף שלם.
• קבצים מצורפים — קבצי PDF, תמונות, אודיו וכל קובץ אחר הקשור לשיר. אתה יכול לבחור בהכללת רק הקבצים המצורפים שבשימוש בפועל ולא כל גרסה שהוספה אי פעם.

Binder או Archive?

שניהם מחזירים בעקיפין תוכן של ספריה בנאמנות, כך שהבחירה היא לגבי מה שאתה צריך מהקובץ:

• OnSong^® Archive הוא הפורמט הישן יותר, וזה מה שיש להשתמש בו לתאימות עם גרסאות קודמות של OnSong.
• OnSong^® Binder הוא הגרסה הנוכחית. השתמש בו כדי לשתף עם גרסאות חדשות יותר של OnSong — וכאשר אתה רוצה קובץ שתוכל לפתוח ולהסתכל בתוכו.

ייבוא וייצוא

Binders מייבאים כמו כל קובץ אחר: פתח אחד מ‑Files, Mail, AirDrop או שירות ענן ובחר OnSong. ייבוא של binder המחזיק סט משחזר את הסט וכל שיר בו; ייבוא של אחד המחזיק שיר יחיד מוסיף את השיר הזה.

כדי ליצור אחד, השתמש ב‑Share ובחר OnSong Binder כפורמט.

Binders הם גם מה ש‑OnSong Connect שולח בין מכשירים כאשר מכשיר אחד מבקש מהשני שיר או סט, כך שאותו פורמט שחי ביישומון Files שלך הוא זה הנוסע על פני הרשת.

מכיוון שbinder הוא ZIP של JSON פשוט וקבצי מדיה רגילים, זהו הפורמט הנכון כשאתה צריך לראות מה OnSong בעצם אחסן — או כשמשהו צריך לקרוא את התוכן שלך וזה לא OnSong.