一、功能描述
·在投票场景，我们可以先创建一条用于投票的自定义消息，其中 custom_elem_data 存储投票的标题和选项，然后用消息扩展 key 存储投票用户 ID，用消息扩展 value 存储投票用户选项，有了每个用户的投票选项，我们就可以动态计算出投票选项的用户占比。
·在接龙场景，我们可以先创建一条用于接龙的自定义消息，其中 custom_elem_data 存储接龙的标题，然后用消息扩展 key 存储接龙用户 ID，用消息扩展 value 存储接龙信息。
·在问卷调查场景，我们可以先创建一条用于问卷调查的自定义消息，其中 custom_elem_data 存储问卷调查的标题和选项，然后用消息扩展 key 存储问卷调查的用户 ID，用消息扩展 value 存储问卷调查信息。
注意：说明：
二、设置消息扩展
调用 MsgSetMessageExtensions (点击查看详情) 接口可以设置消息扩展，如果扩展 key 已经存在，则修改扩展的 value 信息，如果扩展 key 不存在，则新增扩展。
设置消息扩展接口入参详解如下：
| 属性 | 含义 | 说明 |
| message | 消息对象 | 消息需满足三个条件：消息发送前需设置 message_support_message_extension (点击查看详情) 为 true。消息必须是发送成功的状态。消息不能是社群（Community）和直播群（AVChatRoom）消息。 |
| extensions | 扩展列表 | 如果扩展 key 已经存在，则修改扩展的 value 信息，如果扩展 key 不存在，则新增扩展。 |
注意：说明：
注意：1. 扩展 key 最大支持 100 字节，扩展 value 最大支持 1KB，单次最多支持设置 20 个扩展，单条消息最多可设置 300 个扩展。
注意：2. 当多个用户同时设置或删除同一个扩展 key 时，只有第一个用户可以执行成功，其它用户会在设置回包收到 23001 错误码和最新的扩展信息，在收到错误码和扩展信息后，请按需重新发起设置操作。
注意：3. 我们强烈建议不同的用户设置不同的扩展 key，这样大部分场景都不会冲突，例如投票、接龙、问卷调查，都可以把自己的 userID 作为扩展 key。
示例代码如下：
// 设置消息扩展 var list = new List<MessageExtension> { new MessageExtension { message_extension_key = "key", message_extension_value = "value" } }; TIMResult res = TencentIMSDK.MsgSetMessageExtensions(message, list, (int code, string desc, List<MessageExtensionResult> results, string user_data)=>{ // 设置消息扩展异步结果 });
三、获取消息扩展
调用 MsgGetMessageExtensions (点击查看详情) 接口获取消息扩展列表。
注意：说明：
注意：如果没有网络，SDK 会直接返回本地缓存的消息扩展列表。
示例代码如下：
// 获取消息扩展 TIMResult res = TencentIMSDK.MsgGetMessageExtensions(message, (int code, string desc, List<MessageExtension> list, string user_data)=>{ // 获取消息扩展异步结果 });
四、删除消息扩展
调用 MsgDeleteMessageExtensions (点击查看详情) 接口删除指定消息扩展，如果 keys 字段填 null ，则会清空所有消息扩展。
示例代码如下：
// 删除消息扩展 var list = new List<MessageExtension> { new MessageExtension { message_extension_key = "key", message_extension_value = "value" } }; TIMResult res = TencentIMSDK.MsgDeleteMessageExtensions(message, list, (int code, string desc, List<MessageExtensionResult> results, string user_data)=>{ // 删除消息扩展异步结果 });
五、消息扩展更新
如果你事先调用 SetMsgExtensionsChangedCallback 添加了高级消息事件监听器，当消息扩展发生了新增或者更新，你会收到 MsgExtensionsChangedCallback (点击查看详情) 回调。
如果你事先调用 SetMsgExtensionsDeletedCallback 添加了高级消息事件监听器，当消息扩展发生了删除，你会收到 MsgExtensionsDeletedCallback (点击查看详情) 回调。
示例代码如下：
// 添加高级消息的事件监听器 TencentIMSDK.SetMsgExtensionsChangedCallback((string message_id, List<MessageExtension> message_extension_array, string user_data) => { // message_extension_array 为被修改之后的消息扩展对象列表 }); TencentIMSDK.SetMsgExtensionsDeletedCallback((string message_id, List<MessageExtension> message_extension_array, string user_data) => { // message_extension_array 为被删除之后的消息扩展对象列表 });