מדריך המשתמש

קלסר 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 שלך הוא זה שנוסע על הרשת.

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

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