Hướng dẫn người dùng

Tệp Binder 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 toàn bộ cuốn sách giữa các thư viện. Giống như OnSong® Archive, nó mang theo tất cả những gì 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 dáng, cài đặt, chuyển vị và chú thích — nhưng trong khi kho lưu trữ là một khối mờ đơn lẻ, binder là một thư mục các tệp thông thường. Điều đó làm cho nó có thể đọc được, kiểm tra được, và có khả năng mang theo phương tiện mà bài hát phụ thuộc vào cùng với chính 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ì

Binder là một kho lưu trữ ZIP. Giải nén một kho lưu trữ 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 — chính mục đó, được tuần tự hóa. Mọi thuộc tính mà OnSong biết về nó, ở 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. Một tệp đính kèm giữ tên tệp gốc của nó, vì vậy 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 là — songs, attachments — mỗi cái chứa thêm các thư mục 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 có manifest riêng của nó bên cạnh các tệp riêng của nó. Binder chứa một cuốn sách có hai trăm bài hát có cùng định dạng với một binder chứa một biểu đồ đơn lẻ.

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 người đọc có thể nhận ra sự khác biệt giữa một giá trị thuộc về mục và giá trị chỉ vào thư mục bên cạnh nó.

Nó mang theo những gì

  • Bài hát — biểu đồ hợp âm và mọi thứ được đính kèm với nó.
  • Tập hợp — các bài hát theo thứ tự của chúng, với sự sắp xếp riêng của tập hợp.
  • Sách — toàn bộ 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.

Binder hay Archive?

Cả hai đều vận chuyển 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à cái cần sử dụng để tương thích với các phiên bản OnSong sớm hơn.
  • OnSong® Binder là cái 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ở ra và nhìn vào bên trong.

Nhập khẩu và xuất khẩu

Binders nhập theo cách giống như bất kỳ tệp nào khác: mở một từ Files, Mail, AirDrop, hoặc 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ạo lại 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 binder, hãy sử dụng Chia sẻ và chọn OnSong Binder làm định dạng.

Binders 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 gửi bài hát hoặc tập hợp, vì vậy định dạng tương tự tồn tại trong ứng dụng Files của bạn là cái đang di chuyển qua mạng.

Vì binder là 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à không phải OnSong.

OnSong 2026 — Cập nhật lần cuối vào September 1, 2026