מדריך המשתמש
קלסר OnSong®
פורמט הקובץ 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— כל אחד מחזיק תיקיות נוספות בדיוק באותה צורה.
המבנה הזה חוזר על עצמו כל הדרך למטה: סט מכיל שירים, שיר מכיל קבצים מצורפים, וכל אחד הוא תיקייה עם המניפest שלו לצד הקבצים שלו. binder המחזיק ספר של מאתיים שירים הוא אותו פורמט כמו אחד המחזיק תרשים יחיד.
בתוך מניפest, הפניות לילדים מסומנות עם קידומת $binder., כך שקורא יכול להגיד את ההבדל בין ערך השייך לפריט ואחד המצביע לתיקייה לצדו.
מה הוא נושא
- שירים — תרשים הקורדים והכל המצורף אליו.
- סטים — השירים בסדרם, עם הסדר של הסט.
- ספרים — אוסף שלם.
- קבצים מצורפים — PDFs, תמונות, אודיו וכל קובץ אחר הקשור לשיר. אתה יכול לבחור לכלול רק את הקבצים המצורפים שנמצאים בשימוש בפועל ולא כל גרסה שנוספה אי פעם.
Binder או Archive?
שניהם עושים round-trip לתוכן הספריה בנאמנות, כך שהבחירה עוסקת בזה שאתה צריך מהקובץ:
- OnSong® Archive הוא הפורמט הישן יותר, וזה מה שיש להשתמש בו לתאימות עם גרסאות קודמות של OnSong.
- OnSong® Binder הוא הנוכחי. השתמש בו לשיתוף עם גרסאות חדשות יותר של OnSong — וכאשר אתה רוצה קובץ שתוכל לפתוח ולהסתכל בתוכו.
ייבוא וייצוא
Binders מייבאים את הדרך שכל קובץ אחר עושה זאת: פתח אחד מקבצים, דוא"ל, AirDrop, או שירות ענן ובחר OnSong. ייבוא binder המחזיק סט משחזר את הסט וכל שיר בו; ייבוא אחד המחזיק שיר יחיד מוסיף את השיר הזה.
כדי ליצור אחד, השתמש ב-Share ובחר OnSong Binder כפורמט.
Binders הם גם מה ש-OnSong Connect שולח בין התקנים כשהתקן אחד שואל אחר לשיר או סט, כך שאותו פורמט שחי ביישומון הקבצים שלך הוא זה שנוסע על פני הרשת.
מכיוון שbinder הוא ZIP של JSON רגיל וקבצי מדיה רגילים, זה הפורמט הנכון להגיע כאשר אתה צריך לראות מה OnSong בעצם אחסן — או כאשר משהו צריך לקרוא את התוכן שלך והוא לא OnSong.