歌曲信息(songlist)格式:修订间差异
(→细节解析) |
无编辑摘要 |
||
(未显示5个用户的45个中间版本) | |||
第1行: | 第1行: | ||
{{技术型}} | |||
*'''本页保持孤立!''' | *'''本页保持孤立!''' | ||
第5行: | 第5行: | ||
==在开始阅读之前== | ==在开始阅读之前== | ||
===总论=== | ===总论=== | ||
歌曲信息都包含在一个叫做songlist的文件里 | 歌曲信息都包含在一个叫做songlist的文件里 。在安卓apk安装包里的 位置为 \assets\songs\songlist. | ||
这个文件是关于更改歌曲信息的,如果想更改谱面本身,请移步[[谱面格式]] | 这个文件是关于更改歌曲信息的,如果想更改谱面本身,请移步[[谱面格式]] | ||
第14行: | 第14行: | ||
===阅读总论=== | ===阅读总论=== | ||
songlist | songlist 使用json格式,有大量花括号与中括号, 格式要求较为严格。 中间的回车与制表符除了整理版面之外没有任何意义 。 | ||
<s>任何对本文件 的 修 改 都会游戏程序崩溃,这是因为程序中对这几个信息文件做 了 哈希校验。</s> | |||
==代码解析== | ==代码解析== | ||
第20行: | 第22行: | ||
歌曲信息在文件里总体排列成这样 | 歌曲信息在文件里总体排列成这样 | ||
{ | { | ||
"songs": [ | |||
{ | |||
歌曲信息1 | |||
}, | |||
{ | |||
歌曲信息2 | |||
},……, | |||
{ | |||
歌曲信息n | |||
} | |||
] | |||
} | |||
可见歌曲信息之间的互不干扰性。 | |||
===细节解析=== | ===细节解析=== | ||
{ | { | ||
"id": " | "id": "id", | ||
"title_localized": { | "title_localized": { | ||
"en": " | "en": "title" | ||
"ja": "日本語の表記" | |||
}, | }, | ||
"artist": " | "artist": "artist", | ||
"bpm": " | "bpm": "BPM", | ||
"bpm_base": | "bpm_base": BPM_Base, | ||
"set": " | "set": "setpack", | ||
"purchase": " | "purchase": "purchasemethod", | ||
"audioPreview": | "audioPreview": Preview1, | ||
"audioPreviewEnd": | "audioPreviewEnd": Preview2, | ||
"side": | "side": side, | ||
"world_unlock": | "world_unlock": worldBoolean, | ||
"bg": " | "no_pp": ppBoolean, | ||
"date": | "bg": "setBG", | ||
"date": time, | |||
"remote_dl": remoteDLBoolean, | |||
"byd_local_unlock": bydBoolean, | |||
"version": version, | |||
"songlist_hidden": hiddenBoolean, | |||
"source_localized": { | |||
"en": "source" | |||
}, | |||
"source_copyright": "©copyright", | |||
"difficulties": [ | "difficulties": [ | ||
{ | { | ||
"ratingClass": 0, | "ratingClass": 0(ratingClass), | ||
"chartDesigner": " | "chartDesigner": "chartDesigner", | ||
"jacketDesigner": " | "jacketDesigner": "illustrator", | ||
"rating": | "rating": rating, | ||
"plusFingers": | "plusFingers": plusFingersBoolean, | ||
}, | }, | ||
{ | { | ||
"ratingClass": 1, | "ratingClass": 1(ratingClass), | ||
"chartDesigner": " | "chartDesigner": "chartDesigner", | ||
"jacketDesigner": " | "jacketDesigner": "illustrator", | ||
"rating": | "rating": rating, | ||
"plusFingers": | "plusFingers": plusFingersBoolean, | ||
}, | }, | ||
{ | { | ||
"ratingClass": 2, | "ratingClass": 2(ratingClass), | ||
"chartDesigner": " | "chartDesigner": "chartDesigner", | ||
"jacketDesigner": " | "jacketDesigner": "illustrator", | ||
"rating": | "rating": rating, | ||
"plusFingers": | "plusFingers": plusFingersBoolean, | ||
} | } | ||
] | ] | ||
} | } | ||
====文件头==== | |||
{ | |||
"id": "id", | |||
"title_localized": { | |||
"en": "title" | |||
"ja": "日本語の表記" | |||
}, | |||
"artist": "artist", | |||
"bpm": "BPM", | |||
"bpm_base": BPM_Base, | |||
"set": "setpack", | |||
"purchase": "purchasemethod", | |||
"audioPreview": Preview1, | |||
"audioPreviewEnd": Preview2, | |||
"side": side, | |||
"world_unlock": worldBoolean, | |||
"no_pp": ppBoolean, | |||
"bg": "setBG", | |||
"date": time, | |||
"byd_local_unlock": bydBoolean, | |||
"version": version, | |||
"songlist_hidden": hiddenBoolean, | |||
"remote_dl": remoteDLBoolean, | |||
"source_localized": { | |||
"en": "source" | |||
}, | |||
"source_copyright": "©copyright", | |||
"difficulties": […… | |||
] | |||
} | |||
*id(ansistring):歌曲ID名,'''至关重要''',像解锁条件等引用歌曲的时候是引用id的,并且对应谱面文件夹也必须是id名,如果是远程下载的曲子,在preview文件夹里放预览音频时,文件名也必须和id一样,'''不能出现非ASCII字符''' | |||
*title_localized(ansistring):长这样 | |||
{| class="wikitable" | |||
|- | |||
| | |||
"title_localized": { | |||
"en": "title", | |||
"ja": "タイトル" | |||
}, | |||
|} | |} | ||
:*其中title是你要填的曲名,"en"是英文,"ja"是日文,"ko"是韩文(从来没出现),"zh-Hans"为简中,"zh-Hant"为繁中,默认语言为英文,'''可以填任何字符''',当出现多个语言时用逗号隔开. | |||
:**jacket_localized类似,不过是关于封面 | |||
*artist(ansistring):曲作者名,没有语言区别,'''可以填任何字符'''. | |||
*BPM(ansistring):向玩家显示本曲的BPM,'''可以填任何字符''',<s>这意味着我填"0-∞"是可以的了</s>. | |||
*BPM_Base:这个要注意一下,'''它表示Hi-Speed最大时用于计算的BPM''',与谱面BPM毫无关联.<s>游玩时,谱面的Hi-Speed不会大于该数值*你的Hi-Speed设置倍数</s>.(AC出现了99999.00的BPM但Base依然170)'''真正的Hi-Speed依然由谱面内的Timing语句决定.''' | |||
**当你的谱面有瞬间出现这样的设计时,'''建议将该数值写成三个谱面文件里出现的最普遍的BPM''',<s>不过当基准BPM≥180时请想想这样做谱面猎奇的可能性</s>. | |||
***<s>以及这个数值就不要傻到填0或负数了,读也许能读,但……</s> | |||
*setpack(ansistring):该曲目所隶属的曲包,请移步[[曲包信息(packlist)格式]] | |||
*purchasemethod(ansistring):该曲的购买方式,如果为曲包名即为购买相应曲包(前提是你已经设定该曲包是要购买的),如为歌曲'''ID'''名即为单曲购买,<s>相信你们都知道该干什么</s>,可留空. | |||
*Preview1,Preview2(ms):预览时间的开始与结束,数字为整数 | |||
*side(0,1):歌曲属性是光(0)还是对立(1),<s>别想了其他的只是背景</s>. | |||
*worldBoolean(false,true):该曲是否需要在world里解锁,true为是,false为不是,<s>相信你们都知道该干什么</s>,'''可删除'''. | |||
*ppBoolean(false,true):在游戏内没有差异性,但只有lowiro没有拿到全部版权的曲目该选项为true,'''可删除''' | |||
*setBG(ansistring):本曲的背景,'''背景文件必须能在\assets\img\bg里找到,不能出现非ASCII字符'''.''可留空''后,游戏自动安排默认。 | |||
**附属属性有bg_daynight, | |||
*date(Time):加入时的系统时间戳,参考[http://tool.chinaz.com/Tools/unixtime.aspx 转换成Unix时间戳] | |||
*remoteDLBoolean(false,true):该曲目是否需要远程下载,true为是,false为否.'''如果为true,预览音频在对应文件夹里,相应谱面文件夹里也没有音频文件''',<s>相信你们都知道该干什么</s>,'''可删除'''. | |||
*bydBoolean(false,true):该曲目的Beyond难度是否能在本地解锁。(实际不起作用)'''可删除''' | |||
*version(ansistring):本曲加入游戏的版本,用于折叠歌曲显示。 | |||
*hiddenBoolean(false,true):标识该曲目是否在歌曲界面中隐藏,通常用于魔王曲解锁'''可删除''' | |||
*source(ansistring):本曲的来源,'''一般只填en以让所有语言看见'''。在显示时由中文书名号(《》)括起。'''可删除'''。 | |||
*©copyright(ansistring):本曲所属版权。在显示时在中文书名号(《》)后面。'''可删除'''。 | |||
====难度文件解析==== | |||
难度谱面信息框架如下 | |||
{| class="wikitable" | |||
|- | |||
| "difficulties": [{PST信息},{PRS信息},{FTR信息}] | |||
|} | |||
各难度代码结构如下 | |||
{| class="wikitable" | |||
|- | |||
| | |||
{ | |||
"ratingClass": ratingClass, | |||
"chartDesigner": "chartDesigner", | |||
"jacketDesigner": "illustrator", | |||
"rating": rating, | |||
"ratingPlus": ratingBoolean, | |||
"plusFingers": plusFingersBoolean, | |||
"jacketOverride": jacketOverrideBoolean, | |||
"hidden_until_unlocked": hiddenBoolean | |||
} | |||
|} | |||
*ratingClass(0,1,2,3):本段代码对应的难度,0=PST,1=PRS,2=FTR,3=BYD | |||
*chartDesigner(ansistring):谱师名,'''可以填任何字符''' | |||
*illustrator(ansistring):封面图作者,'''可以填任何字符''',可留空 | |||
*rating(int):本谱难度,其中0对应''?''。 | |||
*ratingBoolean(false,true):本谱难度是否为“+”,'''可删除''' | |||
*plusFingersBoolean(0,1):<s>加一根手指</s>,目前尚不清楚该参数含义,据猜测可能是多点触控开关,0为关,1为开.尚不清楚之间的差别. | |||
*jacketOverrideBoolean(false,true):标识本难度是否独占封面图,是true否false,'''可删除''' | |||
*hiddenBoolean(false,true):标识本谱子是否在解锁前隐藏,'''可删除''' | |||
==综合== | |||
如果你在做完自制谱之后,采取的是替换原信息(不改ID)的方式导入的话,你也许还能登录游玩. | |||
'''如果你采取了添加的方式,那么你的arc绝对不能登录''',因为arc登录后会校验歌单.'''进而导致封号风险'''. | |||
从这里开始就会涉及到危险操作了,'''请为自己的行为负责!''' |
2020年6月10日 (三) 17:06的版本
此页面本页面为技术型隐藏页面 |
- 本页保持孤立!
在开始阅读之前
总论
歌曲信息都包含在一个叫做songlist的文件里。在安卓apk安装包里的位置为 \assets\songs\songlist.
这个文件是关于更改歌曲信息的,如果想更改谱面本身,请移步谱面格式
如果想更改关于解歌条件的部分,请移步解锁条件(unlocks)格式
如果想更改曲包相关内容请移步曲包信息(packlist)格式
阅读总论
songlist使用json格式,有大量花括号与中括号,格式要求较为严格。中间的回车与制表符除了整理版面之外没有任何意义。
任何对本文件的修改都会游戏程序崩溃,这是因为程序中对这几个信息文件做了哈希校验。
代码解析
框架
歌曲信息在文件里总体排列成这样
{ "songs": [ { 歌曲信息1 }, { 歌曲信息2 },……, { 歌曲信息n } ] }
可见歌曲信息之间的互不干扰性。
细节解析
{ "id": "id", "title_localized": { "en": "title" "ja": "日本語の表記" }, "artist": "artist", "bpm": "BPM", "bpm_base": BPM_Base, "set": "setpack", "purchase": "purchasemethod", "audioPreview": Preview1, "audioPreviewEnd": Preview2, "side": side, "world_unlock": worldBoolean, "no_pp": ppBoolean, "bg": "setBG", "date": time, "remote_dl": remoteDLBoolean, "byd_local_unlock": bydBoolean, "version": version, "songlist_hidden": hiddenBoolean, "source_localized": { "en": "source" }, "source_copyright": "©copyright", "difficulties": [ { "ratingClass": 0(ratingClass), "chartDesigner": "chartDesigner", "jacketDesigner": "illustrator", "rating": rating, "plusFingers": plusFingersBoolean, }, { "ratingClass": 1(ratingClass), "chartDesigner": "chartDesigner", "jacketDesigner": "illustrator", "rating": rating, "plusFingers": plusFingersBoolean, }, { "ratingClass": 2(ratingClass), "chartDesigner": "chartDesigner", "jacketDesigner": "illustrator", "rating": rating, "plusFingers": plusFingersBoolean, } ] }
文件头
{ "id": "id", "title_localized": { "en": "title" "ja": "日本語の表記" }, "artist": "artist", "bpm": "BPM", "bpm_base": BPM_Base, "set": "setpack", "purchase": "purchasemethod", "audioPreview": Preview1, "audioPreviewEnd": Preview2, "side": side, "world_unlock": worldBoolean, "no_pp": ppBoolean, "bg": "setBG", "date": time, "byd_local_unlock": bydBoolean, "version": version, "songlist_hidden": hiddenBoolean, "remote_dl": remoteDLBoolean, "source_localized": { "en": "source" }, "source_copyright": "©copyright", "difficulties": […… ] }
- id(ansistring):歌曲ID名,至关重要,像解锁条件等引用歌曲的时候是引用id的,并且对应谱面文件夹也必须是id名,如果是远程下载的曲子,在preview文件夹里放预览音频时,文件名也必须和id一样,不能出现非ASCII字符
- title_localized(ansistring):长这样
"title_localized": { "en": "title", "ja": "タイトル" }, |
- 其中title是你要填的曲名,"en"是英文,"ja"是日文,"ko"是韩文(从来没出现),"zh-Hans"为简中,"zh-Hant"为繁中,默认语言为英文,可以填任何字符,当出现多个语言时用逗号隔开.
- jacket_localized类似,不过是关于封面
- 其中title是你要填的曲名,"en"是英文,"ja"是日文,"ko"是韩文(从来没出现),"zh-Hans"为简中,"zh-Hant"为繁中,默认语言为英文,可以填任何字符,当出现多个语言时用逗号隔开.
- artist(ansistring):曲作者名,没有语言区别,可以填任何字符.
- BPM(ansistring):向玩家显示本曲的BPM,可以填任何字符,
这意味着我填"0-∞"是可以的了. - BPM_Base:这个要注意一下,它表示Hi-Speed最大时用于计算的BPM,与谱面BPM毫无关联.
游玩时,谱面的Hi-Speed不会大于该数值*你的Hi-Speed设置倍数.(AC出现了99999.00的BPM但Base依然170)真正的Hi-Speed依然由谱面内的Timing语句决定.- 当你的谱面有瞬间出现这样的设计时,建议将该数值写成三个谱面文件里出现的最普遍的BPM,
不过当基准BPM≥180时请想想这样做谱面猎奇的可能性.以及这个数值就不要傻到填0或负数了,读也许能读,但……
- 当你的谱面有瞬间出现这样的设计时,建议将该数值写成三个谱面文件里出现的最普遍的BPM,
- setpack(ansistring):该曲目所隶属的曲包,请移步曲包信息(packlist)格式
- purchasemethod(ansistring):该曲的购买方式,如果为曲包名即为购买相应曲包(前提是你已经设定该曲包是要购买的),如为歌曲ID名即为单曲购买,
相信你们都知道该干什么,可留空. - Preview1,Preview2(ms):预览时间的开始与结束,数字为整数
- side(0,1):歌曲属性是光(0)还是对立(1),
别想了其他的只是背景. - worldBoolean(false,true):该曲是否需要在world里解锁,true为是,false为不是,
相信你们都知道该干什么,可删除. - ppBoolean(false,true):在游戏内没有差异性,但只有lowiro没有拿到全部版权的曲目该选项为true,可删除
- setBG(ansistring):本曲的背景,背景文件必须能在\assets\img\bg里找到,不能出现非ASCII字符.可留空后,游戏自动安排默认。
- 附属属性有bg_daynight,
- date(Time):加入时的系统时间戳,参考转换成Unix时间戳
- remoteDLBoolean(false,true):该曲目是否需要远程下载,true为是,false为否.如果为true,预览音频在对应文件夹里,相应谱面文件夹里也没有音频文件,
相信你们都知道该干什么,可删除. - bydBoolean(false,true):该曲目的Beyond难度是否能在本地解锁。(实际不起作用)可删除
- version(ansistring):本曲加入游戏的版本,用于折叠歌曲显示。
- hiddenBoolean(false,true):标识该曲目是否在歌曲界面中隐藏,通常用于魔王曲解锁可删除
- source(ansistring):本曲的来源,一般只填en以让所有语言看见。在显示时由中文书名号(《》)括起。可删除。
- ©copyright(ansistring):本曲所属版权。在显示时在中文书名号(《》)后面。可删除。
难度文件解析
难度谱面信息框架如下
"difficulties": [{PST信息},{PRS信息},{FTR信息}] |
各难度代码结构如下
{ "ratingClass": ratingClass, "chartDesigner": "chartDesigner", "jacketDesigner": "illustrator", "rating": rating, "ratingPlus": ratingBoolean, "plusFingers": plusFingersBoolean, "jacketOverride": jacketOverrideBoolean, "hidden_until_unlocked": hiddenBoolean } |
- ratingClass(0,1,2,3):本段代码对应的难度,0=PST,1=PRS,2=FTR,3=BYD
- chartDesigner(ansistring):谱师名,可以填任何字符
- illustrator(ansistring):封面图作者,可以填任何字符,可留空
- rating(int):本谱难度,其中0对应?。
- ratingBoolean(false,true):本谱难度是否为“+”,可删除
- plusFingersBoolean(0,1):
加一根手指,目前尚不清楚该参数含义,据猜测可能是多点触控开关,0为关,1为开.尚不清楚之间的差别. - jacketOverrideBoolean(false,true):标识本难度是否独占封面图,是true否false,可删除
- hiddenBoolean(false,true):标识本谱子是否在解锁前隐藏,可删除
综合
如果你在做完自制谱之后,采取的是替换原信息(不改ID)的方式导入的话,你也许还能登录游玩.
如果你采取了添加的方式,那么你的arc绝对不能登录,因为arc登录后会校验歌单.进而导致封号风险.
从这里开始就会涉及到危险操作了,请为自己的行为负责!