Hướng dẫn người dùng
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 bộ, 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 để 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, chuyển vị và chú thích — nhưng trong khi kho lưu trữ là một khối không minh bạch, binder là một thư mục chứa các tệp bình thường. Điều đó làm cho nó có thể đọc được, 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 vào cùng với bài hát trong một 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 Là Gì
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 đị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ó tệp. Một tệp đính kèm giữ lại 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 mục con của nó, được đặt tên theo chúng là gì —
songs,attachments— mỗi thư mục chứa thêm các thư mục có chính xác cùng một hình dạng.
Cấu trúc đó lặp lại tất cả cách xuống: một bộ 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ó cùng với các tệp riêng của nó. Binder chứa sách có hai trăm bài hát giống với định dạng của 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., vì vậy người đọc có thể phân 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ó Mang Theo Gì
- Bài hát — biểu đồ hợp âm và mọi thứ được gắn vào nó.
- Bộ — các bài hát theo thứ tự của chúng, với sự sắp xếp riêng của bộ.
- 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 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 thay vì mọi phiên bản từng được thêm vào.
Binder Hay Archive?
Cả hai đều quay lại nội dung thư việ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à 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à phiên bản 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
Binders nhập giống như bất kỳ tệp nào khác: mở một trong Files, Mail, AirDrop, hoặc dịch vụ đám mây và chọn OnSong. Nhập binder chứa bộ sẽ tạo lại bộ 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 cái, 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 bộ, vì vậy định dạng tương tự tồn tại trong ứng dụng Files của bạn là định dạng di chuyển qua mạng.
Vì binder là ZIP của JSON đơn giản và 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 OnSong thực sự lưu trữ gì — hoặc khi có điều gì đó cần đọc nội dung của bạn và nó không phải là OnSong.