사용자 설명서

OnSong® 바인더

OnSong® 바인더 파일 형식은 OnSong이 노래, 세트 또는 전체 책을 라이브러리 간에 이동하는 방식입니다. OnSong® 아카이브처럼 내용을 다른 곳에서 재구성하는 데 필요한 모든 것을 담고 있습니다 — 노래 텍스트, 첨부 파일, 스타일, 설정, 이조 및 주석 — 하지만 아카이브가 단일 불투명 블롭인 반면, 바인더는 일반 파일의 폴더입니다. 이것은 읽을 수 있고, 검사할 수 있으며, 노래 자체와 함께 노래가 의존하는 미디어를 플랫폼에 구애받지 않는 방식으로 전달할 수 있게 해줍니다.

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

내부 구조

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

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

그 구조는 계속 반복됩니다: 세트는 노래를 포함하고, 노래는 첨부 파일을 포함하며, 각각은 자신의 매니페스트와 자신의 파일이 함께 있는 폴더입니다. 2백 곡의 책을 담는 바인더는 단일 차트를 담는 바인더와 동일한 형식입니다.

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

포함되는 내용

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

바인더 또는 아카이브?

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

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

가져오기 및 내보내기

바인더는 다른 파일처럼 가져옵니다: 파일, 메일, AirDrop 또는 클라우드 서비스에서 하나를 열고 OnSong을 선택합니다. 세트를 담는 바인더를 가져오면 세트와 그 안의 모든 노래를 다시 만들고, 단일 노래를 담는 바인더를 가져오면 그 노래를 추가합니다.

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

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

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

OnSong 2026 — 마지막 업데이트: September 1, 2026