Create a gist now

Instantly share code, notes, and snippets.

What would you like to do?
同人音楽クロスフェード用埋め込みデータフォーマット

Ver0.0.4

仕様策定中

言語とWebページ(特設サイト)に埋め込む位置

  • 使用言語はHTML。
  • meta要素を使用する。
  • head要素の子要素として埋め込む。
  • content内のデータはutf-8をURLエンコードしたものとする。

取り扱うデータ

  • サークル名
  • 参加日とスペース番号
  • 作品タイトル
  • ジャンルコード
  • 試聴用データのURL
  • プレーヤーのタイプ
  • 作品の説明文
  • アートワーク
  • 試聴用データのトラックリスト
  • 試聴用データのトラックリスト 再生位置
  • おすすめトラック番号
  • 新譜情報フラグ
  • 委託情報フラグ
  • その他楽曲フラグ
  • 作品用タグ
  • ボーカル用タグ
  • 制作者用タグ
  • 作品バナーURL
  • 登録削除申請用フラグ
  • 登録URL
  • データ作成時間
  • 同人音楽クロスフェード フォーマットバージョン
  • 同人音楽クロスフェード フォーマット 生成アプリ名

各要素の説明

サークル名

サークル名を入力する。(必須)
最大文字数:全角20文字

name="doujin:xfd:circle:name"

content入力例:サークル123

content="%E3%82%B5%E3%83%BC%E3%82%AF%E3%83%AB123"

参加日とスペース番号

参加日時とスペース番号を5分割して入力する。
参加日、建物名は必須。以下は任意入力。建物名が省略されるイベントの場合、ブロック(コミケ準拠での「あ」など)以下を繰り上げて利用する。
最大文字数:space1 全角4文字
最大文字数:space2 全角8文字
最大文字数:space3 全角8文字
最大文字数:space4 全角4文字
最大文字数:space5 全角4文字

name="doujin:xfd:circle:space1"
name="doujin:xfd:circle:space2"
name="doujin:xfd:circle:space3"
name="doujin:xfd:circle:space4"
name="doujin:xfd:circle:space5"

  1. 参加日 (必須)
  2. 建物名 (必須)
  3. ブロック (任意)
  4. スペース番号 (任意)
  5. 記号 (任意)

例(コミケ準拠):1日目 東3 X 70 a
例(建物名が無い場合):1日目 一般 70 ab

content入力例:1日目

content="1%E6%97%A5%E7%9B%AE"

content入力例:東3

content="%E6%9D%B13"

content入力例:X

content="X"

content入力例:70

content="70"

content入力例:a

content="a"

作品タイトル

頒布する作品のタイトルを入力する。(必須)
最大文字数:全角34文字

name="doujin:xfd:album:name"

content入力例:新作CD

content="%E6%96%B0%E4%BD%9CCD"

ジャンルコード

イベント毎に設定されているジャンルコードを入力する。(必須)
最大文字数:全角8文字

name="doujin:xfd:album:genre"

content入力例:230

content="230"

試聴用データのURL

試聴用データのURLを入力する。(必須)
最大文字数:半角2083文字

name="doujin:xfd:album:xfdurl"

content入力例:http://example.com/123

content="http%3A%2F%2Fexample.com%2F123"

プレーヤーのタイプ

再生用プレーヤーのタイプを入力する。(必須)
最大文字数:半角64文字

name="doujin:xfd:album:playertype"

content入力例:SoundCloud

content="SoundCloud"

作品の説明文

作品の説明文を入力する。(必須)
最大文字数:全角200文字

name="doujin:xfd:album:desc"

content入力例:新作できました。

content="%E6%96%B0%E4%BD%9C%E3%81%A7%E3%81%8D%E3%81%BE%E3%81%97%E3%81%9F%E3%80%82"

アートワーク

アートワーク(ジャケット画像)のURLを入力する。(必須)
最大文字数:半角2083文字
入力データはリファラ情報が無い(アドレスバーに直接URLを入力しても閲覧可能である)状態でも問題なく表示されるアドレスが望ましい。

name="doujin:xfd:album:artwork"

content入力例:http://example.com/123.jpg

content="http%3A%2F%2Fexample.com%2F123.jpg"

試聴用データのトラックリスト

試聴用データのトラックリスト(タイトル)を入力する。(必須)
トラック毎にutf-8エンコードを行い、トラックの区切りはカンマ「,」を使用する。
最大文字数:トラック毎 全角34文字

name="doujin:xfd:album:xfdlist"

content入力例:トラック1 トラック2

content="%E3%83%88%E3%83%A9%E3%83%83%E3%82%AF1,%E3%83%88%E3%83%A9%E3%83%83%E3%82%AF2"

試聴用データのトラックリスト 再生位置

試聴用データの再生時に再生位置とタイトルを紐づけするための位置データを入力する。(必須)
最大文字数:
トラック毎の区切りはカンマ「,」を使用する。(単位はmsec。30秒の場合30000、1分45秒の場合105000。)

name="doujin:xfd:album:xfdmsec"

content入力例:0,25000

content="0,25000"

おすすめトラック番号

試聴トラックの中で、特におすすめとするトラック番号を入力する。(必須)
特にない場合は「1」とする。

name="doujin:xfd:album:xfdpptrack"

content入力例:1

content="1"

新譜情報フラグ

作品が新譜であるかを入力する。(必須)
新譜である場合は「1」、旧譜の場合は「0」とする。

name="doujin:xfd:album:newrelease"

content入力例:1

content="1"

委託情報フラグ

作品がショップ・通販など会場以外で入手可能であるかを入力する。(必須)
入手可能である場合は「1」、会場内限定の場合は「0」とする。

name="doujin:xfd:album:shop"

content入力例:1

content="1"

その他楽曲フラグ

試聴データに含まれていない楽曲が存在するかを入力する。(必須)
試聴データに含まれない楽曲がある場合は「1」、すべてのトラックが試聴可能な場合は「0」とする。

name="doujin:xfd:album:moretracks"

content入力例:1

content="1"

作品用タグ

作品の属性情報等を入力する。(必須)
最大文字数:タグ一つにつき 全角16文字。最大10個
タグの区切りは半角スペース「 」を使用する。
人名などで苗字と名前の間にスペースが入る場合はアンダーバー「_」を使用する。

name="doujin:xfd:album:tags"

content入力例:タグ1 タグ2

content="%E3%82%BF%E3%82%B0%EF%BC%91%20%E3%82%BF%E3%82%B02"

ボーカル用タグ

作品のボーカル情報を入力する(任意)
作品用タグと同じ仕様。

name="doujin:xfd:album:tags:vocal"

制作者用タグ

制作者情報(人名やサークル名など)を入力する。(任意)
作品用タグと同じ仕様。

name="doujin:xfd:album:tags:staff"

作品バナーURL

特設サイト等のバナーURLを入力する。(任意)
最大文字数:半角2083文字
入力データはリファラ情報が無い(アドレスバーに直接URLを入力しても閲覧可能である)状態でも問題なく表示されるアドレスが望ましい。
取得側は、幅200px、高さ40px程度にリサイズして表示することがある。

name="doujin:xfd:album:banner"

content入力例:http://example.com/banner.jpg

content="http%3A%2F%2Fexample.com%2Fbanner.jpg"

登録削除申請用フラグ

登録データを削除するための申請に使用する。(任意)
データの削除を依頼する場合は「1」、未使用の場合は埋め込みを行わない。

name="doujin:xfd:album:delete"

content入力例:1

content="1"

登録URL

特設サイト等の詳細情報が掲載されているWebページのURLを入力する。(任意)
最大文字数:半角2083文字

name="doujin:xfd:album:url"

基本的に特設サイト以外からデータの取得は考えられないため、取得側は従わない可能性がある。
URLの「index.html」など、省略しても問題なくアクセスできる部分は省略する。

例: http://example.com/index.htmlhttp://example.com/

content入力例:http://example.com/

content="http%3A%2F%2Fexample.com%2F"

データ作成時間

エポック秒(UNIX時間)を使用する。(必須)

name="doujin:xfd:update"

content入力例:1397703067

content="1397703067"

同人音楽クロスフェード フォーマットバージョン

使用するフォーマットのバージョンを入力する。(必須)

name="doujin:xfd:version"

content入力例:0.0.2

content="0.0.2"

同人音楽クロスフェード フォーマット 生成アプリ名

作成したアプリ名を入力する。(任意)

name="doujin:xfd:generator"

content入力例:example

content="example"

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment