OnSong^® 바인더

OnSong^® 바인더 파일 형식은 OnSong이 곡, 세트 또는 전체 책을 라이브러리 간에 옮기는 방식입니다. OnSong^® 아카이브와 마찬가지로 다른 곳에서 콘텐츠를 재구성하는 데 필요한 모든 것을 포함합니다 — 곡 텍스트, 첨부 파일, 스타일, 설정, 트랜스포지션 및 주석 — 하지만 아카이브는 단일의 불투명한 파일인 반면, 바인더는 일반 파일의 폴더입니다. 그래서 읽을 수 있고, 검사할 수 있으며, 곡이 의존하는 미디어를 플랫폼 독립적인 방식으로 곡 자체와 함께 포함할 수 있습니다.

OnSong^® 바인더 파일 형식의 파일 확장자는 .onsongbinder 또는 .binder이며, MIME 타입은 application/onsong-binder입니다.

내부 구조

바인더는 ZIP 아카이브입니다. 바인더를 압축 해제하면 항목의 식별자를 따라 명명된 폴더를 찾을 수 있으며, 여기에 포함됩니다:

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

이 구조는 계속 반복됩니다: 세트는 곡을 포함하고, 곡은 첨부 파일을 포함하며, 각각은 자신의 매니페스트와 자신의 파일을 옆에 가진 폴더입니다. 200곡의 책을 포함하는 바인더는 단일 차트를 포함하는 것과 같은 형식입니다.

매니페스트 내에서 자식에 대한 참조는 $binder. 접두사로 표시되므로, 판독기는 항목에 속한 값과 그 옆의 폴더를 가리키는 값의 차이를 알 수 있습니다.

포함되는 내용

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

바인더 또는 아카이브?

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

• OnSong^® 아카이브는 더 오래된 형식이며, OnSong의 이전 버전과의 호환성을 원할 때 사용할 형식입니다.
• OnSong^® 바인더는 현재 형식입니다. 최신 버전의 OnSong과 공유할 때 사용하세요 — 그리고 열어서 내부를 볼 수 있는 파일을 원할 때 사용합니다.

가져오기 및 내보내기

바인더는 다른 파일과 같은 방식으로 가져옵니다: 파일, 메일, AirDrop 또는 클라우드 서비스에서 바인더를 열고 OnSong을 선택합니다. 세트를 포함하는 바인더를 가져오면 세트와 그 안의 모든 곡이 재생성됩니다. 단일 곡을 포함하는 바인더를 가져오면 그 곡이 추가됩니다.

하나를 생성하려면 공유를 사용하고 형식으로 OnSong 바인더를 선택합니다.

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

바인더는 일반 JSON과 일반 미디어 파일의 ZIP이므로, OnSong이 실제로 저장한 내용을 확인해야 할 때 또는 어떤 것이 당신의 콘텐츠를 읽어야 하는데 OnSong이 아닐 때를 위해 도달해야 할 올바른 형식입니다.