音频

媒体与文件media.send_audio

PLATFORM API

选择接入平台

平台选择会在 API 页面之间保留。下面始终展示该端真实公开入口。

当前平台

移动端

桌面端

Web 与小程序

跨平台

iOS · Swift · Completion公开调用入口

func sendAudio(查看 iOS 接入准备 →

调用参数

conversationIDString必填
目标会话 ID，来自会话查询或创建单聊的返回结果。
fileURLURL必填
当前方法需要的业务参数；具体取值规则见本页“功能说明”和分类说明。
mimeTypeString必填
当前方法需要的业务参数；具体取值规则见本页“功能说明”和分类说明。
durationMillisecondsUInt64必填
有效时长，单位为毫秒。
waveformData可选
当前方法需要的业务参数；具体取值规则见本页“功能说明”和分类说明。
taskIDString?可选
对应对象的 ID；请使用 SDK 或服务端返回的原始值。
clientMessageIDString?可选
客户端消息幂等 ID；同一次重试必须复用。

返回与后续处理

成功结果通过 onSuccess 返回，失败信息通过 onFailure 返回。方法本身返回可取消请求。

可复制代码

request = client.sendAudio(
    conversationID: conversationID,
    fileURL: fileURL,
    mimeType: mimeType,
    durationMilliseconds: durationMilliseconds,
    waveform: waveform,
    taskID: taskID,
    clientMessageID: clientMessageID,
    onSuccess: { value in
        // 使用返回结果更新数据或页面
    },
    onFailure: { error in
        // 按 error.stableCode 处理
    }
)

功能说明

media.send_audio 属于“媒体与文件”。上方平台选择器会显示当前端的真实方法名、参数和调用示例。

调用前提： 先完成账号连接，并按当前平台接入页申请文件、相册、麦克风或网络权限。
详细规则： 查看本分类的参数和状态说明。
跨端提醒： 各端方法名遵循各自语言习惯，请直接复制当前平台的示例。

参数与调用方式

页面顶部会列出必填/可选参数、参数用途和可复制代码。iOS/macOS 默认使用 onSuccess/onFailure，Android 默认使用 Java CompletableFuture；Web、Electron 和小程序未提供的能力会明确显示“不支持”，不会给出无效示例。

需要幂等键或版本号的方法，请使用上一次成功查询返回的值；不要自行猜测或拼接。

返回、错误与取消

结果	应用怎么处理
成功	使用返回结果刷新当前数据或页面；收到后续事件时再重新查询。
`invalid_argument`	检查空值、数组数量、重复 ID 和页面标注的版本参数。
`invalid_state`	确认当前账号已连接，并且没有在登出或换号。
`unsupported`	当前 SDK 或服务端版本没有此能力；提示升级，不要当成空结果。
`request_cancelled`	停止当前等待；写操作再查询一次结果，避免重复提交。

完整错误字段见模型、枚举与错误。

音频 ​

选择接入平台

功能说明 ​

参数与调用方式 ​

返回、错误与取消 ​

音频

功能说明

参数与调用方式

返回、错误与取消