OnSong^® 바인더

OnSong^® Binder 파일 형식은 OnSong이 곡, 세트 또는 전체 책을 라이브러리 간에 이동하는 방법입니다. OnSong^® 아카이브와 마찬가지로 다른 위치에서 콘텐츠를 다시 빌드하는 데 필요한 모든 것을 포함합니다 — 곡 텍스트, 첨부 파일, 스타일, 설정, 이조 및 주석 — 하지만 아카이브가 단일 불투명 blob인 반면, binder는 일반 파일의 폴더입니다. 이를 통해 읽을 수 있고, 검사할 수 있으며, 플랫폼에 무관한 방식으로 곡이 의존하는 미디어를 곡 자체와 함께 전달할 수 있습니다.

OnSong^® Binder 파일 형식의 파일 확장자는 .onsongbinder 또는 .binder 중 하나이며, MIME 유형은 application/onsong-binder입니다.

내부 구조

binder는 ZIP 아카이브입니다. 압축을 풀면 항목의 식별자로 이름이 지정된 폴더가 나타나며, 여기에는 다음이 포함됩니다:

• manifest.json — 항목 자체이며, 직렬화됨. OnSong이 알고 있는 모든 속성을 OnSong 웹 API에서 사용하는 것과 동일한 형태로.
• 파일이 있는 경우 해당 파일. 첨부 파일은 원본 파일명을 유지하므로, binder 내의 PDF 또는 MP3는 그냥 그 PDF 또는 MP3입니다.
• 자식 폴더 — songs, attachments 같이 그것이 무엇인지에 따라 이름이 지정되며, 각각은 정확히 같은 형태의 더 많은 폴더를 포함합니다.

이 구조는 계속 반복됩니다: 세트는 곡을 포함하고, 곡은 첨부 파일을 포함하며, 각각은 자신의 manifest와 자신의 파일이 있는 폴더입니다. 2백 개의 곡으로 이루어진 책을 담은 binder는 단일 악보를 담은 것과 동일한 형식입니다.

manifest 내에서 자식에 대한 참조는 $binder. 접두사로 표시되므로, 읽기 프로그램은 항목에 속한 값과 그 옆의 폴더를 가리키는 값 간의 차이를 구별할 수 있습니다.

포함되는 내용

• 곡 — 코드 차트 및 여기에 첨부된 모든 것.
• 세트 — 순서대로 정렬된 곡 및 세트의 자체 편곡.
• 책 — 전체 컬렉션.
• 첨부 파일 — PDF, 이미지, 오디오 및 곡과 관련된 기타 파일. 추가된 모든 버전이 아닌 실제로 사용 중인 첨부 파일만 포함하도록 선택할 수 있습니다.

Binder 또는 아카이브?

둘 다 라이브러리의 콘텐츠를 충실하게 왕복하므로, 선택은 파일에서 필요한 것에 관한 것입니다:

• OnSong^® 아카이브 는 이전 형식이며, OnSong의 이전 버전과의 호환성을 위해 사용할 것입니다.
• OnSong^® Binder는 현재 형식입니다. 최신 버전의 OnSong과 공유할 때 사용하십시오 — 그리고 열어서 내부를 볼 수 있는 파일을 원할 때 사용하십시오.

가져오기 및 내보내기

Binder는 다른 파일과 동일한 방식으로 가져옵니다: 파일, 메일, AirDrop 또는 클라우드 서비스에서 열고 OnSong을 선택합니다. 세트를 담은 binder를 가져오면 세트와 그 안의 모든 곡이 다시 생성되며, 단일 곡을 담은 것을 가져오면 해당 곡이 추가됩니다.

하나를 만들려면 공유를 사용하고 형식으로 OnSong Binder를 선택합니다.

Binder는 또한 한 기기가 다른 기기에 곡이나 세트를 요청할 때 OnSong Connect가 기기 간에 전송하는 것이므로, 파일 앱에 있는 것과 동일한 형식이 네트워크를 통해 이동합니다.

binder는 평문 JSON과 일반 미디어 파일의 ZIP이므로, OnSong이 실제로 저장한 것을 확인해야 할 때 또는 무언가가 당신의 콘텐츠를 읽어야 하는데 그것이 OnSong이 아닐 때 사용할 올바른 형식입니다.