Hướng dẫn người dùng
OnSong® Binder
Định dạng tệp Binder của OnSong® là cách OnSong di chuyển một bài hát, một bộ sưu tập hoặc cả một cuốn sách giữa các thư viện. Giống như Lưu trữ OnSong®, nó chứa 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 lưu trữ là một khối blobkín không trong suốt, binder là một thư mục gồm 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, và có khả năng chứa 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 không phụ thuộc vào nền tảng.
Định dạng tệp Binder của OnSong® 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ì
Binder là 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 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ó, ở 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. Tệp đính kèm giữ lại tên tệp gốc của nó, do đó tệp PDF hoặc MP3 bên trong binder chỉ là tệp PDF hoặc MP3 đó.
- Các thư mục cho các mục con của nó, được đặt tên theo loại chúng —
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 cùng: 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ộ là một thư mục có manifest riêng cạnh các tệp riêng của nó. Binder chứa một cuốn sách gồm hai trăm bài hát có định dạng giống như binder chứa một biểu đồ duy nhất.
Bên trong manifest, các tham chiếu đến các mục con được đánh dấu bằng tiền tố $binder., do đó người đọc có thể nhận biết sự khác biệt giữa giá trị thuộc về mục và giá trị chỉ vào thư mục bên cạnh nó.
Nó Chứa Gì
- Bài hát — bảng 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.
- 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 bài hát. Bạn có thể chọn chỉ bao gồm các tệp đính kèm thực sự đang được sử dụng chứ không phải mọi phiên bản từng được thêm vào.
Binder Hay Lưu Trữ?
Cả hai đều làm cho nội dung thư viện quay vòng một cách trung thực, do đó sự lựa chọn là về những gì bạn cần từ tệp:
- Lưu Trữ OnSong® là định dạng cũ hơn, và là những gì sử dụng để tương thích với các phiên bản OnSong trước đó.
- 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ở ra và nhìn vào bên trong.
Nhập Và Xuất
Binders nhập theo cách giống như bất kỳ tệp nào khác: mở một tệp từ Tệp, Mail, AirDrop, hoặc dịch vụ đám mây và chọn OnSong. Nhập binder chứa một bộ sưu tập sẽ tạo lại bộ sưu tập và mọi bài hát trong đó; nhập 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.
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 cho bài hát hoặc bộ sưu tập, do đó định dạng giống nhau tồn tại trong ứng dụng Tệp của bạn là định dạng di chuyển qua mạng.
Vì binder là ZIP gồm JSON thuần túy và các tệp phương tiện thông thường, nên đó là định dạng phù hợp khi bạn cần xem những gì OnSong thực sự lưu trữ — hoặc khi có cái gì đó cần đọc nội dung của bạn và nó không phải là OnSong.