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、またはクラウドサービスから 1 つを開き、OnSong を選択します。セットを保持するバインダーをインポートすると、セットとその中のすべてのソングが再作成されます。単一のソングを保持するバインダーをインポートすると、そのソングが追加されます。

1 つを作成するには、共有を使用して、形式として OnSong バインダーを選択します。

バインダーはまた、OnSong Connect がデバイス間で送信するもの（1 つのデバイスが別のデバイルに対してソングまたはセットを要求する場合）であるため、ファイル app に存在する同じ形式がネットワーク上を移動するものです。

バインダーは平易な JSON と通常のメディアファイルの ZIP であるため、OnSong が実際に保存した内容を確認する必要があるとき、または何かがあなたのコンテンツを読み取る必要があるが OnSong ではない場合に、到達するのに適切な形式です。