歌曲

歌曲。

示例

{
  "id": "test",
  "idx": 1234,
  "title": "~TEST~",
  "artist": "TeST",
  "isDeleted": false,
  "addedAt": "2025-04-01T08:00:00+08:00",
  "version": "1.0.0",
  "bpm": "75 - 100",
  "bpmBase": 75.75,
  "isRemote": true,
  "isUnlockableInWorld": false,
  "isBeyondUnlockStateLocal": false,
  "purchase": "test_append_1",
  "category": "",
  "side": 0,
  "bg": "base_anything",
  "bgInverse": "base_!anything",
  "bgDay": "",
  "bgNight": "",
  "source": "WHEREEVER",
  "sourceCopyright": "© example.com 2025",
  "localizations": [
    {
      "lang": "ja",
      "title": "~テスト~",
      "hasJacket": true
    }
  ],
  "difficulties": []
}

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://arcaeaoffline.sevive.xyz/schemas/definitions/song.json",
  "title": "Arcaea Offline Definitions - Song",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The string identifier of the song",
      "examples": ["test"]
    },
    "idx": {
      "type": "integer",
      "minimum": 0,
      "description": "The number identifier of the song",
      "examples": [123]
    },
    "title": {
      "type": "string",
      "description": "The **english** title of the song",
      "examples": ["~TEST~"]
    },
    "artist": {
      "type": "string",
      "description": "The artist's **english** name",
      "examples": ["T·T·Tice"]
    },
    "isDeleted": {
      "type": "boolean",
      "description": "Whether this song is removed in game",
      "default": false
    },
    "addedAt": {
      "type": "string",
      "format": "date-time",
      "description": "When is this song added"
    },
    "version": {
      "type": "string",
      "description": "Which version is this song added",
      "examples": ["3.0.1", "6.0.0"]
    },
    "bpm": {
      "type": "string",
      "description": "BPM of this song, can be a range",
      "pattern": "(\\d+|\\d+-\\d+|\\d+\\s-\\s\\d+)",
      "examples": ["75", "75-100", "75 - 100"]
    },
    "bpmBase": {
      "type": "number",
      "minimum": 0.0,
      "examples": [100, 174.59]
    },
    "isRemote": {
      "type": "boolean",
      "description": "Whether this song has to be downloaded separately",
      "default": false
    },
    "isUnlockableInWorld": {
      "type": "boolean",
      "default": false
    },
    "isBeyondUnlockStateLocal": {
      "type": "boolean",
      "default": false
    },
    "purchase": {
      "type": "string"
    },
    "category": {
      "type": "string",
      "examples": ["original", "partner", "musicgames"]
    },
    "side": {
      "type": "integer",
      "minimum": 0
    },
    "bg": {
      "type": "string",
      "examples": ["base_light"]
    },
    "bgInverse": {
      "type": "string",
      "examples": ["base_conflict"]
    },
    "bgDay": {
      "type": "string",
      "examples": ["omatsuri_light"]
    },
    "bgNight": {
      "type": "string",
      "examples": ["omatsuri_conflict"]
    },
    "source": {
      "type": "string",
      "examples": ["STELLIGHTS"]
    },
    "sourceCopyright": {
      "type": "string",
      "examples": ["© Pigeon Games"]
    },
    "localizations": {
      "type": "array",
      "items": {
        "$ref": "https://arcaeaoffline.sevive.xyz/schemas/definitions/song-localization.json"
      }
    },
    "difficulties": {
      "type": "array",
      "items": {
        "$ref": "https://arcaeaoffline.sevive.xyz/schemas/definitions/difficulty.json"
      }
    }
  },
  "required": [
    "id",
    "isDeleted",
    "addedAt",
    "isRemote",
    "isUnlockableInWorld",
    "isBeyondUnlockStateLocal"
  ]
}