扩展消息
已发送的超级群消息可增加、修改、删除扩展信息。 原始消息增加状态标识的需求,都可使用消息扩展。
- 消息评论需求,可通过设置原始消息扩展信息的方式添加评论信息。
- 礼物领取、订单状态变化需求,通过此功能改变消息显示状态。 例如:向用户发送礼物,默认为未领取状态,用户点击后可设置消息扩展为已领取状态。
更新消息扩展
方法
int updateUltraGroupMessageExpansion(
string messageUId,
Dictionary<string, string> expansion
)
参数说明
参数 | 类型 | 说明 |
---|---|---|
messageUId | string | 要扩展的全局消息ID |
expansion | Dictionary<string, string> | 要扩展的信息 |
返回值
返回值 | 描述 |
---|---|
int | 当次接口操作状态码,并不代表最终操作结果,状态码详细信息 |
代码示例
int code = engine.updateUltraGroupMessageExpansion(
messageUId,
expansion
);
回调方法
- onUltraGroupMessageExpansionUpdated
delegate void OnUltraGroupMessageExpansionUpdatedDelegate(int code,
Dictionary<string, string> expansion,
string messageUId);
OnUltraGroupMessageExpansionUpdatedDelegate onUltraGroupMessageExpansionUpdated;
参数说明
参数 | 类型 | 说明 |
---|---|---|
code | int | 接口回调的状态码,0 代表成功,非 0 代表出现异常 |
expansion | Dictionary<string, string> | 要扩展的信息 |
messageUId | string | 要扩展的全局消息ID |
代码示例
engine.onUltraGroupMessageExpansionUpdated = delegate(
int code,
Dictionary<string, string> expansion,
string messageUId
)
{
}
删除消息扩展
方法
int removeUltraGroupMessageExpansion(
string messageUId,
List<string> keys
)
参数说明
参数 | 类型 | 说明 |
---|---|---|
messageUId | string | 要扩展的全局消息ID |
keys | List<string> | 要删除的key |
返回值
返回值 | 描述 |
---|---|
int | 当次接口操作状态码,并不代表最终操作结果,状态码详细信息 |
代码示例
int code = engine.removeUltraGroupMessageExpansion(
messageUId,
keys
);
回调方法
- onUltraGroupMessageExpansionRemoved
delegate void OnUltraGroupMessageExpansionRemovedDelegate(int code,
string messageUId,
List<string> keys);
OnUltraGroupMessageExpansionRemovedDelegate onUltraGroupMessageExpansionRemoved;
参数说明
参数 | 类型 | 说明 |
---|---|---|
code | int | 接口回调的状态码,0 代表成功,非 0 代表出现异常 |
messageUId | string | 要扩展的全局消息ID |
keys | List<string> | 要删除的key |
代码示例
engine.onUltraGroupMessageExpansionRemoved = delegate(
int code,
string messageUId,
List<string> keys
)
{
}
监听远端消息扩展更新
当远端消息的扩展信息被更新时,会回调此方法。
方法
delegate void OnRemoteUltraGroupMessageExpansionUpdatedDelegate(
List<RCIMMessage> messages);
OnRemoteUltraGroupMessageExpansionUpdatedDelegate onRemoteUltraGroupMessageExpansionUpdated;
参数说明
参数 | 类型 | 说明 |
---|---|---|
messages | List<RCIMMessage> | 发生变化的消息 |
代码示例
engine.onRemoteUltraGroupMessageExpansionUpdated = delegate(
List<RCIMMessage> messages
)
{
}