TIMSoundElem Class Reference

Inherits from	TIMElem : NSObject
Declared in	TIMMessage.h

Overview

语音消息Elem

一条消息只能有一个语音 Elem，添加多条语音 Elem 时，AddElem 函数返回错误 1，添加不生效。
语音和文件 Elem 不一定会按照添加时的顺序获取，建议逐个判断 Elem 类型展示，而且语音和文件 Elem 也不保证按照发送的 Elem 顺序排序。

`taskId`

上传时任务 ID，可用来查询上传进度（已废弃，请在 TIMUploadProgressListener 监听上传进度）

@property (nonatomic, assign) uint32_t taskId

Declared In

TIMMessage.h

`path`

上传时，语音文件的路径，接收时使用 getSound 获得数据

@property (nonatomic, strong) NSString *path

Declared In

TIMMessage.h

`uuid`

语音消息内部 ID

@property (nonatomic, strong) NSString *uuid

Declared In

TIMMessage.h

`dataSize`

语音数据大小

@property (nonatomic, assign) int dataSize

Declared In

TIMMessage.h

`second`

语音长度（秒），发送消息时设置

@property (nonatomic, assign) int second

Declared In

TIMMessage.h

`– getUrl:`

获取语音的 URL 下载地址

- (void)getUrl:(void ( ^ ) ( NSString *url ))urlCallBack

Parameters

`urlCallBack`	获取 URL 地址回调

Declared In

TIMMessage.h

`– getSound:succ:fail:`

获取语音数据到指定路径的文件中

- (void)getSound:(NSString *)path succ:(TIMSucc)succ fail:(TIMFail)fail

Parameters

`path`	语音保存路径
`succ`	成功回调
`fail`	失败回调，返回错误码和错误描述

Discussion

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

Declared In

TIMMessage.h

`– getSound:progress:succ:fail:`

获取语音数据到指定路径的文件中（有进度回调）

- (void)getSound:(NSString *)path progress:(TIMProgress)progress succ:(TIMSucc)succ fail:(TIMFail)fail

Parameters

`path`	语音保存路径
`progress`	语音下载进度
`succ`	成功回调
`fail`	失败回调，返回错误码和错误描述

Discussion

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

Declared In

TIMMessage.h