Kullanıcı Kılavuzu

OnSong® Klasörü

OnSong® Binder dosya formatı, OnSong'un bir şarkıyı, bir seti veya tüm bir kitabı kütüphaneler arasında taşımasının yoludur. OnSong® Arşivi gibi, içeriği başka bir yerde yeniden oluşturmak için gerekli her şeyi taşır — şarkı metni, ekler, stiller, ayarlar, transpoze ve açıklamalar — ancak bir arşiv tek bir opak blob iken, bir binder sıradan dosyaların bir klasörüdür. Bu, onu okunabilir, incelenebilir ve bir şarkının bağlı olduğu medyayı platform-bağımsız bir şekilde şarkının kendisiyle birlikte taşıyabilir hale getirir.

OnSong® Binder dosya formatı .onsongbinder veya .binder dosya uzantısına ve application/onsong-binder MIME türüne sahiptir.

İçinde Neler Var

Bir binder bir ZIP arşividir. Birini açıp çıkarırsanız, öğenin tanımlayıcısından sonra adlandırılmış bir klasör bulacaksınız ve içinde şunlar yer alır:

  • manifest.json — öğenin kendisi, seri hale getirilmiş. OnSong'un bildiği her özellik, OnSong web API'sinin kullandığı aynı biçimde.
  • Dosyası varsa, onun dosyası. Bir ek orijinal dosya adını tutar, bu nedenle bir binder içindeki PDF veya MP3 sadece o PDF veya MP3'tür.
  • Alt öğeleri için klasörler, ne oldukları adına verilir — songs (şarkılar), attachments (ekler) — her biri tam aynı biçimde daha fazla klasör içerir.

Bu yapı tüm yolda tekrarlanır: bir set şarkıları içerir, bir şarkı ekler içerir ve her biri kendi manifestinin yanında kendi dosyalarını içeren bir klasördür. İki yüz şarkılı bir kitabı tutan bir binder, tek bir chart tutan bir binder ile aynı formattır.

Bir manifestin içinde, alt öğelere yapılan referanslar $binder. önekiyle işaretlenir, böylece bir okuyucu öğeye ait bir değer ile yanında bir klasöre işaret eden bir değer arasındaki farkı ayırt edebilir.

Ne Taşır

  • Şarkılar — akor şeması ve ona bağlı her şey.
  • Setler — sıraları içinde şarkılar, setin kendi düzenlemesiyle.
  • Kitaplar — tam bir koleksiyon.
  • Ekler — PDF'ler, görüntüler, ses ve bir şarkıyla ilişkili herhangi bir dosya. Hiç bir sürümü eklemek yerine yalnızca gerçekte kullanılan ekleri dahil etmeyi seçebilirsiniz.

Binder Mi Arşiv Mi?

Her ikisi de bir kütüphanenin içeriğini sadakatle geri döndürür, bu nedenle seçim dosyadan neye ihtiyaç duyduğunuz hakkındadır:

  • OnSong® Arşivi daha eski formattır ve OnSong'un önceki sürümleriyle uyumluluk için kullanılması gereken şeydir.
  • OnSong® Binder mevcut olandır. OnSong'un daha yeni sürümleriyle paylaşım için kullanın — ve içini açıp bakabileceğiniz bir dosya istediğinizde.

İçe Aktarma ve Dışa Aktarma

Binderlar diğer herhangi bir dosya gibi içe aktarılır: Dosyalar, Posta, AirDrop veya bir bulut hizmetinden birini açın ve OnSong'u seçin. Bir seti tutan bir binderi içe aktarmak, seti ve içindeki her şarkıyı yeniden oluşturur; tek bir şarkıyı tutan birini içe aktarmak o şarkıyı ekler.

Bir tane oluşturmak için Paylaş'ı kullanın ve biçim olarak OnSong Binder'ı seçin.

Binderlar ayrıca OnSong Connect'in bir cihaz başka bir cihazdan bir şarkı veya bir seti istediğinde cihazlar arasında gönderdiği şeydir, bu nedenle Dosyalar uygulamanızda yaşayan aynı format ağ üzerinde seyahat eden formattır.

Bir binder sade JSON ve sıradan medya dosyalarının ZIP'i olduğundan, OnSong'un gerçekten ne depoladığını görmek istediğinizde — veya bir şey içeriğinizi okuması gerekiyorsa ve OnSong değilse — ulaşılması gereken doğru formattır.

2026.3 — Son Güncelleme September 1, 2026