房间 Seed

接口说明

房间 Seed 是 Unity VR 多人场景的房间管理单元。seed_code 为房间对外唯一编号（6 位以上不透明字符串），客户端原样使用，无需解析其内部结构。

---

创建房间 Seed

接口说明

为指定用户在指定 Unity 场景下创建一个新的房间，返回房间唯一编号 seed_code。

注意： seed_code 是房间唯一凭证，必须在客户端妥善保存，后续加入房间及快照操作均依赖此值。

请求信息

项目	内容
Method	POST
URL	https://devapi.fengshengshou.com/api/gm/seed/create
鉴权	是，Bearer Token

请求参数

参数名	类型	必填	说明
user_id	int	是	当前用户 ID，须与 Token 归属用户一致
scene_name	string	是	Unity 场景标识，如 Level_01_Base

请求示例

curl -X POST "https://devapi.fengshengshou.com/api/gm/seed/create" \
  -H "Authorization: Bearer your_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": 10001,
    "scene_name": "Level_01_Base"
  }'

响应参数

字段	类型	说明
code	int	状态码，0 表示成功
message	string	固定为 创建成功
data.seed_code	string	房间唯一编号，如 9Q6JZ6
data.created_at	string	创建时间（格式 Y-m-d H:i:s）

成功响应

{
  "code": 0,
  "message": "创建成功",
  "data": {
    "seed_code": "9Q6JZ6",
    "created_at": "2026-07-05 10:00:00"
  }
}

失败响应

{
  "code": 401,
  "message": "未授权",
  "data": null
}

---

查询房间详情

接口说明

根据 seed_code 查询房间的详细信息，包括场景标识和创建者信息。

请求信息

项目	内容
Method	GET
URL	https://devapi.fengshengshou.com/api/gm/seed/detail
鉴权	是，Bearer Token

请求参数

参数名	类型	必填	说明
seed_code	string	是	Query 参数，房间唯一编号

请求示例

curl -X GET "https://devapi.fengshengshou.com/api/gm/seed/detail?seed_code=9Q6JZ6" \
  -H "Authorization: Bearer your_token_here"

响应参数

字段	类型	说明
code	int	状态码，0 表示成功
message	string	提示信息
data.seed_code	string	房间唯一编号
data.scene_name	string	Unity 场景标识
data.creator_user_id	int	创建者用户 ID
data.created_at	string	创建时间（格式 Y-m-d H:i:s）

成功响应

{
  "code": 0,
  "message": "success",
  "data": {
    "seed_code": "9Q6JZ6",
    "scene_name": "Level_01_Base",
    "creator_user_id": 10001,
    "created_at": "2026-07-05 10:00:00"
  }
}

失败响应

{
  "code": 404,
  "message": "房间不存在或已删除",
  "data": null
}

---

删除房间

接口说明

删除指定房间 Seed。删除后房间及相关数据将不可访问。

请求信息

项目	内容
Method	POST
URL	https://devapi.fengshengshou.com/api/gm/seed/delete
鉴权	是，Bearer Token

请求参数

参数名	类型	必填	说明
seed_code	string	是	房间唯一编号
user_id	int	是	操作用户 ID

请求示例

curl -X POST "https://devapi.fengshengshou.com/api/gm/seed/delete" \
  -H "Authorization: Bearer your_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "seed_code": "9Q6JZ6",
    "user_id": 10001
  }'

响应参数

字段	类型	说明
code	int	状态码，0 表示成功
message	string	提示信息
data	null	无数据返回

成功响应

{
  "code": 0,
  "message": "success",
  "data": null
}

失败响应

{
  "code": 404,
  "message": "房间不存在或已删除",
  "data": null
}