无 UI 集成方案

服务端 API

诚邀爱技术、爱分享的你,成为文档内容共建者> HOT

TUIChat 支持添加自定义表情。

新增自定义表情

TUIChat 支持从沙盒、assets 目录以及网络路径加载自定义表情。
以添加 assets 目录下的 programmer 表情为例:

准备表情包资源

App 的 src/main 文件夹下新建 assets 文件夹,将表情文件夹放在 App 的 assets 目录下:

添加表情包

在应用启动时调用接口将自定义表情添加到 FaceManager :
每个表情包都有唯一的 faceGroupID,表情包中的每个表情对应一个 faceKey,表情包添加到 FaceManager 中之后“更多表情”输入界面会根据 faceGroupID 的大小进行排序显示。

public class DemoApplication extends Application {
    @Override
    public void onCreate() {
        FaceGroup programmerGroup = new FaceGroup();
        // 更多表情输入界面每行显示个数
        programmerGroup.setPageColumnCount(5);
        // 更多表情输入界面表情行数
        programmerGroup.setPageRowCount(2);
        // 表情包封面
        programmerGroup.setFaceGroupIconUrl("file:///android_asset/programmer/programmer00@2x.png");
        // 表情包名称
        programmerGroup.setGroupName("programmer");
        for (int i = 0; i < 16; i++) {
            CustomFace customFace = new CustomFace();
            String index = "" + i;
            if (i < 10) {
                index = "0" + i;
            }
            // 设置表情在 assets 的路径,如果路径为沙盒路径或者网络路径可以使用 setFaceUrl 方法
            customFace.setAssetPath("programmer/programmer" + index + "@2x.png");
            // 表情的标识(key)
            String faceKey = "programmer" + index;
            customFace.setFaceKey(faceKey);
            // 更多表情输入界面表情显示宽度
            customFace.setWidth(170);
            // 更多表情输入界面表情显示高度
            customFace.setHeight(170);
            programmerGroup.addFace(faceKey, customFace);
        }
        // 向 FaceManager 中注册该表情包,FaceGroupID 为 1
        FaceManager.addFaceGroup(1, programmerGroup);
    }
}

添加成功的效果

添加成功之后,打开聊天界面“更多表情”输入界面即可看到新添加的表情包:

注意:

faceGroupID 是大于 0 的整数而且不可重复。

发送自定义表情

添加自定义表情之后,可以在聊天的“更多表情”输入界面看到已经添加的表情,点击表情即可发送。

也可以使用代码生成表情消息然后发送,例如:

V2TIMMessage v2TIMMessage = V2TIMManager.getMessageManager()
        .createFaceMessage(faceGroupID, faceKey.getBytes());
V2TIMManager.getMessageManager().sendMessage(v2TIMMessage,
        userID,
        null,
        V2TIMMessage.V2TIM_PRIORITY_DEFAULT,
        false,
        null,
        new V2TIMSendCallback<V2TIMMessage>() {...}

解析自定义表情

接收到自定义表情消息之后,TUIKit 会将 IMSDK 的 V2TIMMessage 解析为 FaceMessageBean 类型,可以由 FaceMessageBean 获得自定义表情的 faceGroupID 和 faceKey

TUIMessageBean messageBean = ChatMessageParser.parseMessage(v2TIMMessage);
FaceMessageBean faceMessageBean = null;
if (messageBean instanceof FaceMessageBean) {
    faceMessageBean = (FaceMessageBean) messageBean;
}
if (faceMessageBean != null) {
    int faceGroupID = faceMessageBean.getIndex();
    String faceKey = null;
    if (faceMessageBean.getData() != null) {
        faceKey = new String(faceMessageBean.getData());
    }
}

渲染自定义表情

调用现有接口渲染

得到自定义表情的 faceGroupID 和 faceKey 之后,可以调用 FaceManager 的 loadFace 方法直接加载到传入的 imageView 上:

FaceManager.loadFace(faceGroupID, faceKey, imageView);

自定义渲染

也可以通过表情的 faceGroupID 和 faceKey,从 FaceManager 中获取到表情的真实 url,再通过得到的 url 自定义渲染,例如:

String faceUrl = "";
List<FaceGroup> faceGroupList = FaceManager.getFaceGroupList();
for(FaceGroup faceGroup : faceGroupList) {
    if (faceGroup.getGroupID() == faceGroupID) {
        ChatFace face = faceGroup.getFace(faceKey);
        if (face != null) {
            faceUrl = face.getFaceUrl();
        }
    }
}

// load faceUrl into view

渲染效果

渲染效果如图所示:

交流与反馈

欢迎加入 QQ 群进行技术交流和反馈问题。

目录