מדריך המשתמש

תיקייה OnSong®

פורמט קובץ OnSong® Binder הוא הדרך שבה OnSong מעביר שיר, סט או ספר שלם בין ספריות. כמו OnSong® Archive, הוא נושא הכל הדרוש לשחזור התוכן במקום אחר — טקסט השיר, קבצים מצורפים, סגנונות, הגדרות, טרנספוזיציה והערות — אך בעוד שארכיון הוא blob אטום יחיד, binder הוא תיקייה של קבצים רגילים. זה הופך אותו לקריא, ניתן לבדיקה, ויכול לנוע בתקשורת בה תלויה שיר לצד השיר עצמו בדרך בלתי תלויה בפלטפורמה.

פורמט קובץ OnSong® Binder כולל סיומת קובץ של .onsongbinder או .binder, וסוג MIME של application/onsong-binder.

מה בפנים

binder הוא ארכיון 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 המחזיק סט משחזר את הסט וכל שיר בו; ייבוא אחד המחזיק שיר יחיד מוסיף את השיר ההוא.

כדי ליצור אחד, השתמש ב-Share ובחר ב-OnSong Binder כפורמט.

Binders הם גם מה ש-OnSong Connect שולח בין מכשירים כאשר מכשיר אחד מבקש מאחר שיר או סט, אז אותו פורמט שחי באפליקציית הקבצים שלך הוא זה שנוסע על פני הרשת.

מכיוון binder הוא ZIP של JSON רגיל וקבצי מדיה רגילים, זה הפורמט הנכון להגיע אליו כאשר אתה צריך לראות מה OnSong בעצם אחסן — או כאשר משהו צריך לקרוא את התוכן שלך והוא לא OnSong.

2026.3 — עדכון אחרון ב-September 1, 2026