---
title: "Open Aircraft Two-Way Voice Channel"
method: POST
path: "/openapi/v2.0/drc/api/v2/projects/{uuid}/voice-channels/{sn}"
tags: ["Real-time Control/Payload Control/Speaker"]
---

# Open Aircraft Two-Way Voice Channel

`POST /openapi/v2.0/drc/api/v2/projects/{uuid}/voice-channels/{sn}`

## Request

- Base URL: `https://41b04hdzmc.apifox.cn` (the document declares no server; this is the origin it was published from)
- URL: `https://41b04hdzmc.apifox.cn/openapi/v2.0/drc/api/v2/projects/{uuid}/voice-channels/{sn}`
- Auth: none required

Open bidirectional voice channel for specified gateway SN (typical scenario: aircraft-mounted microphone capture + aircraft-mounted speaker playback; frontend connects via RTC). After server selects and initializes RTC provider (Agora / Volcano Engine / Twilio, etc.), dispatches channel access parameters (room number, Token, UID, etc.); frontend selects corresponding RTC SDK to connect by `provider` field.

## Path parameters

- `uuid` string, required
- `sn` string, required

## Query parameters

- `provider` string

## Headers

- `x-user-token` string, required
- `X-Request-Id` string, uuid
- `X-Project-Uuid` string, required

## Request body

- object: This API does not require request body content; recommended to pass empty object {}

## Response `200`

Operation Successful

- object
  - `code` integer, required: Business Status Code: 0=Success; non-zero=Error Code (see message for meaning)
  - `message` string: Error Description Message (Omitted on Success)
  - `data` object: OpenVoiceChannelResponse — Voice Channel Access Configuration
    - `voice_channel` object: VoiceChannelConfig — Voice Channel Access Parameters
      - `provider` string: RTC Provider, determines config field set (e.g. agora_rtc / volc_rtc)
      - `config` object: Access Parameters (structure varies by provider; frontend selects SDK to parse by provider). Typical fields like app_id / room_id / token / uid / expire_time, etc.

## Other responses

- `400`: Business Parameter Error — body contains code (non-zero)/message
- `500`: Internal Service Error

---

[API](https://skmtc.dev/dji/apis/flighthub-2-openapi-v2-0-on-premises.md) - [All operations](https://skmtc.dev/dji/apis/flighthub-2-openapi-v2-0-on-premises/llms.txt) - [OpenAPI document](https://skmtc.dev/dji/apis/flighthub-2-openapi-v2-0-on-premises/revisions/e4544b7809ea?raw)