createFaceMessage
功能介绍
创建表情消息
表情消息会直接发送表情编码,通常接收端需要将其转换成对应的表情 icon。
SDK 并不提供表情包,如果开发者有表情包,可使用 index 存储表情在表情包中的索引,或者使用 data 存储表情映射的字符串 key,这些都由用户自定义,SDK 内部只做透传。
为方便您快速使用表情能力,我们提供官方表情面板插件包,tim_ui_kit_sticker_plugin,您可按需使用。
参数详解
参数名称 | 参数类型 | 是否必填 | 平台 | 描述 |
---|---|---|---|---|
index | int | 是 | 全部 | 表情索引 |
data | String | 是 | 全部 | 自定义数据 |
返回模板
V2TimValueCallback<V2TimMsgCreateInfoResult>
{
code: int,
desc: String,
data: {
id: String,
messageInfo: V2TimMessage,
}
}
返回值详解
名称 | 数值类型 | 描述 |
---|---|---|
code | int | 请求结果错误码 |
desc | String | 请求结果描述 |
data | V2TimMsgCreateInfoResult | 创建后的表情信息 |
代码示例
// 创建表情消息
V2TimValueCallback<V2TimMsgCreateInfoResult> createFaceMessageRes =
await TencentImSDKPlugin.v2TIMManager
.getMessageManager()
.createFaceMessage(
index: 0,// 表情索引
data: "自定义消息",
);
if (createFaceMessageRes.code == 0) {
String? id = createFaceMessageRes.data?.id;
// 发送表情消息
// 在sendMessage时,若只填写receiver则发个人用户单聊消息
// 若只填写groupID则发群组消息
// 若填写了receiver与groupID则发群内的个人用户,消息在群聊中显示,只有指定receiver能看见
V2TimValueCallback<V2TimMessage> sendMessageRes = await TencentImSDKPlugin
.v2TIMManager
.getMessageManager()
.sendMessage(id: id!, receiver: "userID", groupID: "groupID");
if (sendMessageRes.code == 0) {
// 发送成功
}
}