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

来自Arcaea中文维基
(撤销Sccrea讨论)的版本48338)
标签撤销
 
(未显示22个用户的46个中间版本)
第1行: 第1行:
{{技术型}}
<!--如果你通过查看源代码发现了这里,那么恭喜你发现了查看内容的第二种方法。
 
-->{{技术型}}
*<s>等一下你们先让我看一下apk</s>
__NOINDEX__


{{Usercheck}}
{{特殊页面导航}}
*'''本页保持孤立!'''
*'''本页保持孤立!'''


==在开始阅读之前==
==在开始阅读之前==
===总论===
===总论===
歌曲信息都包含在一个叫做songlist的文件里.位置为\assets\songs


  这个 文件是关于更改歌曲信息的,如果想更改 谱面本身, 请移步[[谱面格式]]
  文件是关于更改歌曲信息的
 
关于 谱面本身 的格式, 请移步[[谱面格式]]


  如果想更改 关于解歌条件的部分, 请移步[[解锁条件(unlocks)格式]]
 关于解歌条件的部分 请移步[[解锁条件(unlocks)格式]]


  如果想更改 曲包相关内容请移步[[曲包信息(packlist)格式]]
  关于 曲包相关内容 请移步[[曲包信息(packlist)格式]]


===阅读总论===
===阅读总论===
songlist 是按照json格式编写的, 有大量花括号与中括号,中间 回车与制表符除了 整理版面 之外没有 任何 意义.''' 总之不该你 改的 东西你 要改 就行 '''.
 
本文件名为songlist,包含了除教程及愚人节外的全部歌曲相关信息。
 
本文件在安卓apk安装包里的位置为 /assets/songs/songlist,在苹果ipa安装包内位置为 /Payload/Arc-mobile.app/songs/songlist
 
本文件为json文档, 有大量花括号与中括号 ,格式要求较为严格,最后一个字段后不能出现多余 逗号。本文件用两空格缩进 整理版面
 
''' 任何 对本文件的修改都会导致游戏程序崩溃,这是因为程序中对本文件有哈希校验。'''
 
'' 事实上,可通过修 特定 函数,使程序在哈希校验失败时 调用结束进程的函数,从而达到修改songlist等文件的目的。''
 
'''从这里开始 会涉及到危险操作了,请为自己的 为负责!'''
 
<!-- 事实上,游戏程序中所判断的校验值是将文件的MD5复制一份(即"MD5MD5")然后将该字符串再次求MD5校验值得到的。
例如,对于Arcaea 3.5.3c版本,songlist文件的MD5校验码是a9e8ddcaaf2daa73fc0ba91cfb371f70
则复制一份并拼到原始MD5后面,得到"a9e8ddcaaf2daa73fc0ba91cfb371f70a9e8ddcaaf2daa73fc0ba91cfb371f70"
对该字符串求MD5校验值,可得到"942951c9a95cc3a3694c8c8c27f5293a"
而942951c9a95cc3a3694c8c8c27f5293a正是游戏程序中所使用的校验值
因此直接修改游戏程序中为songlist文件修改后所得到的校验值也可以,但比较麻烦(每次修改songlist都需要改一次程序)
-->


==代码解析==
==代码解析==
===框架===
===框架===
歌曲信息在文件里总体排列成这样


{| class="wikitable"
本文件总体框架如下。每一首 歌曲 息互不干扰。
|-
| <nowiki>{"songs": [{ 歌曲信 息1},{歌曲信息2},……,{歌曲信息n}]}</nowiki>
|}


可见歌曲信息之间的互不干扰性,<s> 而且它告诉我们'''加入自制谱(不是替换官谱)'''是可能的</s>.'''任何较大的改动都会使arc崩溃.'''
<syntaxhighlight lang="json">
{
  "songs": [
   {
    // song 1
   },
   {
    // song 2
   } ...
  ]
}
</syntaxhighlight>


===细节解析===
===细节解析===


  以一个最复杂的为 (笑)
*数据格式:
**string -- 字符串 例:<code>"brandnewworld"</code>
**int -- 整数 例:<code>54401</code>
**boolean -- 布尔值 :<code>true</code>(是), <code>false</code>(否)


  {
*localized字段可选属性:
    "id": "solitarydream",
**"en" -- 英文 '''如果其他语言的字段不存在,默认使用此字段'''
    "title_localized": {
**"ja" -- 日文
     "en": "Solitary Dream",
**"ko" -- 韩文
     "ja": "虚空の夢"
**"zh-Hans" -- 简体中文
    },
**"zh-Hant" -- 繁体中文
    "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>
  以下为歌曲信息最完整 格式。
''(歌曲信息中每一项 填写可以乱序,没有顺序要求)''


  真正归纳起来是这样的
  {
  "idx": int,
  "id": string (ASCII),
  "title_localized": {
   "en": string ...
  },
  "artist": string,
  "artist_localized": {
   "en": string ...
  },
  "bpm": string,
  "bpm_base": float,
  "set": string,
  "purchase": string,
  "audioPreview": int,
  "audioPreviewEnd": int,
  "side": int (0, 1, 2),
  "bg": string (ASCII),
  "bg_inverse": string (ASCII)
  "bg_daynight": {
    "day": string (ASCII),
    "night": string (ASCII)
  },
  "date": int (timestamp),
  "version": string,
  "world_unlock": boolean,
  "remote_dl": boolean,
  "byd_local_unlock": boolean,
  "songlist_hidden": boolean,
  "no_pp": boolean,
  "source_localized": {
   "en": string ...
  },
  "source_copyright": string,
   "no_stream": boolean,
  "jacket_localized": {
   "ja": boolean ...
  },
  "difficulties": [
   {
    "ratingClass": int (0, 1, 2, 3),
    "chartDesigner": string,
    "jacketDesigner": string,
    "rating": int,
    "ratingPlus": boolean,
    "plusFingers": boolean,
    "title_localized": {
     "en": string ...
    },
    "jacket_night": string (ASCII),
    "jacketOverride": boolean,
    "audioOverride": boolean,
    "hidden_until_unlocked": boolean,
    "bg": string (ASCII),
    "world_unlock": boolean,
    "date": int (timestamp),
    "version": string (ASCII)
   } ...
  ]
}


====歌曲信息====


  {
  注:以下'''必需字段'''指官方songlist文件中每首歌都有 字段,删除后是否会导致游戏崩溃并未经测试。
    "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,
     }
    ]
   }


  希望大 家能 看出来哪 是变量( )
  {
  "idx": int,
   // 游戏内"Link Play"功能用来判断各玩 歌曲解锁情况时用的唯一标识符 '''必需字段'''
 
  "id": string (ASCII),
   // 游戏程序识别歌曲的唯一ID '''只 使用ASCII字符''' '''必需字段'''
 
  "title_localized": {
   "en": string,
   "ja": string ...
  },// 游戏内显示的曲名,可分语言设定 '''必需字段'''
 
  "artist": string,
  "artist_localized": {
   "en": string ...
  },// 游戏内显示的作曲者,可分语言设定。可只填artist,默认为英语 '''必需字段'''
 
  "bpm": string,
   // 游戏内显示的BPM '''必需字段'''<!--一 额外的曲目信息可以放在此字符串内-->
 
  "bpm_base": float,
   // 基准BPM,实际游玩速度为设置的音符流速除以"bpm_base"再乘以谱面Timing bpm '''必需字段'''
 
  "set": string,
   // 本曲所属曲包id,参考[[曲包信息(packlist)格式]] '''必需字段'''
 
  "purchase": string,
   // 本曲购买方式,曲包曲填所属曲包名,单曲填本曲"id",无需购买则留空 '''必需字段'''
 
  "audioPreview": int,
  "audioPreviewEnd": int,
   // 本曲预览的开始与结束时间,单位为毫秒 '''必需字段'''
 
  "side": int (0, 1, 2),
   // 本曲属性,0为光芒侧,1为纷争侧,2为消色之侧 '''必需字段'''
 
  "bg": string (ASCII),
   // 本曲背景文件名,背景jpg储存在/assets/img/bg目录中,留空即为默认背景(base_light( 光芒侧) 或base_conflict(纷争侧)) '''只能使用ASCII字符''' '''必需字段'''


  "bg_inverse": string (ASCII),
   // 本曲反转背景文件名,性质同bg,是使用[[光 & 对立(Reunion)]]时更换的背景。可以删去(相对的会使其无法触发)。'''只能使用ASCII字符'''
 
  "bg_daynight": {
    "day": string (ASCII),
    "night": string (ASCII)
  },// 自定义白天及夜晚显示的不同背景,参考 [[群愿]] 的技能 '''只能使用ASCII字符'''
 
  "date": int (timestamp),
   // 本曲加入时刻的10位时间戳 '''必需字段'''
 
  "version": string,
   // 本曲加入时的游戏版本,用于歌曲分类 '''必需字段'''
 
  "world_unlock": boolean,
   // 本曲是否需要世界模式解锁,不填默认为false
 
  "remote_dl": boolean,
   // 本曲是否需要从服务器下载,不填默认为false
 
  "byd_local_unlock": boolean,
   // 本曲Beyond难度是否在本地解锁。应与"world_unlock"相反
 
  "songlist_hidden": boolean,
   // 本曲解锁前是否在歌曲界面中隐藏,不填默认为false
 
  "no_pp": boolean,
   // 标记lowiro是否拥有本曲的版权。本字段对游戏没有影响
 
  "source_localized": {
   "en": string ...
  },// 本曲出处,可分语言设定。歌曲界面中选择歌曲后,歌曲下方会显示 from 「"source_localized"」(其他语言)/来自 《》(中文)
 
  "source_copyright": string,
   // 本曲版权方,仅当"source_localized"不为空时显示在 from 「」之后(以"source_copyright"显示(注意版权标©也在source_copyright的值中))
 
  "no_stream": boolean,
   // 本曲是否能够在直播模式中游玩(目前出现此标识的值均为true)
 
  "jacket_localized": {
   "ja": boolean ...
  },// 自定义本曲封面,可分语言设定。封面文件名为base_ja.jpg,base_ja_256.jpg(即在base后加“_语言代码”)
}


==== 文件头====
==== 难度信息====


难度谱面信息框架如下:


  {
  "difficulties": [
    "id": "id",
   {
    "title_localized": {
    // difficulty PST
     "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"为繁中,默认语言为英文,'''可以填任何字符''',当出现多个语言时用逗号隔开.
*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字符'''.''可留空''后,游戏自动安排默认。
*date(Time):加入时的系统时间,至于真正该填什么请将当前时间转换成秒数<s>或者打开CE查看explorer.exe……</s>
*remoteDLBoolean(false,true):该曲目是否需要远程下载,true为是,false为否.'''如果为true,预览音频在对应文件夹里,相应谱面文件夹里也没有音频文件''',<s>相信你们都知道该干什么</s>,'''可删除'''.
*source(ansistring):本曲的来源,'''一般只填en以让所有语言看见'''。在显示时由中文书名号(《》)括起。'''可删除'''。
*©copyright(ansistring):本曲所属版权。在显示时在中文书名号(《》)后面。'''可删除'''。


==== 难度 文件解析====
   {
 难度谱面 信息框架如下
    "ratingClass": int (0, 1, 2, 3),
{| class="wikitable"
     // 本段代码所定义 难度 。0 -- PST, 1 -- PRS, 2 -- FTR, 3 -- BYD '''必需字段'''
|-
   
| "difficulties": [{PST信息},{PRS信息},{FTR信息}]
    "chartDesigner": string,
|}
     // 难度谱 师名 '''必需字段'''
   
    "jacketDesigner": string,
     // 本难度封 绘师 '''必需字段'''
   
    "rating": int,
     // 本难度等级。3.0更新前1-9对应本身,10对应9+,11对应10;3.0更新后均对应本身。0均对应“?” '''必需字段'''
   
    "ratingPlus": boolean,
     // 本难度等级是否有“+”,不填默认为false ''3.0新增''


各难度代码结构如下
    "plusFingers": boolean,
{| class="wikitable"
      // 本难度是否有多指操作,实际并无作用<ref>官方songlist中最后含有本参数的谱面是[[Ether Strike]] FTR、[[Fracture Ray]] PRS&FTR、[[Grievous Lady]] PRS&FTR、[[DataErr0r]] FTR;[[World Vanquisher]]及以后一些谱面也出现了多押但没有使用本参数</ref>
|-
       
|
    "title_localized": {
    {
       "en": string,
     "ratingClass": ratingClass,
       "ja": string ...
      "chartDesigner": "chartDesigner",
     },// 本难度显示的曲名,可分语言设定
     "jacketDesigner": "illustrator",
     "rating": rating,
     "plusFingers": plusFingersBoolean,
    }
|}


*ratingClass(0,1,2): 段代码对应的 难度,0=PST,1=PRS,2=FTR
    "artist": string,
*chartDesigner(ansistring):谱师名,'''可以填任何字符'''
     //  本难度 显示的作曲者
*illustrator(ansistring): 封面图作者,'''可以填任何字符''',可留空
 
*rating(0,1,2,……,11): 难度, 从0~11分别对应''?'',1,2,……,9+,10.'''请不要瞎填'''.
    "bpm": string,
*plusFingersBoolean(0,1):<s>加一根手指</s>,目前尚不清楚该参数含义,据猜测可能是多点触控开关,0为关,1为开.尚不清楚之间 差别.
     //  本难度 显示的BPM
 
    "bpm_base": float,
     // 本难度 基准BPM


==综合==
    "jacket_night": string (ASCII),
  如果你在做完自制谱之后, 采取 的是替换 原信息( 不改ID)的 方式导入的话,你也许还能登 游玩.
     // 本难度夜晚时显示的封面文件名 '''只能使用ASCII字符'''
   
    "jacketOverride": boolean,
     // 本难度是否有根据难度替换 封面。封面文件名为0.jpg,0_256.jpg(即为"ratingClass"),不填默认为false
   
    "audioOverride": boolean,
     // 本难度 否有根据难度 替换 的音频文件。音频文件名为3.ogg(即为"ratingClass"),不填默认为false
   
    "hidden_until_unlocked": boolean,
     // 本难度解锁前是否歌曲界面中隐藏,不填默认为false
   
    "bg": string (ASCII),
     // 本难度 背景,对于安卓apk,背景jpg储存在/assets/img/bg目 中;对于苹果ipa,背景jpg储存在/Payload/Arc-mobile.app/img/bg中 '''只能使用ASCII字符'''


'''如果你采取了添加 ,那么你的arc绝对 能登录''',因为arc登录后会校验歌单.'''进而导致封号风险'''.
    "bg_inverse": string (ASCII),
     // 本难度使用的反转背景,性质同bg,是使用[[光 & 对立(Reunion)]]时更换 背景
   
    "world_unlock": boolean,
     // 本难度是否需要世界模 解锁, 填默认为false


  从这里开始就会涉及到危险操作了,'''请 自己 行为负责!'''
    "date": int (timestamp),
     // 本难度加入时刻的10位时间戳(即单位 秒的UNIX时间戳)
 
    "version": string
     // 本曲加入时 游戏版本,用于歌曲分类
   }
{{reflist}}
{{Usercheck-end}}

2023年12月31日 (日) 11:43的最新版本


在您查看以下内容之前,我们需要您回答我们提供的问题。
ABA型的三字符songid是?
已确认。

  • 本页保持孤立!

在开始阅读之前

总论

本文件是关于更改歌曲信息的。

关于谱面本身的格式,请移步谱面格式

关于解歌条件的部分,请移步解锁条件(unlocks)格式

关于曲包相关内容,请移步曲包信息(packlist)格式

阅读总论

本文件名为songlist,包含了除教程及愚人节外的全部歌曲相关信息。

本文件在安卓apk安装包里的位置为 /assets/songs/songlist,在苹果ipa安装包内位置为 /Payload/Arc-mobile.app/songs/songlist

本文件为json文档,有大量花括号与中括号,格式要求较为严格,最后一个字段后不能出现多余的逗号。本文件用两空格缩进整理版面。

任何对本文件的修改都会导致游戏程序崩溃,这是因为程序中对本文件有哈希校验。

事实上,可通过修改特定的函数,使程序在哈希校验失败时不调用结束进程的函数,从而达到修改songlist等文件的目的。

从这里开始就会涉及到危险操作了,请为自己的行为负责!


代码解析

框架

本文件总体框架如下。每一首歌曲的信息互不干扰。

{
   "songs": [
     {
       // song 1
     },
     {
       // song 2
     } ...
   ]
}

细节解析

  • 数据格式:
    • string -- 字符串 例:"brandnewworld"
    • int -- 整数 例:54401
    • boolean -- 布尔值 例:true(是), false(否)
  • localized字段可选属性:
    • "en" -- 英文 如果其他语言的字段不存在,默认使用此字段
    • "ja" -- 日文
    • "ko" -- 韩文
    • "zh-Hans" -- 简体中文
    • "zh-Hant" -- 繁体中文

以下为歌曲信息最完整的格式。 (歌曲信息中每一项的填写可以乱序,没有顺序要求)

{
  "idx": int,
  "id": string (ASCII),
  "title_localized": {
    "en": string ...
  },
  "artist": string,
  "artist_localized": {
    "en": string ...
  },
  "bpm": string,
  "bpm_base": float,
  "set": string,
  "purchase": string,
  "audioPreview": int,
  "audioPreviewEnd": int,
  "side": int (0, 1, 2),
  "bg": string (ASCII),
  "bg_inverse": string (ASCII)
  "bg_daynight": {
      "day": string (ASCII),
      "night": string (ASCII)
  },
  "date": int (timestamp),
  "version": string,
  "world_unlock": boolean,
  "remote_dl": boolean,
  "byd_local_unlock": boolean,
  "songlist_hidden": boolean,
  "no_pp": boolean,
  "source_localized": {
    "en": string ...
  },
  "source_copyright": string,
   "no_stream": boolean,
  "jacket_localized": {
    "ja": boolean ...
  },
  "difficulties": [
    {
      "ratingClass": int (0, 1, 2, 3),
      "chartDesigner": string,
      "jacketDesigner": string,
      "rating": int,
      "ratingPlus": boolean,
      "plusFingers": boolean,
      "title_localized": {
        "en": string ...
      },
      "jacket_night": string (ASCII),
      "jacketOverride": boolean,
      "audioOverride": boolean,
      "hidden_until_unlocked": boolean,
      "bg": string (ASCII),
      "world_unlock": boolean,
      "date": int (timestamp),
      "version": string (ASCII)
    } ...
  ]
}

歌曲信息

注:以下必需字段指官方songlist文件中每首歌都有的字段,删除后是否会导致游戏崩溃并未经测试。

{
  "idx": int,
    // 游戏内"Link Play"功能用来判断各玩家歌曲解锁情况时用的唯一标识符 必需字段
  
  "id": string (ASCII),
    // 游戏程序识别歌曲的唯一ID 只能使用ASCII字符 必需字段
  
  "title_localized": {
    "en": string,
    "ja": string ...
  },// 游戏内显示的曲名,可分语言设定 必需字段
  
  "artist": string,
  "artist_localized": {
    "en": string ...
  },// 游戏内显示的作曲者,可分语言设定。可只填artist,默认为英语 必需字段
  
  "bpm": string,
    // 游戏内显示的BPM 必需字段
  
  "bpm_base": float,
    // 基准BPM,实际游玩速度为设置的音符流速除以"bpm_base"再乘以谱面Timing bpm 必需字段
  
  "set": string,
    // 本曲所属曲包id,参考曲包信息(packlist)格式 必需字段
  
  "purchase": string,
    // 本曲购买方式,曲包曲填所属曲包名,单曲填本曲"id",无需购买则留空 必需字段
  
  "audioPreview": int,
  "audioPreviewEnd": int,
    // 本曲预览的开始与结束时间,单位为毫秒 必需字段
  
  "side": int (0, 1, 2),
    // 本曲属性,0为光芒侧,1为纷争侧,2为消色之侧 必需字段
  
  "bg": string (ASCII),
    // 本曲背景文件名,背景jpg储存在/assets/img/bg目录中,留空即为默认背景(base_light(光芒侧)或base_conflict(纷争侧)) 只能使用ASCII字符 必需字段
  "bg_inverse": string (ASCII),
    // 本曲反转背景文件名,性质同bg,是使用光 & 对立(Reunion)时更换的背景。可以删去(相对的会使其无法触发)。只能使用ASCII字符
  
  "bg_daynight": {
      "day": string (ASCII),
      "night": string (ASCII)
  },// 自定义白天及夜晚显示的不同背景,参考 群愿 的技能 只能使用ASCII字符
  
  "date": int (timestamp),
    // 本曲加入时刻的10位时间戳 必需字段
  
  "version": string,
    // 本曲加入时的游戏版本,用于歌曲分类 必需字段
  
  "world_unlock": boolean,
    // 本曲是否需要世界模式解锁,不填默认为false
  
  "remote_dl": boolean,
    // 本曲是否需要从服务器下载,不填默认为false
  
  "byd_local_unlock": boolean,
    // 本曲Beyond难度是否在本地解锁。应与"world_unlock"相反
  
  "songlist_hidden": boolean,
    // 本曲解锁前是否在歌曲界面中隐藏,不填默认为false
  
  "no_pp": boolean,
    // 标记lowiro是否拥有本曲的版权。本字段对游戏没有影响
  
  "source_localized": {
    "en": string ...
  },// 本曲出处,可分语言设定。歌曲界面中选择歌曲后,歌曲下方会显示 from 「"source_localized"」(其他语言)/来自 《》(中文)
  
  "source_copyright": string,
    // 本曲版权方,仅当"source_localized"不为空时显示在 from 「」之后(以"source_copyright"显示(注意版权标©也在source_copyright的值中))
  
  "no_stream": boolean,
    // 本曲是否能够在直播模式中游玩(目前出现此标识的值均为true)
  
  "jacket_localized": {
    "ja": boolean ...
  },// 自定义本曲封面,可分语言设定。封面文件名为base_ja.jpg,base_ja_256.jpg(即在base后加“_语言代码”)
}

难度信息

难度谱面信息框架如下:

  "difficulties": [
    {
      // difficulty PST
    } ...
  ]

各难度代码结构如下:

    {
      "ratingClass": int (0, 1, 2, 3),
        // 本段代码所定义难度。0 -- PST, 1 -- PRS, 2 -- FTR, 3 -- BYD 必需字段
      
      "chartDesigner": string,
        // 本难度谱师名 必需字段
      
      "jacketDesigner": string, 
        // 本难度封面绘师 必需字段
      
      "rating": int,
        // 本难度等级。3.0更新前1-9对应本身,10对应9+,11对应10;3.0更新后均对应本身。0均对应“?” 必需字段
      
      "ratingPlus": boolean,
        // 本难度等级是否有“+”,不填默认为false 3.0新增
      "plusFingers": boolean,
        // 本难度是否有多指操作,实际并无作用[1]
             
      "title_localized": {
           "en": string,
           "ja": string ...
       },// 本难度显示的曲名,可分语言设定
      "artist": string,
        // 本难度显示的作曲者
  
      "bpm": string,
        // 本难度显示的BPM
  
      "bpm_base": float,
        // 本难度的基准BPM
      "jacket_night": string (ASCII),
        // 本难度夜晚时显示的封面文件名 只能使用ASCII字符
      
      "jacketOverride": boolean,
        // 本难度是否有根据难度替换的封面。封面文件名为0.jpg,0_256.jpg(即为"ratingClass"),不填默认为false
      
      "audioOverride": boolean,
        // 本难度是否有根据难度替换的音频文件。音频文件名为3.ogg(即为"ratingClass"),不填默认为false
      
      "hidden_until_unlocked": boolean,
        // 本难度解锁前是否歌曲界面中隐藏,不填默认为false
      
      "bg": string (ASCII),
        // 本难度的背景,对于安卓apk,背景jpg储存在/assets/img/bg目录中;对于苹果ipa,背景jpg储存在/Payload/Arc-mobile.app/img/bg中 只能使用ASCII字符
      "bg_inverse": string (ASCII),
        // 本难度使用的反转背景,性质同bg,是使用光 & 对立(Reunion)时更换的背景
      
      "world_unlock": boolean,
        // 本难度是否需要世界模式解锁,不填默认为false
      "date": int (timestamp),
       // 本难度加入时刻的10位时间戳(即单位为秒的UNIX时间戳)
  
      "version": string
       // 本曲加入时的游戏版本,用于歌曲分类
    }
  1. 官方songlist中最后含有本参数的谱面是Ether Strike FTR、Fracture Ray PRS&FTR、Grievous Lady PRS&FTR、DataErr0r FTR;World Vanquisher及以后一些谱面也出现了多押但没有使用本参数