表情云商店SDK1.x到3.x版本升级指南-Android

• BQMM更名为DongtuStore
• 其他类的BQMM前缀全部更名为DTStore
• Text后缀更改为View

一、初始化

SDK新增了一个必须传入用户信息的初始化要求，在完成initConfig之后、使用其他功能之前，须调用setUserInfo`方法。传入哪些用户信息是可选的，唯一的要求是给每个用户传入一个唯一的userID，否则v3.x加入的收藏功能将无法正常使用。

v3.x对load()的调用变成了可选的。SDK内部会根据情况自动调用load()的逻辑。

二、消息封装

大表情消息曾经被作为Emoji对象传给回调，但如今变成了一个DTStoreSticker对象。前者的EmoCode和EmoText属性分别对应后者的code和text

三、消息展示

展示文字以及小表情与文字混合消息的接口变为DTStoreMessageView.showText()。

展示大表情的接口变为DTStoreMessageView.showSticker()，传入发送消息回调收到的表情code。

在以前的版本中，展示大表情时传入的是一个JSONArray，开发者可能也将大表情消息封装为了一个JSONArray，升级到新版时需要从JSONArray中将code取出来。例如，如果消息是[["abcdefg", 1]]，那么code就是abcedfg。

四、消息版本兼容

对于大表情消息，新版和旧版的code有区别，v3.x能够兼容v1.x的code，v1.x无法兼容v3.x的code，所以建议开发者进行消息封装和解析时，将新版本的大表情消息封装成新的消息类型，同时逻辑上让旧版本处理到这个新的消息类型时，认为是文字消息，或者未知消息，或可提示用户升级客户端。

五、接入动图表情消息

SDK新增了一种动图消息，和大表情消息有所区别。请参照集成指南对新功能进行集成。

六、联想弹窗

联想弹窗的功能由发送大表情变成了发送动图。请先完成动图表情消息的接入，然后将设置联想弹窗的函数改为

DongtuStore.setupSearchPopupAboveView(View anchor, DTStoreEditView input)

七、接入收藏功能

SDK从v3.x开始，加入了收藏表情和Gif的功能。每个用户拥有一个独立的收藏库，作为一个tab显示在键盘中。SDK提供了专门的UI进行收藏内容的删除和排序操作，但开发者需要调用SDK接口实现收藏内容的添加。