Panduan Pengguna
Binder OnSong®
Format file 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 jika arsip adalah blob buram tunggal, binder adalah folder berisi file biasa. Hal ini membuatnya dapat dibaca, dapat diperiksa, dan mampu membawa media yang dibutuhkan lagu bersama lagu itu sendiri dengan cara yang tidak bergantung pada platform.
Format file OnSong® Binder memiliki ekstensi file .onsongbinder atau .binder, dan tipe MIME application/onsong-binder.
Apa yang Ada di Dalamnya
Binder adalah arsip ZIP. Buka zip dan Anda akan menemukan folder bernama sesuai pengenal item, berisi:
manifest.json— item itu sendiri, terserialisasi. Setiap properti yang diketahui OnSong tentangnya, dalam bentuk yang sama dengan yang digunakan API web OnSong.- File-nya, jika ada. Lampiran mempertahankan nama file aslinya, jadi PDF atau MP3 di dalam binder hanyalah PDF atau MP3 tersebut.
- Folder untuk anak-anaknya, dinamai sesuai dengan apa mereka —
songs,attachments— masing-masing menyimpan lebih banyak folder dengan bentuk yang sama persis.
Struktur itu berulang selamanya: set berisi lagu, lagu berisi lampiran, dan masing-masing adalah folder dengan manifesnya sendiri di samping file-filenya sendiri. Binder yang menyimpan buku dua ratus lagu memiliki format yang sama dengan binder yang menyimpan diagram tunggal.
Di dalam manifes, referensi ke anak ditandai dengan awalan $binder., sehingga pembaca dapat membedakan antara nilai yang dimiliki item dan 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 lain apa pun yang terkait dengan lagu. Anda dapat memilih untuk hanya menyertakan lampiran yang benar-benar digunakan daripada setiap versi yang pernah ditambahkan.
Binder atau Arsip?
Keduanya melakukan round-trip konten perpustakaan dengan setia, jadi pilihan tergantung pada apa yang Anda butuhkan dari file:
- OnSong® Archive adalah format yang lebih lama, dan yang harus digunakan untuk kompatibilitas dengan versi OnSong sebelumnya.
- OnSong® Binder adalah format saat ini. Gunakan untuk berbagi dengan versi OnSong yang lebih baru — dan saat Anda menginginkan file yang dapat dibuka dan diperiksa.
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 kembali set dan setiap lagu di dalamnya; mengimpor binder yang menyimpan lagu tunggal menambahkan lagu tersebut.
Untuk membuat binder, gunakan Bagikan dan pilih OnSong Binder sebagai formatnya.
Binder juga yang dikirim OnSong Connect antar perangkat saat satu perangkat meminta perangkat lain untuk lagu atau set, jadi format yang ada di aplikasi Files Anda adalah format yang berpergian melalui jaringan.
Karena binder adalah ZIP berisi JSON biasa dan file media biasa, ini adalah format yang tepat untuk digunakan saat Anda perlu melihat apa yang benar-benar disimpan OnSong — atau saat sesuatu perlu membaca konten Anda dan bukan OnSong.