文档
测试

用户加入房间,参与PK

POST
/api/pk/join/room

请求头

参数名
类型
描述
必填
token
string
用户token
必填

请求参数

参数名
类型
描述
必填
pk_room_number
string
房间号
必填
user_group
string
用户组 red 或 blue 当多人PK,选择房间时候,传此参数
必填

响应参数

参数名
类型
描述
必填
code
int
响应状态值
必填
msg
string
响应信息
必填
data
Object
响应数据
必填
pk_room_id
string
PK房间ID
必填
pk_room_number
string
房间号
必填
pk_type
int
PK类型
必填
pk_result_type
int
结果判定类型
必填
status
int
PK状态,1:未开始,2:已开始,3:已结束
必填
pk_max_person
int
队伍最多人数
必填
group_red_title
string
红队名称
必填
group_blue_title
string
蓝队名称
必填
time_long
int
PK时长,pk_result_type为1 时存在
必填
red
Object-Array
红队用户列表
必填
blue
Object-Array
蓝队用户列表
必填
user_id
string
用户ID
必填
pk_room_id
string
PK房间ID
必填
user_pk_list_id
string
用户PKID
必填
user_group
string
所属队伍
必填
user_name
string
用户名
必填
user_img
string
用户头像
必填
fd
string
websocket会话ID
必填
is_stop
int
是否结束PK 0:未结束,1:已结束
必填
is_ready
int
是否准备,0:未准备,1:已准备
必填
circle_count
int
已运动圈数
必填
group_info
Object-Array
队伍信息
必填
user_group
string
用户队伍,双人PK和组队PK都存在user_group 双人PK时 user_group_title 为空
必填
user_group_title
string
队伍名称
必填

说明 / 示例

如果是团队PK 且未传入所属队伍,返回如下,前端页面二次展示显示队伍选项 ![image.png](https://cos.easydoc.net/80953943/files/kn5zve2d.png) 加入PK成功返回: ![image.png](https://cos.easydoc.net/80953943/files/knq09dp5.png) time_long、distance_value 用于前端监听判断PK是否结束, 用户加入PK成功后,请发起websocket链接,相关文档请参考“WebSocket”部分