Panduan Pengguna
Binder OnSong®
Format OnSong® Binder adalah cara OnSong memindahkan lagu, set, atau seluruh buku antar perpustakaan. Seperti OnSong® Archive, format ini membawa semua yang diperlukan untuk membangun kembali konten di tempat lain — teks lagu, lampiran, gaya, pengaturan, transposisi, dan anotasi — tetapi di mana arsip adalah satu blob yang tidak transparan, binder adalah folder berisi file biasa. Ini membuatnya dapat dibaca, dapat diperiksa, dan dapat membawa media yang dibutuhkan lagu bersama lagu itu sendiri dengan cara yang independen dari platform.
Format OnSong® Binder memiliki ekstensi file .onsongbinder atau .binder, dan tipe MIME application/onsong-binder.
Apa yang Ada Di Dalamnya
Binder adalah arsip ZIP. Buka arsip tersebut dan Anda akan menemukan folder bernama sesuai pengenal item, berisi:
manifest.json— item itu sendiri, diserialisasi. Setiap properti yang diketahui OnSong tentangnya, dalam bentuk yang sama seperti yang digunakan OnSong web API.- Filenya, jika ada. Lampiran tetap menyimpan nama file aslinya, jadi PDF atau MP3 di dalam binder hanyalah PDF atau MP3 tersebut.
- Folder untuk anaknya, dinamai sesuai apa mereka —
songs,attachments— masing-masing menyimpan folder dengan bentuk yang sama persis.
Struktur tersebut berulang sampai ke bawah: set berisi lagu, lagu berisi lampiran, dan masing-masing adalah folder dengan manifest-nya sendiri di samping filenya sendiri. Binder yang menyimpan buku dua ratus lagu memiliki format yang sama seperti yang menyimpan satu chart.
Di dalam manifest, referensi ke anak ditandai dengan awalan $binder., sehingga pembaca dapat membedakan antara nilai yang termasuk dalam item dan nilai yang menunjuk ke folder di sebelahnya.
Apa yang Dibawanya
- Lagu — chord chart dan semua yang terlampir padanya.
- Set — lagu dalam urutannya, dengan pengaturan set itu sendiri.
- Buku — seluruh koleksi.
- Lampiran — PDF, gambar, audio, dan file lainnya yang terkait dengan lagu. Anda dapat memilih untuk menyertakan hanya lampiran yang benar-benar digunakan daripada setiap versi yang pernah ditambahkan.
Binder Atau Archive?
Keduanya melakukan perjalanan bolak-balik konten perpustakaan dengan setia, jadi pilihan tergantung pada apa yang Anda butuhkan dari file:
- OnSong® Archive adalah format yang lebih lama, dan yang digunakan untuk kompatibilitas dengan versi OnSong sebelumnya.
- OnSong® Binder adalah yang saat ini. Gunakan untuk berbagi dengan versi OnSong yang lebih baru — dan ketika Anda ingin file yang dapat Anda buka dan lihat di dalamnya.
Mengimpor dan Mengekspor
Binder diimpor seperti file lainnya: buka dari Files, Mail, AirDrop, atau layanan cloud dan pilih OnSong. Mengimpor binder yang menyimpan set membuat ulang set dan setiap lagu di dalamnya; mengimpor binder yang menyimpan satu lagu menambahkan lagu tersebut.
Untuk membuat satu, gunakan Bagikan dan pilih OnSong Binder sebagai formatnya.
Binder juga apa yang dikirimkan oleh OnSong Connect antar perangkat ketika satu perangkat meminta lagu atau set dari perangkat lain, jadi format yang sama yang ada di aplikasi Files Anda adalah yang berjalan di jaringan.
Karena binder adalah ZIP dari JSON biasa dan file media biasa, format ini cocok ketika Anda perlu melihat apa yang benar-benar disimpan OnSong — atau ketika sesuatu perlu membaca konten Anda dan bukan OnSong.