---
title: "获取麦位列表"
method: GET
path: "/api/room/mic/list"
tags: ["麦位管理"]
---

# 获取麦位列表

`GET /api/room/mic/list`

获取房间当前的麦位列表信息，包括每个麦位的状态、上麦用户等。

**返回字段说明：**
- position: 麦位位置（0-主持位，1-8普通麦位）
- uid: 上麦用户ID（0表示空麦）
- nickname: 用户昵称
- avatar: 用户头像
- micState: 麦克风状态（0-开麦，1-锁麦）
- posState: 麦位状态（0-开位，1-锁位）

## Query parameters

- `roomUid` integer, required

## Response `200`

查询成功

- RoomMicVO[]
  - `roomUid` integer
  - `position` integer
  - `posState` integer
  - `micState` integer
  - `micUserVO` MicUserVO — 麦位用户信息
    - `uid` integer
    - `appNo` string
    - `nick` string
    - `avatar` string
    - `gender` integer
    - `headwearUrl` string
    - `headwearSvgaUrl` string
    - `roleType` integer
    - `roomSuperAdmin` boolean
    - `soundWaveUrl` string
    - `vipLevel` integer
    - `svipLevel` integer
    - `charmValue` integer
  - `micHideFlag` boolean

## Other responses

- `400` — 参数错误
- `404` — 房间不存在

---

[API](https://skmtc.dev/oloo/apis/openapi-definition.md) · [All operations](https://skmtc.dev/oloo/apis/openapi-definition/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/oloo/openapi-definition/revisions/c0963217c1b7/schema)