gruppeadler/replay

replay.gruppe-adler.de 镜像文档

镜像概述

replay.gruppe-adler.de是Gruppe Adler的回放API镜像，主要用于存储并提供所有回放数据（包括单位位置等实际数据）。该镜像作为数据服务核心，被https://github.com/gruppe-adler/aar.gruppe-adler.de%E5%92%8Chttps://github.com/gruppe-adler/grad_replay_intercept%E9%A1%B9%E7%9B%AE%E4%BE%9D%E8%B5%96%E4%BD%BF%E7%94%A8%E3%80%82

核心功能与特性

• 数据存储与服务：存储回放元数据及详细帧数据，并通过API接口提供访问
• 完整的API端点：支持回放列表查询、单条回放查询、帧数据查询、回放创建及删除
• 授权控制：关键操作（如创建、删除回放）需通过令牌授权
• 灵活配置：可通过环境变量自定义授权令牌

使用场景与适用范围

适用于需要管理和访问游戏回放数据的应用场景，特别是与Gruppe Adler相关的项目，如：

• Web应用（如aar.gruppe-adler.de）展示回放数据
• 游戏内插件（如grad_replay_intercept）提交或获取回放数据

部署与配置

镜像获取

Docker镜像已发布至Docker Hub：gruppeadler/replay

基本部署要求

• 容器需通过80/443端口对外提供服务
• 建议配置授权令牌以保护敏感操作

环境变量配置

Docker部署示例

docker run 命令

bash
docker run -d \
  -p 80:80 \
  -e AUTH_TOKEN="your_secure_token" \
  --name replay-api \
  gruppeadler/replay

docker-compose 配置

yaml
version: '3'
services:
  replay-api:
    image: gruppeadler/replay
    ports:
      - "80:80"
    environment:
      - AUTH_TOKEN=your_secure_token
    restart: unless-stopped

授权机制

部分API端点需要授权，授权方式如下：

1. 在HTTP请求头中添加Authorization字段
2. 字段值格式：Bearer <AUTH_TOKEN>，其中<AUTH_TOKEN>为通过环境变量配置的令牌

API端点说明

GET /

• 描述：返回所有回放的元数据数组
• 是否需要授权：否
• 示例响应：

jsonc
[
    {
        "date": "2019-05-18 15:28:06",
        "duration": 34,
        "missionName": "replayTest",
        "worldName": "Stratis",
        "id": 0,
        "frameCount": 30,
        "config": {
            "id": 1,
            "precision": 1,
            "sendingChunkSize": 10,
            "stepsPerTick": 1,
            "trackShots": true,
            "trackedAI": true,
            "trackedSides": ["west", "east", "civilian"],
            "trackedVehicles": true
        }
    }
    // [...]
]

GET /:id

• 描述：返回指定ID的回放详情
• 是否需要授权：否
• 示例响应：

jsonc
{
    "date": "2019-05-18 15:28:06",
    "duration": 34,
    "missionName": "replayTest",
    "worldName": "Stratis",
    "id": 0,
    "frameCount": 30,
    "config": {
        "precision": 1,
        "sendingChunkSize": 10,
        "stepsPerTick": 1,
        "trackShots": true,
        "trackedAI": true,
        "trackedSides": ["west", "east", "civilian"],
        "trackedVehicles": true
    }
}

GET /:id/data/:offset

• 描述：返回指定ID回放的帧数据，从指定偏移量开始（偏移量×10为起始帧，每次返回最多10帧）
• 是否需要授权：否
• 示例：/0/data/2返回回放0的第20-29帧数据
• 示例响应：

jsonc
[
    {
        "id": 51,
        "time": "12:00:28",
        "data": [
            {
                "id": 821,
                "color": "rgba(0,76,153,1)",
                "direction": 132,
                "group": " (Alpha 1-1)",
                "icon": "iconMan",
                "name": "Willard",
                "position": [
                    1946.40283203125,
                    5663.35107421875
                ],
                "target": null
            }
            // [...]
        ]
    }
    // [...]
]

DELETE /:id

• 描述：删除指定ID的回放
• 是否需要授权：是

POST /

• 描述：创建新回放
• 是否需要授权：是
• 请求体示例：n/a