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

# 获取麦位列表

`GET /api/room/mic/list`

## Request

- Base URL: `http://api.oloo.live`
- URL: `http://api.oloo.live/api/room/mic/list`
- Auth: none declared

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

**返回字段说明：**
- 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/oloo-api.md) - [All operations](https://skmtc.dev/oloo/apis/oloo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/oloo/apis/oloo-api/revisions/ada91d3a60e4?raw)