扩展消息
已发送的超级群消息可增加、修改、删除扩展信息。
适用场景:
原始消息增加状态标识的需求,都可使用消息扩展。
- 消息评论需求,可通过设置原始消息扩展信息的方式添加评论信息。
- 礼物领取、订单状态变化需求,通过此功能改变消 息显示状态。 例如:向用户发送礼物,默认为未领取状态,用户点击后可设置消息扩展为已领取状态。
提示
- 每次设置消息扩展将会产生内置通知消息,频繁设置扩展会产生大量消息。
- 仅当发送消息时指定
canIncludeExpansion
值为YES
,才可对消息进行扩展。
设置、更新消息扩展信息
提示
消息扩展功能要求在发送消息前设置该消息为可扩展消息。关于如何修改消息的的可扩展属性,请参考消息扩展中的对 canIncludeExpansion()
的说明。
//更新消息扩展
- (void)updateUltraGroupMessageExpansion:(NSString *)messageUId
expansionDic:(NSDictionary<NSString *, NSString *> *)expansionDic
success:(void (^)(void))successBlock
error:(void (^)(RCErrorCode status))errorBlock
//删除消息扩展
- (void)removeUltraGroupMessageExpansion:(NSString *)messageUId
keyArray:(NSArray *)keyArray
success:(void (^)(void))successBlock
error:(void (^)(RCErrorCode status))errorBlock
监听消息处理
@protocol RCUltraGroupMessageChangeDelegate <NSObject>
/*!
消息扩展更新,删除
@param messages 消息集合
*/
- (void)onUltraGroupMessageExpansionUpdated:(NSArray<RCMessage*>*)messages;
/*!
消息内容发生变更
@param messages 消息集合
*/
- (void)onUltraGroupMessageModified:(NSArray<RCMessage*>*)messages;
/*!
消息撤回
@param messages 消息集合
*/
- (void)onUltraGroupMessageRecalled:(NSArray<RCMessage*>*)messages;
@end
//设置超级群消息变化监听
- (void)setRCUltraGroupMessageChangeDelegate:(id<RCUltraGroupMessageChangeDelegate>)delegate