מדריך המשתמש
קלסר OnSong®
פורמט הקובץ OnSong® Binder הוא הדרך שבה OnSong מעביר שיר, סט, או ספר שלם בין ספריות. כמו OnSong® Archive, הוא נושא הכל שנחוץ כדי לשחזר את התוכן במקום אחר — טקסט השיר, קבצים צמודים, סגנונות, הגדרות, טרנספוזיציה והערות — אבל כאשר ארכיון הוא blob אטום יחיד, binder הוא תיקייה של קבצים רגילים. זה הופך אותו לקריא, בדיקה, ויכול לנשוא את המדיה שעליה שיר תלוי לצד השיר עצמו בדרך ניטרלית לפלטפורמה.
פורמט הקובץ OnSong® Binder כולל סיומת קובץ של .onsongbinder או .binder, וסוג MIME של application/onsong-binder.
מה בתוכו
binder הוא ארכיון ZIP. פתח ZIP אחד ותמצא תיקייה בשם מזהה הפריט, המכילה:
manifest.json— הפריט עצמו, מסודר. כל תכונה שOnSong יודע עליה, באותה צורה שה-API האינטרנט של OnSong משתמש בה.- הקובץ שלו, אם יש לו אחד. קובץ צמוד שומר על שם הקובץ המקורי שלו, כך ש-PDF או MP3 בתוך binder הוא פשוט ה-PDF או MP3 הזה.
- תיקיות לילדיו שלו, בשם מה שהם —
songs,attachments— כל אחד מכיל יותר תיקיות בדיוק באותה צורה.
המבנה הזה חוזר על עצמו כל הדרך למטה: סט מכיל שירים, שיר מכיל קבצים צמודים, וכל אחד הוא תיקייה עם manifest משלו לצדו של הקבצים שלו. binder שמחזיק ספר של מאתיים שירים הוא באותו פורמט כמו אחד שמחזיק תרשים יחיד.
בתוך manifest, הפניות לילדים מסומנות בקידומת $binder., כך שקוראה יכול להבחין בהבדל בין ערך השייך לפריט לבין ערך שמצביע לתיקייה לצדו.
מה הוא נושא
- שירים — תרשים האקורדים והכל המצורף אליו.
- סטים — השירים בסדרם, עם הסידור שלו של הסט.
- ספרים — אוסף שלם.
- קבצים צמודים — PDFs, תמונות, אודיו, וכל קובץ אחר הקשור לשיר. אתה יכול לבחור לכלול רק את הקבצים הצמודים שהם בעצם בשימוש ולא כל גרסה שנוספה אי פעם.
Binder או Archive?
שניהם סובבים בעלילה בנאמנות את התוכן של ספריה, כך שהבחירה היא לגבי מה שאתה צריך מהקובץ:
- OnSong® Archive הוא הפורמט הישן יותר, וזה מה שצריך להשתמש בו לתאימות עם גרסאות קודמות של OnSong.
- OnSong® Binder הוא הנוכחי. השתמש בו כדי לשתף עם גרסאות חדשות יותר של OnSong — וכאשר אתה רוצה קובץ שתוכל לפתוח ולהסתכל בתוכו.
ייבוא וייצוא
Binders מיובאים בדרך שכל קובץ אחר עושה: פתח אחד מקבצים, דוא״ל, AirDrop, או שירות ענן ובחר OnSong. ייבוא binder שמחזיק סט משחזר את הסט וכל שיר בו; ייבוא של אחד שמחזיק שיר יחיד מוסיף את השיר הזה.
כדי ליצור אחד, השתמש שתף ובחר OnSong Binder כפורמט.
Binders הם גם מה שOnSong Connect שולח בין מכשירים כאשר מכשיר אחד שואל למכשיר אחר על שיר או סט, כך שאותו פורמט שחי בתיקיית הקבצים שלך הוא זה שנוסע על פני הרשת.
מכיוון ש-binder הוא ZIP של JSON פשוט וקבצי מדיה רגילים, זה הפורמט הנכון להגיע אליו כאשר אתה צריך לראות מה OnSong בעצם אחסן — או כאשר משהו צריך לקרוא את התוכן שלך וזה לא OnSong.