曲リスト - FollowRef-ReflecSimulator-

書式に変更が生じました(2011/07/09記)

曲リスト-改(ver1.1)へ

music.xml

音楽ファイルを入れると指定したフォルダの中に自動生成されるファイルです
※文字コードはUTF-8
DLするだけの方は、基本的にこのファイルを触る必要はありませんが
music.xml が指定されていない場合や 自作される場合は参考にしてください

DLファイルとして設置する際、txt 形式でもOKです
一部のレンタルサーバーでは xml 形式が外部ツールから読み取れないようになってますが
こうすることで対応できます

フォルダ構造 のデータファイルを参考にするとわかりやすいです

一番下に記述例があります

最初の一行

<?xml version="1.0" encoding="utf-8" ?>

魔法の言葉だと思ってください
プレイヤーとは関連がありません。
xmlファイルの基本となる一行です

data タグ

<data> </data>

この中に各レーベルと曲のデータが入り、それがリストに反映されます

フォルダ & レーベル指定

   <label dir="■■" name="■■">

data タグ内(<data> </data> の間)に挿入するタグです
この中にさらに下に書くmusic タグ が入ります
"/" は終わりを意味する記号ですので必ず入れてください
ステータスは " "(半角スペース) で区切ります

用意するステータス

ステータス名	説明	例
dir	レーベル略称	dir="knm"
name	レーベル名	name="KNMオリジナル"

※dir に入るものはフォルダ名ですので記号や日本語はおやめください

レーベル って？
いわゆるカテゴリーです
譜面製作者名でまとめたり、イベント名でまとめたり、
例で言えば konami オリジナル曲は「KNMオリジナル」でまとめることで
将来的に簡単に検索ができるようになります
また、同じ楽曲の別製作者譜面などといった場合に
作者レーベルごとに格納されるようになりますので被りを防止することができます

※レーベルについては後々別に記載します

music タグ

<music ■■=""></music>

label タグ内(<label> </label> の間)に挿入するタグです
この中にさらに下に書く譜面難易度 タグ が入ります
■■には各ステータスが入ります
各ステータスは " "(半角スペース) で区切ります

用意するステータス

ステータス名	説明	例
name	曲名	name="Broken"
artist	アーティスト名	artist="dj TAKA feat.AiMEE"
sound	音楽ファイル指定(省略可)	sound="Broken/Broken.mp3"
jacket	画像ファイル指定 (省略可)	jacket="Broken/Broken.jpg"
bpm	BPM	bpm="148"
modification	ファイルの更新日時	modification="2011/3/30"
author	譜面製作者名	author="kotomi"
offset	譜面データ開始から見て曲再生開始位置(ﾐﾘ秒)	offset="650"
end	譜面データ開始から見て曲再生終了位置(小節数)(省略可)	end="30"
download	ダウンロード日時	download="2011/5/11"

※sound : 指定がなかった場合「blank.mp3」が読まれ、無音再生となります

※offset : マイナスも設定できます(程度は要検証)

※end : なかった場合は mp3 が終わったら終了

※曲名・アーティスト名 : 長いと見切れてしまいます(スクロール機能検証中2011/5/15)

※DL日時や更新日時 :
アプリ内でDLする機能があります
譜面が更新されていないか、新しい曲があるかどうか等を簡単にチェックすることができます

譜面指定 & 難易度指定 タグ

   <hard note="■■" difficulty="■■"/>

music タグ内(<music ...> </music> の間)に挿入するタグです
"/" は終わりを意味する記号ですので必ず入れてください
ステータスは " "(半角スペース) で区切ります

用意するステータス

ステータス名	説明	例
note	譜面ファイル指定	note="Broken/Broken.csv"
difficulty	難易度指定	difficulty="10"

ファイル名を "MEDIUM_Broken.csv" "HERD_Broken.csv" など違うもので用意しましょう

書式例

見やすく改行・スペースなどが入っていますのでコピペする際は注意してください

<?xml version="1.0" encoding="utf-8" ?>
<data>
<label dir="knm" name="KNMオリジナル">
 <music name="Broken"
	artist="dj TAKA feat.AiMEE"
	sound="Broken/Broken.mp3"
	jacket="Broken/Broken.jpg"
	bpm="148"
	modification="2011/3/30"
	author="kotomi"
	offset="650"
	download="2011/5/11">
   <hard note="Broken/Broken.csv" difficulty="10"/>
 </music>
</label>
</data>

.....txt by kotomi
.