מדריך המשתמש

קלסר OnSong®

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

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

מה בפנים

binder הוא ארכיון ZIP. פתח אותו ב-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.

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