开始游戏

校验当前轮次归属和本机摄像头处理同意后将created轮次切为active；重复调用已active轮次返回当前轮次，不重置startedAt或游戏状态；已结算轮次返回409 SESSION_STATE_CONFLICT。画面、校准、暂停/恢复、时钟、碰撞和本机姿态推理由前端完成。

API Key

在 cookie 添加参数

SGSESSION

示例：

SGSESSION: ********************

API Key

在 cookie 添加参数

SGGUEST

示例：

SGGUEST: ********************

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功（200）

application/json

幂等开始轮次

Headers

Bodyapplication/json

示例

{
    "code": "OK",
    "message": "OK",
    "data": {
        "id": "22222222-2222-4222-8222-222222222222",
        "userId": "11111111-1111-4111-8111-111111111111",
        "mode": "balance_ball",
        "config": {
            "mode": "balance_ball",
            "durationMs": 60000,
            "targetCount": 5,
            "pointsPerTarget": 10,
            "trackBounds": {
                "leftXRatio": 0.08,
                "rightXRatio": 0.92
            },
            "targets": [
                {
                    "id": "target-1",
                    "spawnAtMs": 0,
                    "xRatio": 0.22,
                    "yRatio": 0.3,
                    "velocityXRatioPerSecond": 0,
                    "velocityYRatioPerSecond": 0,
                    "radiusRatio": 0.045
                },
                {
                    "id": "target-2",
                    "spawnAtMs": 10000,
                    "xRatio": 0.38,
                    "yRatio": 0.48,
                    "velocityXRatioPerSecond": 0,
                    "velocityYRatioPerSecond": 0,
                    "radiusRatio": 0.045
                },
                {
                    "id": "target-3",
                    "spawnAtMs": 20000,
                    "xRatio": 0.55,
                    "yRatio": 0.32,
                    "velocityXRatioPerSecond": 0,
                    "velocityYRatioPerSecond": 0,
                    "radiusRatio": 0.045
                },
                {
                    "id": "target-4",
                    "spawnAtMs": 30000,
                    "xRatio": 0.7,
                    "yRatio": 0.5,
                    "velocityXRatioPerSecond": 0,
                    "velocityYRatioPerSecond": 0,
                    "radiusRatio": 0.045
                },
                {
                    "id": "target-5",
                    "spawnAtMs": 40000,
                    "xRatio": 0.82,
                    "yRatio": 0.34,
                    "velocityXRatioPerSecond": 0,
                    "velocityYRatioPerSecond": 0,
                    "radiusRatio": 0.045
                }
            ],
            "obstacles": [
                {
                    "id": "obstacle-1",
                    "spawnAtMs": 0,
                    "xRatio": 0.48,
                    "yRatio": 0.62,
                    "velocityXRatioPerSecond": 0.12,
                    "velocityYRatioPerSecond": 0,
                    "radiusRatio": 0.055
                }
            ],
            "levelCode": "ball-standard-v1",
            "finishLineXRatio": 0.9,
            "completionBonus": 50
        },
        "rulesVersion": "balance_ball-v1",
        "status": "active",
        "createdAt": "2026-10-11T10:00:00Z",
        "startedAt": "2026-10-11T10:00:00Z",
        "finishedAt": null,
        "result": null,
        "ownerType": "account",
        "savedToHistory": false,
        "expiresAt": "2026-10-12T10:00:00Z"
    }
}

🟠401失败（401）

🟠403失败（403）

🟠404失败（404）

🟠409失败（409）

🟠422失败（422）

🔴500失败（500）

⚪default其他失败

请求参数

请求示例代码

返回响应