跳到内容

歌曲信息(songlist)格式:修订间差异

添加8,355字节 、​ 2019年11月10日 (星期日)
无编辑摘要
Izh讨论 | 贡献
(未显示2个用户的45个中间版本)
第1行: 第1行:
{{技术型}}
*<s>等一下你们先让我看一下apk</s>
*<s>等一下你们先让我看一下apk</s>


*'''本页保持孤立!'''
*'''本页保持孤立!'''


==总论==
==在开始阅读之前==
===总论===
 歌曲信息都包含在一个叫做songlist的文件里.位置为\assets\songs
 歌曲信息都包含在一个叫做songlist的文件里.位置为\assets\songs
这个文件是关于更改歌曲信息的,如果想更改谱面本身,请移步[[谱面格式]]
如果想更改关于解歌条件的部分,请移步[[解锁条件(unlocks)格式]]
如果想更改曲包相关内容请移步[[曲包信息(packlist)格式]]


===阅读总论===
===阅读总论===
songlist是按 照<s>类似Java语言</s> 编写的,有大量花括号与中括号,中间的回车与制表符除了整理版面之外没有任何意义.'''总之不该你改的东西你不要改就行了'''.
songlist是按 照json格式 编写的,有大量花括号与中括号,中间的回车与制表符除了整理版面之外没有任何意义.'''总之不该你改的东西你不要改就行了'''.
 
==代码解析==
===框架===
歌曲信息在文件里总体排列成这样
 
{| class="wikitable"
|-
| <nowiki>{"songs": [{歌曲信息1},{歌曲信息2},……,{歌曲信息n}]}</nowiki>
|}
 
可见歌曲信息之间的互不干扰性,<s>而且它告诉我们'''加入自制谱(不是替换官谱)'''是可能的</s>.'''任何较大的改动都会使arc崩溃.'''
 
===细节解析===
 
以一个最复杂的为例(笑)
 
  {
    "id": "solitarydream",
    "title_localized": {
     "en": "Solitary Dream",
     "ja": "虚空の夢"
    },
    "jacket_localized": {
     "ja": true
    },
    "artist": "ak+q feat. Sennzai",
    "bpm": "162",
    "bpm_base": 162,
    "set": "core",
    "purchase": "core",
    "audioPreview": 49629,
    "audioPreviewEnd": 68148,
    "side": 0,
    "bg": "solitarydream",
    "remote_dl": true,
    "world_unlock": true,
    "date": 1552089600,
    "difficulties": [
     {
      "ratingClass": 0,
      "chartDesigner": "",
      "jacketDesigner": "シエラ",
      "rating": 4
     },
     {
      "ratingClass": 1,
      "chartDesigner": "",
      "jacketDesigner": "シエラ",
      "rating": 7
     },
     {
      "ratingClass": 2,
      "chartDesigner": "",
      "jacketDesigner": "シエラ",
      "rating": 8
     }
    ]
   }
 
好了让我们忘掉上面的东西,<s>反正上面的东西又不全</s>
 
真正归纳起来是这样的
 
 
  {
    "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": 加入时的系统时间,
    "remote_dl": remoteDLBoolean,
    "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": 加入时的系统时间,
    "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时间戳]<s>或者打开CE查看explorer.exe……</s>
*remoteDLBoolean(false,true):该曲目是否需要远程下载,true为是,false为否.'''如果为true,预览音频在对应文件夹里,相应谱面文件夹里也没有音频文件''',<s>相信你们都知道该干什么</s>,'''可删除'''.
*source(ansistring):本曲的来源,'''一般只填en以让所有语言看见'''。在显示时由中文书名号(《》)括起。'''可删除'''。
*©copyright(ansistring):本曲所属版权。在显示时在中文书名号(《》)后面。'''可删除'''。
 
====难度文件解析====
难度谱面信息框架如下
{| class="wikitable"
|-
| "difficulties": [{PST信息},{PRS信息},{FTR信息}]
|}
 
各难度代码结构如下
{| class="wikitable"
|-
|
    {
     "ratingClass": ratingClass,
     "chartDesigner": "chartDesigner",
     "jacketDesigner": "illustrator",
     "rating": rating,
     "plusFingers": plusFingersBoolean,
      "jacketOverride": jacketOverrideBoolean
    }
|}
 
*ratingClass(0,1,2):本段代码对应的难度,0=PST,1=PRS,2=FTR
*chartDesigner(ansistring):谱师名,'''可以填任何字符'''
*illustrator(ansistring):封面图作者,'''可以填任何字符''',可留空
*rating(0,1,2,……,11):本谱难度,从0~11分别对应''?'',1,2,……,9+,10.'''请不要瞎填'''.
*plusFingersBoolean(0,1):<s>加一根手指</s>,目前尚不清楚该参数含义,据猜测可能是多点触控开关,0为关,1为开.尚不清楚之间的差别.
*jacketOverrideBoolean(false,true):标识本难度是否独占封面图,是true否false,'''可删除'''
 
==综合==
如果你在做完自制谱之后,采取的是替换原信息(不改ID)的方式导入的话,你也许还能登录游玩.
 
'''如果你采取了添加的方式,那么你的arc绝对不能登录''',因为arc登录后会校验歌单.'''进而导致封号风险'''.
 
从这里开始就会涉及到危险操作了,'''请为自己的行为负责!'''
1

个编辑