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