uploadAudio

abstract suspend fun uploadAudio(resource: ExternalResource): OfflineAudio

上传一个语音文件以备发送. resource 需要调用方ExternalResource.close.

多次调用 uploadAudio 使用同一个 resource 时, 将会发生多次上传, 且有可能产生不同的 OfflineAudio 对象, 因为服务器不会提供有关文件是否已经存在于服务器的信息.

返回的 OfflineAudio 支持序列化, 可以保存后在将来使用, 而不需要立即发送. 但不建议保存太久, 无法确定服务器保留一个文件的时间.

建议使用同一个 Contact 进行 uploadAudiosendMessage. 目标对象不同时的行为是不确定的.

要获取更多语音相关的信息, 参阅 Audio.

Since

2.7

Parameters

resource

支持 AMR 和 SILK 格式. 若要支持 MP3 格式, 请参考 mirai-silk-converter

Throws

当语音文件过大而被服务器拒绝上传时. (最大大小约为 1 MB) 注意: 由于服务器不一定会检查大小, 该异常就不一定会因大小超过 1MB 而抛出.