跳至內容

「歌曲信息(songlist)格式」：修訂間差異

歌曲信息(songlist)格式 (查看原始碼)

於 2020年12月27日 (日) 16:25 的修訂

增加 159 位元組 、​ 2020年12月27日 (星期日)
無編輯摘要
無編輯摘要
（未顯示由 7 位使用者於中間所作的 28 次修訂）
第1行： 第1行：
{{技术型}}
<!--如果你通过查看源代码发现了这里，那么恭喜你发现了查看内容的第二种方法。
 
-->{{技术型}}
*<s>等一下你们先让我看一下apk</s>
__NOINDEX__


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


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


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


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


===阅读总论===
===阅读总论===
songlist是按照json格式编写的,有大量花括号与中括号,中间的回车与制表符除了整理版面之外没有任何意义.'''总之不该你改的东西你不要改就行了'''.


==代码解析==
  本文件名为songlist，包含了除教程及愚人节外的全部 歌曲 相关 信息 。
===框架===
 歌曲信息 在文件里总体排列成这样


{| class="wikitable"
本文件在安卓apk安装包里的位置为 \assets\songs\songlist，在苹果ipa安装包内位置为 \Payload\Arc-mobile.app\songs\songlist
|-
| <nowiki>{"songs": [{歌曲信息1},{歌曲信息2},……,{歌曲信息n}]}</nowiki>
|}


  可见歌曲信息之间的互 不 干扰性,<s>而且它告诉我们'''加入自制谱(不是替换官谱)'''是可 能的</s>.'''任何较大的改动都会使arc崩溃.'''
  本文件为json文档，有大量花括号与中括号，格式要求较为严格，最后一个字段后 不能 出现多余 的 逗号。本文件用两空格缩进整理版面。


===细节解析===
'''任何对本文件的修改都会导致游戏程序崩溃，这是因为程序中对本文件有哈希校验。'''


以一个最复杂 的为 例(笑)
'''从这里开始就会涉及到危险操作了,请为自己 的 行 为 负责!'''


  我得想一想拿什么例子
==代码解析==


好了让我们忘掉上面的东西,我怕你们看完后直接不看了#(滑稽)
===框架===


  真正归纳起来是这样 的
  本文件总体框架如下。每一首歌曲 的 信息互不干扰。


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


  {
=== 细节解析===
    "id": "id",
    "title_localized": {
     "en": "title"
    },
    "artist": "artist",
    "bpm": "BPM",
    "bpm_base": BPM_Base,
    "set": "setpack",
    "purchase": "purchasemethod",
    "audioPreview": Preview1,
    "audioPreviewEnd": Preview2,
    "side": side,
    "world_unlock": worldBoolean,
    "bg": "setBG",
    "date": 加入时的系统时间,
    "remote_dl": remoteDLBoolean,
    "difficulties": [
     {
      "ratingClass": 0(ratingClass),
      "chartDesigner": "chartDesigner",
      "jacketDesigner": "illustrator",
      "rating": rating,
      "plusFingers": plusFingersBoolean,
      "story": {
       "en": "English Story [PST]",
       "ja": "日本語の物語 [PST]"
      }
     },
     {
      "ratingClass": 1(ratingClass),
      "chartDesigner": "chartDesigner",
      "jacketDesigner": "illustrator",
      "rating": rating,
      "plusFingers": plusFingersBoolean,
      "story": {
       "en": "English Story [PRS]",
       "ja": "日本語の物語 [PRS]"
      }
     },
     {
      "ratingClass": 2(ratingClass),
      "chartDesigner": "chartDesigner",
      "jacketDesigner": "illustrator",
      "rating": rating,
      "plusFingers": plusFingersBoolean,
      "story": {
       "en": "English Story [FTR]",
       "ja": "日本語の物語 [FTR]"
      }
     }
    ]
   }
 
希望大家能看出来哪些是变量(笑)
 
 
====文件头====
 
 
  {
    "id": "id",
    "title_localized": {
     "en": "title"
    },
    "artist": "artist",
    "bpm": "BPM",
    "bpm_base": BPM_Base,
    "set": "setpack",
    "purchase": "purchasemethod",
    "audioPreview": Preview1,
    "audioPreviewEnd": Preview2,
    "side": side,
    "world_unlock": worldBoolean,
    "bg": "setBG",
    "date": 加入时的系统时间,
    "remote_dl": remoteDLBoolean,
    "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>,'''可删除'''.


setBG(ansistring):本曲的背景,'''背景文件必须能在\assets\img\bg里找到,不能出现非ASCII 字符'''.''可留空''后，游戏自动安排默认。
*数据格式：
**string --  字符 串 例："brandnewworld"
**int -- 整数 例：54401
**boolean -- 布朗值 例：true（是）, false（否）


date(Time):加入时的系统时间,至于真正该填什么请将当前时间转换成秒数<s>或者打开CE查看explorer.exe……</s>
*localized字段可选属性：
**"en" -- 英文 '''默认语言'''
**"ja" -- 日文
**"ko" -- 韩文
**"zh-Hans" -- 简体中文
**"zh-Hant" -- 繁体中文


remoteDLBoolean(false,true):该曲目是否需要远程 下 载,true 为 是,false为否.'''如果为true,预览音频在对应文件夹里,相应谱面文件夹里也没有音频文件''',<s>相 信 你们都知道该干什么</s>,'''可删除'''.
以 下为 歌曲 信 息最完整的格式。


====难度文件解析====
{
难度谱面信息框架如下
  "id": string (ASCII),
{| class="wikitable"
  "title_localized": {
|-
   "en": string ...
| "difficulties": [{PST信息},{PRS信息},{FTR信息}]
  },
|}
  "artist": string,
  "artist_localized": {
   "en": string ...
  },
  "bpm": string,
  "bpm_base": int,
  "set": string,
  "purchase": string,
  "audioPreview": int,
  "audioPreviewEnd": int,
  "side": int (0, 1),
  "bg": 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,
    "jacket_night": string (ASCII),
    "jacketOverride": boolean,
    "hidden_until_unlocked": boolean,
    "bg": string (ASCII),
    "world_unlock": boolean
   } ...
  ]
}


各难度代码结构如下
====歌曲信息====
{| class="wikitable"
|-
|
    {
     "ratingClass": ratingClass,
     "chartDesigner": "chartDesigner",
     "jacketDesigner": "illustrator",
     "rating": rating,
     "plusFingers": plusFingersBoolean,
     "story": {
      "en": "English Story",
      "ja": "日本語の物語"
     }
    }
|}


ratingClass(0,1,2):本 段 代码对应 的 难度,0=PST,1=PRS,2=FTR
注：以下'''必需字 段'''指官方songlist文件中每首歌都有 的 字段，删除后是否会导致游戏崩溃并未经测试。


chartDesigner(ansistring): 谱师 名,''' 可 以填 任何 字符'''
{
  "id": string (ASCII),
   // 游戏程序识别歌曲的唯一ID '''只能使用ASCII字符''' '''必需字段'''
 
  "title_localized": {
   "en": string,
   "ja": string ...
  },
   // 游戏内显示的曲 名 ，可分语言设定 '''必需字段'''
 
  "artist": string,
  "artist_localized": {
   "en": string ...
  },// 游戏内显示的作曲者，可分语言设定。可只填artist，默认为英语 ''' 必需字段'''
  "bpm": string,
   // 游戏内显示的BPM '''必需字段'''
  "bpm_base": int,
   // 基准BPM，实际游玩速度为设置的音符流速除以"bpm_base"再乘 以 谱面bpm '''必需字段'''
 
  "set": string,
   // 本曲所属曲包名，参考[[曲包信息(packlist)格式]] '''必需字段'''
 
  "purchase": string,
   // 本曲购买方式，曲包曲填所属曲包名，单曲 填 本曲"id"，无需购买则留空 '''必需字段'''
 
  "audioPreview": int,
  "audioPreviewEnd": int,
   // 本曲预览的开始与结束时间，单位为毫秒 '''必需字段'''
 
  "side": int (0, 1),
   // 本曲属性，0为光侧，1为对立侧 '''必需字段'''
 
  "bg": string (ASCII),
   // 本曲背景名，背景jpg储存在\assets\img\bg目录中，留空即为默认背景 '''只能使用ASCII字符''' '''必需字段'''
 
  "bg_daynight": {
    "day": string (ASCII),
    "night": string (ASCII)
  },// 自定义白天及夜晚显示的不同背景，参考 [[群愿|群愿]] 的技能 '''只能使用ASCII 字符'''
 
  "date": int (timestamp),
   // 本曲加入时刻的10位时间戳 '''必需字段'''
 
  "version": string,
   // 本曲加入时的游戏版本，用于歌曲分类 '''必需字段'''
 
  "world_unlock": boolean,
   // 本曲是否需要世界模式解锁
 
  "remote_dl": boolean,
   // 本曲是否需要从服务器下载
 
  "byd_local_unlock": boolean,
   // 本曲Beyond难度是否在本地解锁。应与"world_unlock"相反
 
  "songlist_hidden": boolean,
   // 本曲解锁前是否歌曲界面中隐藏
 
  "no_pp": boolean,
   // 标记lowiro是否拥有本曲的版权。本字段对游戏没有影响
 
  "source_localized": {
   "en": string ...
  },// 本曲出处，可分语言设定。歌曲界面中选择歌曲后，歌曲下方会显示 from 「"source_localized"」（其他语言）/《》（中文）
 
  "source_copyright": string,
   // 本曲版权方，仅当"source_localized"不为空时显示在 from 「」之后


illustrator(ansistring):封面 图作者,''' 可 以填任何字符''',可留空
  "no_stream": boolean,
   // 本曲是否能够在直播模式中游玩
 
  "jacket_localized": {
   "ja": boolean ...
  },// 自定义本曲 封面 ， 可 分语言设定。封面文件名为base_ja.jpg，base_ja_256.jpg（即在base后加“_语言代码”）
}


rating(0,1,2,……,11):本谱 难度,从0～11分别对应''?'',1,2,……,9+,10.'''请不要瞎填'''.
==== 难度 信息====


plusFingersBoolean(0,1):<s>加一根手指</s>,目前尚不清楚该参数含义,据猜测可能是多点触控开关,0为关,1为开.尚不清楚之间的差别.
难度谱面信息框架如下：


==综合==
  "difficulties": [
如果你在做完自制谱之后,采取的是替换原信息(不改ID)的方式导入的话,你也许还能登录游玩.
   {
    // difficulty PST
   } ...
  ]


''' 如 果你采取了添加的方式,那么你的arc绝对不能登录''',因为arc登录后会校验歌单.'''进而导致封号风险'''.
各难度代码结构 如 下：


  从这里开始就会涉及到危险 操作 了,''' 请 为自 己的行为负责!'''
   {
    "ratingClass": int (0, 1, 2, 3),
     // 本段代码所定义难度。0 -- PST, 1 -- PRS, 2 -- FTR, 3 -- BYD '''必需字段''' ''3.0修改''
   
    "chartDesigner": string,
     // 本难度谱师名 '''必需字段'''
   
    "jacketDesigner": string,
     // 本难度封面绘师 '''必需字段'''
   
    "rating": int,
     // 本难度等级。3.0更新前1-9对应本身，10对应9+，11对应10；3.0更新后均为本身。0均对应?  '''必需字段''' ''3.0修改''
   
    "ratingPlus": boolean,
     // 本难度等级是否有“+” ''3.0新增''
   
    "plusFingers": boolean,
     // 本难度是否有多指 操作 ，实际并无作用
   
    "jacket_night": string (ASCII),
     // 本难度夜晚时显示的封面文件名 ''' 只能使用ASCII字符'''
   
    "jacketOverride": boolean,
     // 本难度是否有根据难度替换的封面。封面文件名为0.jpg，0_256.jpg（即 为"ratingClass"）
   
    "hidden_until_unlocked": boolean,
     // 本难度解锁前是否歌曲界面中隐藏 ''3.0新增''
   
    "bg": string (ASCII),
     //  自 定义本难度背景名，背景jpg储存在\assets\img\bg目录中 '''只能使用ASCII字符'''
   
    "world_unlock": boolean
     // 本难度是否需要世界模式解锁，尚无法使用
   }
{{Usercheck-end}}
Chronowar
常驻人员
4,295

次編輯

取自 "https://arcwiki.mcd.blue/Special:移动版差异/4898...21445"