OnSong^® 바인더

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

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

내부 구조

바인더는 ZIP 아카이브입니다. 바인더를 압축 해제하면 항목의 식별자로 이름이 지정된 폴더를 찾을 수 있으며, 다음을 포함합니다:

• manifest.json — 항목 자체가 직렬화된 형태입니다. OnSong이 알고 있는 모든 속성이 OnSong 웹 API가 사용하는 것과 동일한 형태로 저장됩니다.
• 파일이 있는 경우 해당 파일입니다. 첨부 파일은 원본 파일 이름을 유지하므로, 바인더 내의 PDF 또는 MP3는 그냥 해당 PDF 또는 MP3입니다.
• 자식을 위한 폴더들은 그들이 무엇인지를 나타내는 이름으로 지정됩니다. 예를 들어 songs, attachments이며, 각각은 정확히 동일한 구조의 더 많은 폴더를 담고 있습니다.

이러한 구조는 계속 반복됩니다: 세트는 노래를 포함하고, 노래는 첨부 파일을 포함하며, 각각은 자체 manifest와 자체 파일이 있는 폴더입니다. 200개의 노래가 있는 책을 포함하는 바인더는 단일 차트를 포함하는 바인더와 동일한 형식입니다.

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

포함 내용

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

바인더 또는 아카이브?

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

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

가져오기 및 내보내기

바인더는 다른 파일과 마찬가지로 가져옵니다: Files, Mail, AirDrop 또는 클라우드 서비스에서 파일을 열고 OnSong을 선택합니다. 세트를 포함하는 바인더를 가져오면 세트와 그 안의 모든 노래가 재생성됩니다. 단일 노래를 포함하는 바인더를 가져오면 해당 노래가 추가됩니다.

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

바인더는 또한 OnSong Connect가 한 기기가 다른 기기에 노래 또는 세트를 요청할 때 기기 간에 전송하는 형식이기도 합니다. 따라서 Files 앱에 있는 동일한 형식이 네트워크를 통해 이동합니다.

바인더는 일반 JSON과 일반 미디어 파일의 ZIP이므로, OnSong이 실제로 저장한 것을 확인해야 할 때 또는 OnSong이 아닌 다른 것이 콘텐츠를 읽어야 할 때 사용할 올바른 형식입니다.