Skip to content

ChartInfo

本段介绍谱面基本信息组成部分。

提示

本页所有字段兼容等级为 0。

Json直观示例

json
{
  "Name": "UnTitled",
  "Author": "Unknown",
  "IllustrationAuthor": "Unknown",
  "IllustrationData": [],
  "SongAuthor": "Unknown",
  "SongOffset": 0,
  "SongData": [],
  "Level": "UK  Lv.0"
}

结构规范

唯一标识符字段名类型描述默认值加入版本
1Namestring谱面名称UnTitled1
2Authorstring谱师名义Unknown1
3IllustrationAuthorstring插画作者名义Unknown1
4IllustrationDatabyte[]?插画数据null1
5SongAuthorstring歌曲作者名义Unknown1
6SongOffsetint歌曲与谱面开始时间的偏移, 单位为毫秒01
7SongDatabyte[]歌曲数据-1
8Levelstring谱面难度UK Lv.01

行为规范

  • IllustrationData 字段可以存储插画的二进制数据,通常为 PNG 或 JPEG 格式。
  • IllustrationData 字段可以为 null,表示没有插画,显示的默认插画可以自己定义,建议使用纯黑。
  • SongData 字段存储歌曲的二进制数据,通常为 MP3 或 OGG 格式。
  • SongOffset 字段用于调整歌曲的起始时间,单位为毫秒(ms),可以为负值。
  • Level 存储的等级中 UKLv 文本之间为两个空格。

proto 段落

protobuf
syntax = "proto3";
package PhiCommonChart.ChartStructs;

message Info {
   string Name = 1;
   string Author = 2;
   string Level = 3;
   string IllustrationAuthor = 4;
   bytes IllustrationData = 5;
   string SongAuthor = 6;
   int32 SongOffset = 7;
   bytes SongData = 8;
}