表情MM SDK
表情MM SDK是上海似颜绘科技有限公司提供的表情商店SDK, 开发者可以利用此SDK集成丰富的表情。
快速开始指南
接入表情MM SDK，有以下必要步骤：
1. 下载与安装
2. 获取必要的接入信息 3. 开始集成
第一步：下载与安装
当前最新版本: r1217.zip 更新内容：
新增根据emo_code批量获取表情信息接口
? - (void)fetchEmojisByCodes:(NSArray *)emojiCodes
completionHandler:(void (^)(NSArray *emojis, NSError *error))completionHandler;
? ?
// emojiCodes是传入的emojiCode的数组
? // completionHandler block返回emojis数组 ? // 传入的数组元素类型为NSString ? // 输出的数组元素类型为MMEmoji
? ? ? ? ?
更新界面UI 修复之前的一些Bugs
开放根据表情code获取表情信息接口:
? [[MMEmotionCentre defaultCentre] fetchEmojiByCode:@“emojicode”
completionHandler:^(MMEmoji *emoji, NSError *error) {
? ? ?
}];
支持图文混排
1.支持小表情
? 2.开启/关闭此功能: [[MMEmotionCentre defaultCentre]
setSupportedMixedTextImage:YES];
3.获取图文混排文本内容 [UITextField mm_text] or [UITextView mm_text] ? 4.使用“MMTextView”展示图文混排内容 [MMTextView setMM_text:]
5.布局textView: [MMText mm_sizeThatFits:]
?
解压缩后获得两个文件
? ?
BQMM.bundle - 表情MM iOS SDK资源文件 BQMM.framework - 表情MM iOS SDK库文件
将上述BQMM.framework 和 BQMM.bundle加入到待开发的工程中
第二步：获取必要的接入信息
开发者将应用与SDK进行对接时,必要接入信息如下
? ?
appId - 应用的App ID
appSecret - 应用的App Secret
以上信息在内测阶段由我方技术人员负责提供
第三步：开始集成
1. 引用库文件
2.
3. #import
4. 设置接入信息
5.
6. [[MMEmotionCentre defaultCentre] setAppId:appId
secret:appSecret];
7. 设定表情键盘代理
8.
9. [MMEmotionCentre defaultCentre].delegate = self;
10. 实现代理方法
11. 12. - (void)didSelectEmoji:(UIImage *)img data:(NSData *)data
withCode:(NSString *)emojiCode identifier:(NSString *)guid{ 13. // img 被选中表情对象的`UIImage`,主要用于表现 14. // data 被选中表情对象的`NSData`,主要用于数据传输 15. // emojiCode 被选中表情对象的`NSString`,内测版暂时没有开放 16. // identifier 表情对象的唯一识别号 17. }
一个完整示例(Demo)
#import \
#import
@interface ViewController ()
@property (weak, nonatomic) IBOutlet UITextField *textField; @property (weak, nonatomic) IBOutlet UIButton *btn;
@property (weak, nonatomic) IBOutlet UIImageView *imgView;
@end
@implementation ViewController
- (void)viewDidLoad { [super viewDidLoad];
NSString *appId = @\
NSString *appSecret = @\
[[MMEmotionCentre defaultCentre] setAppId:appId
secret:appSecret]; [MMEmotionCentre defaultCentre].delegate = self; }
- (void)didReceiveMemoryWarning { [super didReceiveMemoryWarning]; }
- (IBAction)btnPressed:(id)sender { _btn.selected = !_btn.selected; if (_btn.selected) {
[[MMEmotionCentre defaultCentre] attachEmotionKeyboardToInput:_textField]; }else {
[[MMEmotionCentre defaultCentre] switchToDefaultKeyboard]; } }
#pragma mark - emotion centre delegate
- (void)didSelectEmoji:(UIImage *)img data:(NSData *)data withCode:(NSString *)emojiCode{ _imgView.image = img; } @end
类引用说明
BQMM/MMEmotionCentre.h
说明: 表情MM iOS SDK核心头文件
?
MMEmotionCentreDelegate协议方法 - 表情点击回调
- (void)didSelectEmoji:(UIImage *)img data:(NSData *)data withCode:(NSString *)emojiCode identifier:(NSString *)guid;
?
指定表情点击回调代理
@property (nonatomic, weak) id delegate;
?
shouldShowShotcutPopoverAboveView - 根据文字弹出候选表情
- (void)shouldShowShotcutPopoverAboveView:(UIView *)attchedView withInput:(UIResponder *)input;
// attachedView: 表情提示bubble出现在这个view上 // input： 侦测这个input试图的输入变化
? controllerForEmotionId - 长按已发出的表情显示表情原图
- (UIViewController *)controllerForEmotionId:(NSString *)eId; // eId：表情的Id
?
defaultCentre - 表情管理中心默认实例(单例)
+ (instancetype)defaultCentre;
?
userId - (可选)如传递当前登录userId,后期可获取特定用户表情使用习惯等
- (void)setUserId:(NSString *)userId;
?
switchToDefaultKeyboard - 切换到到默认键盘视图
- (void)switchToDefaultKeyboard;
?
setTheme - 设置表情商店主题,主题对象参考 MMTheme.h
- (void)setTheme:(MMTheme *)theme;
?
attachEmotionKeyboardToInput - 切换到到表情MM键盘视图
- (void)attachEmotionKeyboardToInput:(UIResponder *)input;
?
inputView - (可选)表情MM键盘视图,用于表情MM键盘视图高级定制
- (UIView *)inputView;
BQMM/MMTheme.h
说明: 表情MM iOS SDK外观定制头文件
?
navigationBarColor - 顶部导航条颜色