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