Binder OnSong^®

Định dạng tệp OnSong^® Binder là cách OnSong di chuyển một bài hát, một bộ bài, hoặc toàn bộ sách giữa các thư viện. Giống như OnSong^® Archive, nó mang theo mọi thứ cần thiết để tái tạo nội dung ở nơi khác — văn bản bài hát, tệp đính kèm, kiểu dáng, cài đặt, chuyển đổi cao độ và chú thích — nhưng khác với archive là một khối blob duy nhất và không thể đọc được, thì binder là một thư mục chứa các tệp thông thường. Điều này làm cho nó dễ đọc, có thể kiểm tra được, và có khả năng mang theo phương tiện mà một bài hát phụ thuộc vào cùng với bài hát đó theo cách không phụ thuộc vào nền tảng.

Định dạng tệp OnSong^® Binder có phần mở rộng tệp là .onsongbinder hoặc .binder, và loại MIME là application/onsong-binder.

Bên trong là gì

Một binder là một kho lưu trữ ZIP. Giải nén một binder và bạn sẽ tìm thấy một thư mục được đặt tên theo định danh của mục, chứa:

• manifest.json — bản thân mục đó, được tuần tự hóa. Mọi thuộc tính mà OnSong biết về nó, có cùng hình dạng mà API web OnSong sử dụng.
• Tệp của nó, nếu nó có. Một tệp đính kèm giữ lại tên tệp gốc của nó, vì vậy một PDF hoặc MP3 bên trong một binder chỉ là PDF hoặc MP3 đó.
• Thư mục cho các mục con của nó, được đặt tên theo những gì chúng là — songs, attachments — mỗi thư mục chứa nhiều thư mục có cùng hình dạng.

Cấu trúc đó lặp lại cho đến cuối: một bộ bài chứa các bài hát, một bài hát chứa các tệp đính kèm, và mỗi bài hát là một thư mục có manifest riêng cùng với các tệp riêng của nó. Một binder chứa một sách gồm hai trăm bài hát có cùng định dạng với một binder chứa một bảng biểu duy nhất.

Bên trong một manifest, các tham chiếu đến mục con được đánh dấu bằng tiền tố $binder., vì vậy người đọc có thể phân biệt giữa một giá trị thuộc về mục và một giá trị trỏ vào một thư mục bên cạnh nó.

Nó mang theo cái gì

• Bài hát — bảng biểu hợp âm và mọi thứ được đính kèm vào nó.
• Bộ bài — các bài hát theo thứ tự của chúng, với sắp xếp của bộ bài.
• Sách — một bộ sưu tập toàn bộ.
• Tệp đính kèm — PDF, hình ảnh, âm thanh, và bất kỳ tệp nào khác được liên kết với một bài hát. Bạn có thể chọn chỉ bao gồm các tệp đính kèm thực sự được sử dụng thay vì mọi phiên bản đã từng được thêm vào.

Binder hay Archive?

Cả hai đều có thể hoạt động lại nội dung của thư viện một cách chính xác, vì vậy lựa chọn là về những gì bạn cần từ tệp:

• OnSong^® Archive là định dạng cũ hơn, và đó là những gì cần sử dụng để tương thích với các phiên bản trước của OnSong.
• OnSong^® Binder là định dạng hiện tại. Sử dụng nó để chia sẻ với các phiên bản mới hơn của OnSong — và khi bạn muốn một tệp mà bạn có thể mở ra và nhìn vào bên trong.

Nhập và Xuất

Binder nhập theo cách như bất kỳ tệp nào khác: mở một tệp từ Files, Mail, AirDrop, hoặc một dịch vụ đám mây và chọn OnSong. Nhập một binder chứa một bộ bài sẽ tái tạo bộ bài và mọi bài hát trong đó; nhập một binder chứa một bài hát duy nhất sẽ thêm bài hát đó.

Để tạo một binder, sử dụng Chia sẻ và chọn OnSong Binder làm định dạng.

Binder cũng là những gì OnSong Connect gửi giữa các thiết bị khi một thiết bị yêu cầu thiết bị khác cung cấp một bài hát hoặc một bộ bài, vì vậy định dạng giống nhau mà nằm trong ứng dụng Files của bạn là định dạng được truyền qua mạng.

Vì một binder là một ZIP của JSON đơn giản và các tệp phương tiện thông thường, nó là định dạng phù hợp để sử dụng khi bạn cần xem những gì OnSong thực sự lưu trữ — hoặc khi có thứ gì đó cần đọc nội dung của bạn và nó không phải là OnSong.