IMSDK
即时通信 IM 提供全球接入、单聊、群聊、消息推送、资料关系链托管、帐号鉴权等全方位解决方案,并提供完备的 App 接入、后台管理接口。
V2TIMMessage

详细描述

高级消息

属性

NSString * msgID
 
NSDate * timestamp
 
NSString * sender
 
NSString * nickName
 
NSString * friendRemark
 
NSString * nameCard
 
NSString * faceURL
 
NSString * groupID
 
NSString * userID
 
uint64_t seq
 
uint64_t random
 
V2TIMMessageStatus status
 
BOOL isSelf
 
BOOL isRead
 
BOOL isPeerRead
 
NSMutableArray< NSString * > * groupAtUserList
 
V2TIMElemType elemType
 
V2TIMTextElemtextElem
 
V2TIMCustomElemcustomElem
 
V2TIMImageElemimageElem
 
V2TIMSoundElemsoundElem
 
V2TIMVideoElemvideoElem
 
V2TIMFileElemfileElem
 
V2TIMLocationElemlocationElem
 
V2TIMFaceElemfaceElem
 
V2TIMMergerElemmergerElem
 
V2TIMGroupTipsElemgroupTipsElem
 
NSData * localCustomData
 
int localCustomInt
 
NSData * cloudCustomData
 

属性说明

◆ msgID

- (NSString*) msgID
readnonatomicstrong

消息 ID(消息创建的时候为 nil,消息发送的时候会生成)

◆ timestamp

- (NSDate*) timestamp
readnonatomicstrong

消息时间

◆ sender

- (NSString*) sender
readnonatomicstrong

消息发送者

◆ nickName

- (NSString*) nickName
readnonatomicstrong

消息发送者昵称

◆ friendRemark

- (NSString*) friendRemark
readnonatomicstrong

消息发送者好友备注

◆ nameCard

- (NSString*) nameCard
readnonatomicstrong

如果是群组消息,nameCard 为发送者的群名片

◆ faceURL

- (NSString*) faceURL
readnonatomicstrong

消息发送者头像 在 C2C 场景下,陌生人的头像不会实时更新,如需更新陌生人的头像(如在 UI 上点击陌生人头像以展示陌生人信息时), 请调用 V2TIMManager.h -> getUsersInfo 接口触发信息的拉取。待拉取成功后,SDK 会更新本地头像信息,即 faceURL 字段的内容。

注意
请不要在收到每条消息后都去 getUsersInfo,会严重影响程序性能。

◆ groupID

- (NSString*) groupID
readnonatomicstrong

如果是群组消息,groupID 为会话群组 ID,否则为 nil

◆ userID

- (NSString*) userID
readnonatomicstrong

如果是单聊消息,userID 为会话用户 ID,否则为 nil, 假设自己和 userA 聊天,无论是自己发给 userA 的消息还是 userA 发给自己的消息,这里的 userID 均为 userA

◆ seq

- (uint64_t) seq
readnonatomicassign

群聊中的消息序列号云端生成,在群里是严格递增且唯一的, 单聊中的序列号是本地生成,不能保证严格递增且唯一。

◆ random

- (uint64_t) random
readnonatomicassign

消息随机码

◆ status

- (V2TIMMessageStatus) status
readnonatomicassign

消息发送状态

◆ isSelf

- (BOOL) isSelf
readnonatomicassign

消息发送者是否是自己

◆ isRead

- (BOOL) isRead
readnonatomicassign

消息自己是否已读

◆ isPeerRead

- (BOOL) isPeerRead
readnonatomicassign

消息对方是否已读(只有 C2C 消息有效)

◆ groupAtUserList

- (NSMutableArray<NSString *>*) groupAtUserList
readnonatomicstrong

群消息中被 @ 的用户 UserID 列表(即该消息都 @ 了哪些人)

◆ elemType

- (V2TIMElemType) elemType
readnonatomicassign

消息类型

◆ textElem

- (V2TIMTextElem*) textElem
readnonatomicstrong

消息类型 为 V2TIM_ELEM_TYPE_TEXT,textElem 会存储文本消息内容

◆ customElem

- (V2TIMCustomElem*) customElem
readnonatomicstrong

消息类型 为 V2TIM_ELEM_TYPE_CUSTOM,customElem 会存储自定义消息内容

◆ imageElem

- (V2TIMImageElem*) imageElem
readnonatomicstrong

消息类型 为 V2TIM_ELEM_TYPE_IMAGE,imageElem 会存储图片消息内容

◆ soundElem

- (V2TIMSoundElem*) soundElem
readnonatomicstrong

消息类型 为 V2TIM_ELEM_TYPE_SOUND,soundElem 会存储语音消息内容

◆ videoElem

- (V2TIMVideoElem*) videoElem
readnonatomicstrong

消息类型 为 V2TIM_ELEM_TYPE_VIDEO,videoElem 会存储视频消息内容

◆ fileElem

- (V2TIMFileElem*) fileElem
readnonatomicstrong

消息类型 为 V2TIM_ELEM_TYPE_FILE,fileElem 会存储文件消息内容

◆ locationElem

- (V2TIMLocationElem*) locationElem
readnonatomicstrong

消息类型 为 V2TIM_ELEM_TYPE_LOCATION,locationElem 会存储地理位置消息内容

◆ faceElem

- (V2TIMFaceElem*) faceElem
readnonatomicstrong

消息类型 为 V2TIM_ELEM_TYPE_FACE,faceElem 会存储表情消息内容

◆ mergerElem

- (V2TIMMergerElem*) mergerElem
readnonatomicstrong

消息类型 为 V2TIM_ELEM_TYPE_MERGER,mergerElem 会存储转发消息内容

◆ groupTipsElem

- (V2TIMGroupTipsElem*) groupTipsElem
readnonatomicstrong

消息类型 为 V2TIM_ELEM_TYPE_GROUP_TIPS,groupTipsElem 会存储群 tips 消息内容

◆ localCustomData

- (NSData*) localCustomData
readwritenonatomicstrong

消息自定义数据(本地保存,不会发送到对端,程序卸载重装后失效)

◆ localCustomInt

- (int) localCustomInt
readwritenonatomicassign

消息自定义数据,可以用来标记语音、视频消息是否已经播放(本地保存,不会发送到对端,程序卸载重装后失效)

◆ cloudCustomData

- (NSData*) cloudCustomData
readwritenonatomicstrong

消息自定义数据(云端保存,会发送到对端,程序卸载重装后还能拉取到)