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

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ộ sưu tập hoặc toàn bộ 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 dùng cao độ và chú thích — nhưng trong khi một kho lưu trữ là một khối mờ duy nhất, một 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ó có thể đọc được, có thể kiểm tra được, và có khả năng mang theo các phương tiện mà bài hát phụ thuộc 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 Có Gì

Một binder là một kho lưu trữ ZIP. Giải nén một tệp 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ó, theo cùng hình dạng mà OnSong web API sử dụng.
  • Tệp của nó, nếu nó có một tệp. Một tệp đính kèm giữ lại tên tệp ban đầu của nó, vì vậy một PDF hoặc MP3 bên trong binder chỉ là PDF hoặc MP3 đó.
  • Các 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 đến hết: một bộ sưu tậ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 bài hát là một thư mục với manifest của riêng nó cạnh các tệp của riêng 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 binder chứa một biểu đồ duy nhất.

Bên trong một manifest, các tham chiếu đến các mục 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ị trỏ tới một thư mục bên cạnh nó.

Nó Mang Theo Những 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 bộ sưu tập — các bài hát theo thứ tự của chúng, với sắp xếp của bộ sưu tập.
  • Các sách — toàn bộ bộ sưu tập.
  • Các tệp đính kèm — PDF, hình ảnh, âm thanh và bất kỳ tệp nào khác liên quan đến bài hát. Bạn có thể chọn chỉ bao gồm các tệp đính kèm thực tế đang được sử dụng thay vì mọi phiên bản từng được thêm.

Binder Hay Archive?

Cả hai đều làm cho nội dung của thư viện vòng tròn một cách trung thự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à cách sử dụng để tương thích với các phiên bản OnSong trước đó.
  • 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 Và Xuất

Các binder nhập theo cách giống 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ộ sưu tập sẽ tái tạo bộ sưu tậ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.

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 bộ sưu tập, vì vậy cùng một định dạng tồn tại trong ứng dụng Files của bạn là cái đang di chuyể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à đó không phải là OnSong.

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