Bộ sưu tập OnSong^®

Định dạng tệp OnSong^® Binder là cách OnSong di chuyển một bài hát, một tập hợp, hoặc cả một cuốn sách giữa các thư viện. Giống như OnSong^® Archive, nó chứa mọi thứ cần thiết để xây dựng lại nội dung ở nơi khác — văn bản bài hát, tệp đính kèm, kiểu, cài đặt, transposition và chú thích — nhưng khác với archive là một khối đơn lẻ không rõ ràng, binder là một thư mục của các tệp thông thường. Điều đó làm cho nó dễ đọc, có thể kiểm tra được, và có khả năng chứa các phương tiện mà bài hát phụ thuộc vào cùng với bài hát đó theo cách độc lập với 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 Có Gì

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

• manifest.json — chính mục đó, được tuần tự hóa. Mọi thuộc tính mà OnSong biết về nó, trong cùng định dạng mà OnSong web API 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 binder chỉ là PDF hoặc MP3 đó.
• Thư mục cho các phần tử con của nó, được đặt tên theo những gì chúng — songs, attachments — mỗi thư mục chứa thêm các thư mục cùng hình dạng.

Cấu trúc đó lặp lại tất cả cách xuống: một tập hợp 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 cái là một thư mục với manifest riêng của nó bên cạnh các tệp riêng của nó. Một binder chứa một cuốn 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 biểu đồ duy nhất.

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

Nó Chứa Gì

• Các bài hát — biểu đồ hợp âm và mọi thứ được đính kèm với nó.
• Các tập hợp — các bài hát theo thứ tự của chúng, với sắp xếp riêng của tập hợp.
• Các cuốn sách — toàn bộ một bộ sưu tập.
• 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 làm vòng quay lại nội dung của thư viện một cách trung thực, vì vậy sự 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 dạng để 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 OnSong mới hơn — và khi bạn muốn một tệp mà bạn có thể mở và nhìn vào bên trong.

Nhập Và Xuất

Các binder được nhập theo cách mà bất kỳ tệp nào khác làm: mở một từ Tệp, 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 tập hợp sẽ tái tạo tập hợp 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, sử dụng Chia sẻ và chọn OnSong Binder làm định dạng.

Các 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 tập hợp, vì vậy cùng một định dạng nằm trong ứng dụng Tệp của bạn là cái đang di chuyển trên mạng.

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