מדריך המשתמש
תיקייה 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— כל אחת מחזיקה תיקיות נוספות בדיוק באותה צורה.
המבנה הזה חוזר על עצמו כל הדרך למטה: סט מכיל שירים, שיר מכיל קובצים מצורפים, וכל אחד הוא תיקייה עם ה-manifest שלה לצידה עם הקבצים שלה. Binder המחזיק ספר של מאתיים שירים הוא אותו פורמט כמו אחד המחזיק תרשים יחיד.
בתוך manifest, הפניות לילדים מסומנות עם קידומת $binder., כך שקורא יכול להבחין בין ערך השייך לפריט לבין אחד המצביע לתוך תיקייה לצדו.
מה הוא נושא
- שירים — תרשים האקורדים וכל מה שצורף אליו.
- סטים — השירים בסדרם, עם ההסדר שלו של הסט.
- ספרים — אוסף שלם.
- קובצים מצורפים — PDFs, תמונות, אודיו, וכל קובץ אחר הקשור לשיר. אתה יכול לבחור לכלול רק את הקובצים המצורפים שאכן נמצאים בשימוש ולא כל גרסה שנוספה אי פעם.
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.