「歌曲信息(songlist)格式」:修訂間差異
(→文件头) |
(→文件头) |
||
(未顯示由 2 位使用者於中間所作的 30 次修訂) | |||
行 1: | 行 1: | ||
{{技术型}} | |||
*<s>等一下你们先让我看一下apk</s> | *<s>等一下你们先让我看一下apk</s> | ||
行 14: | 行 16: | ||
===阅读总论=== | ===阅读总论=== | ||
songlist是按 | songlist是按 照json格式 编写的,有大量花括号与中括号,中间的回车与制表符除了整理版面之外没有任何意义.'''总之不该你改的东西你不要改就行了'''. | ||
==代码解析== | ==代码解析== | ||
行 25: | 行 27: | ||
|} | |} | ||
可见歌曲信息之间的互不干扰性,而且它告诉我们'''加入自制谱(不是替换官谱)'''是可能的 | 可见歌曲信息之间的互不干扰性,<s> 而且它告诉我们'''加入自制谱(不是替换官谱)'''是可能的</s>.'''任何较大的改动都会使arc崩溃.''' | ||
===细节解析=== | ===细节解析=== | ||
行 32: | 行 34: | ||
{ | { | ||
"id": " | "id": "solitarydream", | ||
"title_localized": { | "title_localized": { | ||
"en": " | "en": "Solitary Dream", | ||
"ja": "虚空の夢" | |||
}, | |||
"jacket_localized": { | |||
"ja": true | |||
}, | }, | ||
"artist": "ak+q", | "artist": "ak+q feat. Sennzai", | ||
"bpm": " | "bpm": "162", | ||
"bpm_base": | "bpm_base": 162, | ||
"set": " | "set": "core", | ||
"purchase": " | "purchase": "core", | ||
"audioPreview": | "audioPreview": 49629, | ||
"audioPreviewEnd": | "audioPreviewEnd": 68148, | ||
"side": | "side": 0, | ||
"bg": "solitarydream", | |||
"remote_dl": true, | |||
"world_unlock": true, | "world_unlock": true, | ||
"date": 1552089600, | |||
"date": | |||
"difficulties": [ | "difficulties": [ | ||
{ | { | ||
"ratingClass": 0, | "ratingClass": 0, | ||
"chartDesigner": " | "chartDesigner": "", | ||
"jacketDesigner": "シエラ", | "jacketDesigner": "シエラ", | ||
"rating": | "rating": 4 | ||
}, | }, | ||
{ | { | ||
"ratingClass": 1, | "ratingClass": 1, | ||
"chartDesigner": " | "chartDesigner": "", | ||
"jacketDesigner": "シエラ", | "jacketDesigner": "シエラ", | ||
"rating": | "rating": 7 | ||
}, | }, | ||
{ | { | ||
"ratingClass": 2, | "ratingClass": 2, | ||
"chartDesigner": " | "chartDesigner": "", | ||
"jacketDesigner": "シエラ", | "jacketDesigner": "シエラ", | ||
"rating": | "rating": 8 | ||
} | } | ||
] | ] | ||
} | } | ||
好了让我们忘掉上面的东西, | 好了让我们忘掉上面的东西,<s>反正上面的东西又 不 全</s> | ||
真正归纳起来是这样的 | 真正归纳起来是这样的 | ||
行 93: | 行 85: | ||
"title_localized": { | "title_localized": { | ||
"en": "title" | "en": "title" | ||
"ja": "日本語の表記" | |||
}, | }, | ||
"artist": "artist", | "artist": "artist", | ||
行 103: | 行 96: | ||
"side": side, | "side": side, | ||
"world_unlock": worldBoolean, | "world_unlock": worldBoolean, | ||
"no_pp": ppBoolean, | |||
"bg": "setBG", | "bg": "setBG", | ||
"date": 加入时的系统时间, | "date": 加入时的系统时间, | ||
"remote_dl": remoteDLBoolean, | "remote_dl": remoteDLBoolean, | ||
"source_localized": { | |||
"en": "source" | |||
}, | |||
"source_copyright": "©copyright", | |||
"difficulties": [ | "difficulties": [ | ||
{ | { | ||
行 113: | 行 111: | ||
"rating": rating, | "rating": rating, | ||
"plusFingers": plusFingersBoolean, | "plusFingers": plusFingersBoolean, | ||
}, | }, | ||
{ | { | ||
行 124: | 行 118: | ||
"rating": rating, | "rating": rating, | ||
"plusFingers": plusFingersBoolean, | "plusFingers": plusFingersBoolean, | ||
}, | }, | ||
{ | { | ||
行 135: | 行 125: | ||
"rating": rating, | "rating": rating, | ||
"plusFingers": plusFingersBoolean, | "plusFingers": plusFingersBoolean, | ||
} | } | ||
] | ] | ||
行 153: | 行 139: | ||
"title_localized": { | "title_localized": { | ||
"en": "title" | "en": "title" | ||
"ja": "日本語の表記" | |||
}, | }, | ||
"artist": "artist", | "artist": "artist", | ||
行 163: | 行 150: | ||
"side": side, | "side": side, | ||
"world_unlock": worldBoolean, | "world_unlock": worldBoolean, | ||
"no_pp": ppBoolean, | |||
"bg": "setBG", | "bg": "setBG", | ||
"date": 加入时的系统时间, | "date": 加入时的系统时间, | ||
"remote_dl": remoteDLBoolean, | "remote_dl": remoteDLBoolean, | ||
"source_localized": { | |||
"en": "source" | |||
}, | |||
"source_copyright": "©copyright", | |||
"difficulties": […… | "difficulties": […… | ||
] | ] | ||
} | } | ||
id(ansistring):歌曲ID名,'''至关重要''',像解锁条件等引用歌曲的时候是引用id的,并且对应谱面文件夹也必须是id名,如果是远程下载的曲子,在preview文件夹里放预览音频时,文件名也必须和id一样,'''不能出现非ASCII字符''' | *id(ansistring):歌曲ID名,'''至关重要''',像解锁条件等引用歌曲的时候是引用id的,并且对应谱面文件夹也必须是id名,如果是远程下载的曲子,在preview文件夹里放预览音频时,文件名也必须和id一样,'''不能出现非ASCII字符''' | ||
*title_localized(ansistring):长这样 | |||
title_localized(ansistring):长这样 | |||
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
行 181: | 行 172: | ||
}, | }, | ||
|} | |} | ||
:* 其中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登录后会校验歌单.''' 进而导致封号风险'''. | |||
从这里开始就会涉及到危险操作了,''' 请为自己的行为负责!''' |
於 2019年11月10日 (日) 14:32 的修訂
此頁面本頁面為技術型隱藏頁面 |
等一下你們先讓我看一下apk
- 本頁保持孤立!
在開始閱讀之前
總論
歌曲信息都包含在一個叫做songlist的文件里.位置為\assets\songs
這個文件是關於更改歌曲信息的,如果想更改譜面本身,請移步譜面格式
如果想更改關於解歌條件的部分,請移步解鎖條件(unlocks)格式
如果想更改曲包相關內容請移步曲包信息(packlist)格式
閱讀總論
songlist是按照json格式編寫的,有大量花括號與中括號,中間的回車與制表符除了整理版面之外沒有任何意義.總之不該你改的東西你不要改就行了.
代碼解析
框架
歌曲信息在文件里總體排列成這樣
{"songs": [{歌曲信息1},{歌曲信息2},……,{歌曲信息n}]} |
可見歌曲信息之間的互不干擾性,而且它告訴我們加入自製譜(不是替換官譜)是可能的.任何較大的改動都會使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 } ] }
好了讓我們忘掉上面的東西,反正上面的東西又不全
真正歸納起來是這樣的
{ "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):長這樣
"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時間戳
或者打開CE查看explorer.exe…… - remoteDLBoolean(false,true):該曲目是否需要遠程下載,true為是,false為否.如果為true,預覽音頻在對應文件夾里,相應譜面文件夾里也沒有音頻文件,
相信你們都知道該幹什麼,可刪除. - source(ansistring):本曲的來源,一般只填en以讓所有語言看見。在顯示時由中文書名號(《》)括起。可刪除。
- ©copyright(ansistring):本曲所屬版權。在顯示時在中文書名號(《》)後面。可刪除。
難度文件解析
難度譜面信息框架如下
"difficulties": [{PST信息},{PRS信息},{FTR信息}] |
各難度代碼結構如下
{ "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):
加一根手指,目前尚不清楚該參數含義,據猜測可能是多點觸控開關,0為關,1為開.尚不清楚之間的差別. - jacketOverrideBoolean(false,true):標識本難度是否獨占封面圖,是true否false,可刪除
綜合
如果你在做完自製譜之後,採取的是替換原信息(不改ID)的方式導入的話,你也許還能登錄遊玩.
如果你採取了添加的方式,那麼你的arc絕對不能登錄,因為arc登錄後會校驗歌單.進而導致封號風險.
從這裡開始就會涉及到危險操作了,請為自己的行為負責!