---
title: "上麦"
method: POST
path: "/api/room/mic/up"
tags: ["麦位管理"]
---

# 上麦

`POST /api/room/mic/up`

## Request

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

用户主动上麦到指定位置。

**前置条件：**
- 用户必须在房间内
- 目标麦位必须为空闲状态
- 目标麦位未被锁位
- 用户当前不在其他麦位上

**返回值说明：**
- 1: 上麦成功
- 0: 上麦失败
- -1: 麦位已被占用
- -2: 麦位已锁定

## Query parameters

- `micUid` integer, required
- `roomUid` integer, required
- `position` integer, required
- `leftUidPos` string
- `rightUidPos` string

## Response `200`

操作成功

## Other responses

- `400`: 参数错误或麦位不可用

---

[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)