V2TIMSoundElem

构造函数
(void)	- getUrl:
(void)	- downloadSound:progress:succ:fail:
(void)	- convertVoiceToText:completion:
(V2TIMElem *_Nullable)	- nextElem
(void)	- appendElem:

属性
NSString *	path
NSString *	uuid
int	dataSize
int	duration

详细描述

语音消息 Elem

函数文档

getUrl:()

- (void) getUrl:

(void(^)(NSString *_Nullable url))

urlCallBack

获取语音的 URL 下载地址

downloadSound:progress:succ:fail:()

- (void) downloadSound:		(NSString *)	path
progress:		(_Nullable V2TIMDownLoadProgress)	progress
succ:		(_Nullable V2TIMSucc)	succ
fail:		(downloadSound(path:progress:succ:fail:))	NS_SWIFT_NAME

下载语音

downloadSound 接口每次都会从服务端下载，如需缓存或者存储，开发者可根据 uuid 作为 key 进行外部存储，ImSDK 并不会存储资源文件。

参数

path	语音保存路径，需要外部指定

convertVoiceToText:completion:()

- (void) convertVoiceToText:		(NSString *)	language
completion:		(convertVoiceToText(language:completion:))	NS_SWIFT_NAME

将语音转成文字（7.4 及以上版本支持）

参数

language

识别的语言。

注意

• 语音转文字是增值付费功能，处于内测阶段，您可通过 即时通信 IM 语音转文字插件交流群 联系我们为您开通体验完整功能。

nextElem()

- (V2TIMElem * _Nullable) nextElem

获取下一个 Elem，如果您的消息有多个 Elem，可以通过当前 Elem 获取下一个 Elem 对象，如果返回值为 nil，表示 Elem 获取结束。 详细使用方法请参考文档 消息收发

appendElem:()

- (void) appendElem:

(appendElem(elem:))

NS_SWIFT_NAME

添加下一个 elem 元素
如果您的消息需要多个 elem，可以在创建 Message 对象后，通过 Message 的 Elem 对象添加下一个 elem 对象。 以 V2TIMTextElem 和 V2TIMCustomElem 多 elem 为例，示例代码如下：

    V2TIMMessage *msg = [[V2TIMManager sharedInstance] createTextMessage:"text"];
    V2TIMCustomElem *customElem = [[V2TIMCustomElem alloc] init];
    customElem.data = ["自定义消息" dataUsingEncoding:NSUTF8StringEncoding];
    [msg.textElem appendElem:customElem];

注意

1.该接口只能由 createMessage 创建的 Message 对象里的 elem 元素调用。 2.该接口仅支持添加 V2TIMTextElem、V2TIMCustomElem、V2TIMFaceElem 和 V2TIMLocationElem 四类元素。

属性说明

path

- (NSString*) path

readnonatomicstrong

语音文件路径（只有发送方才能获取到）

uuid

- (NSString*) uuid

readnonatomicstrong

语音消息内部 ID

dataSize

- (int) dataSize

readnonatomicassign

语音数据大小

duration

- (int) duration

readnonatomicassign

语音长度（秒）