Аркадный зал Школы Империи

Музыкальный API и идентичность треков

Сайт предоставляет JSON-метаданные отдельно от исходных музыкальных файлов. Клиент читает каталог, открывает манифест нужного набора, выбирает строку и загружает её asset. JSON сам по себе не содержит звук.

Публичные ресурсы

РесурсАдрес от корня сайта
Наборы музыкиmusic/index.json
Медиатека игр и трековassets/gallery-music.json
Манифест набораЗначение manifest из опубликованного каталога
Похожие трекиassets/music-similarity.json
Установщики GremlinAmp по платформамassets/arcade/music-app/manifest.json
Обновления GremlinAmp для Androidassets/arcade/music-app/release.json
Обновления GremlinAmp для macOSassets/arcade/music-app/macos-release.json
Обновления GremlinAmp для Windowsassets/arcade/music-app/windows-release.json

Значение schema_version: 1 относится к структуре соответствующего музыкального JSON, а не к версии приложения или анализатора. Адрес манифеста берётся из данных. Относительный asset.url разрешается относительно манифеста; адрес набора из общей медиатеки — относительно корня сайта.

Трек и оригинал

game_id связывает строку с набором игры; index указывает позицию в его треклисте. id сохраняет идентичность строки. subsong выбирает композицию внутри исходника. asset.sha256 и asset.bytes описывают загружаемые байты.

Физический ключ звука — SHA256:subsong. Одинаковые байты и номер композиции не анализируются заново только из-за второй ссылки на них. Необязательное audio_key в индексе медиатеки передаёт этот ключ без предварительного скачивания полного манифеста.

Если манифест обновился, прежний индекс строки может указывать уже на другой материал. Перед подбором клиент проверяет набор, идентификатор строки и физический ключ. Несовпавший кандидат пропускается; угадывать композицию по одному названию нельзя.

Длительность

duration_known различает известную длительность и условную границу воспроизведения. play_ms и fade_ms задают соответствующие времена в миллисекундах. Неизвестная длительность не равна нулевой и не доказывает, что файл короткий.

Схемы и синтетические примеры находятся в реестре форматов. Наличие индекса сходства необязательно для обычного воспроизведения.

Поля индекса сходства

tracks — словарь по физическому ключу. В записи: refs со связями {game_id, track_id, index}, оценка bpm, rhythm_confidence, partial и neighbors. Последний содержит списки rhythm и sound; кандидат имеет key и distance. Пустой список допустим. analysis описывает охват: complete, audio_tracks, indexed, pending, failed. Частичный индекс содержит только успешно измеренные записи; complete: false означает, что обработка ещё продолжается. Версия анализатора и engine описывают метод; fingerprint — содержимое индекса. Distance не является вероятностью или процентом.

Метаданные приложения

Прежний Android-контракт release.json сохранён. Его метаданные имеют title, description, icon_url, version, build, apk {url, bytes, sha256}, source_url, min_android. Поле schema_version для этого файла не требуется. Ссылка на исходники берётся из source_url, а не из имени APK.

manifest.json имеет schema: 1, id, title, description, icon_url, source_url, downloads. Каждая загрузка описывает platform, app_id, title, version, build, format, url, bytes, sha256, source_url; необязательны min_os, architecture, repository_url, platform_label. Адреса загрузок разрешаются относительно корня сайта. Кнопка появляется только для опубликованных байтов.

Платформенный <platform>-release.json использует контракт проекта: schema: 1, app_id, platform, release: {version, build, url, bytes, sha256}. Вложенный release.url — абсолютный HTTPS-адрес. Для macOS app-release.json является копией macos-release.json. Прямые version, build, file и блок формата дублируют те же данные для читателей плоского JSON. Нативный Mac-контракт описан ниже: в нём dmg содержит варианты по архитектурам. Сборки разных платформ сравниваются независимо; версия Mac не меняет Android-релиз.

Сборка приложения передаёт установщик и JSON-квитанцию schema: 1, app_id, platform, version, build, sha256. Издатель сопоставляет фактические байты по SHA-256. Идентичность Android проверяется по манифесту APK. Имя файла не задаёт версию или платформу. app_id должен совпадать с идентификатором семейства GremlinAmp либо иметь его префикс с точкой; например, Mac использует ru.oopssre.gremlinamp.mac. Новая платформа задаётся метаданными без изменения издателя.

Нативный GremlinAmp для macOS

Сборка Mac передаёт свои DMG и созданный ею macos-release.json. Переписывать его в плоскую квитанцию не требуется. Он содержит schema_version: 1, bundle_id: "ru.oopssre.gremlinamp.mac", строку version, положительный целый build, minimum_macos и словарь dmg. Допустимые ключи словаря: arm64, x86_64, universal. В каждом варианте находятся url, bytes и sha256.

Издатель проверяет размер и SHA-256 каждого фактически предоставленного DMG. Недоступный вариант не появляется среди загрузок. DMG публикуются в assets/arcade/music-app/macos/, а обновление — по прежнему адресу assets/arcade/music-app/macos-release.json. Карта dmg сохраняет архитектуры; её URL начинаются с /assets/arcade/music-app/macos/. Клиент выбирает собственную архитектуру либо universal. Номер сборки сравнивается только внутри платформы. Дополнительная оболочка schema/app_id/platform/release и копия app-release.json остаются для совместимости.

Схема нативного Mac-релиза.

Схема списка установщиков, схема платформенного релиза.

Схема манифеста, схема медиатеки, схема сходства, схема релиза приложения. Это описательные схемы текущих публичных полей; необязательные расширения разрешены. Синтетический пример не содержит распространяемой музыки.

Порядок чтения: Оглавление · Назад: Форматы на границах системы · Далее: Спецификация погодного API