表情mm商店iOS版快速开始指南.doc

表情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 *)guid13. / img 被选中表情对象的UIImage,主要用于表现14. / data 被选中表情对象的NSData,主要用于数据传输15. / emojiCode 被选中表情对象的NSString,内测版暂时没有开放 16. / identifier 表情对象的唯一识别号17. 一个完整示例(Demo)#import ViewController.h#import interface ViewController () property (weak, nonatomic) IBOutlet UITextField *textField;property (weak, nonatomic) IBOutlet UIButton *btn;property (weak, nonatomic) IBOutlet UIImageView *imgView;endimplementation ViewController- (void)viewDidLoad super viewDidLoad; NSString *appId = YOUR_APP_ID; NSString *appSecret = YOUR_APP_SECRET; 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 - 顶部导航条颜色property (nonatomic, strong) UIColor *navigationBarColor; navigationBarTintColor - 顶部导航条文字颜色property (nonatomic, strong) UIColor *navigationBarTintColor; navigationTitleFont - 顶部导航条文字字体property (nonatomic, strong) UIFont *navigationTitleFont; separateColor - 水平分隔线颜色property (nonatomic, strong) UIColor *separateColor; shopCategoryFont - 表情分类名文字字体property (nonatomic, strong) UIFont *shopCategoryFont; shopCategoryColor - 表情分类名文字颜色property (nonatomic, strong) UIColor *shopCategoryColor; shopPackageTitleFont - 表情包标题文字字体property (nonatomic, strong) UIFont *shopPackageTitleFont; shopPackageTitleColor - 表情包标题文字颜色property (nonatomic, strong) UIColor *shopPackageTitleColor; shopPackageSubTitleFont - 表情包子标题文字字体property (nonatomic, strong) UIFont *shopPackageSubTitleFont; shopPackageSubTitleColor - 表情包子标题文字颜色property (nonatomic, strong) UIColor *shopPackageSubTitleColor; detailPackageTitleFont - 表情包详情页标题文字字体property (nonatomic, strong) UIFont *detailPackageTitleFont; detailPackageTitleColor - 表情包详情页标题文字颜色property (nonatomic, strong) UIColor *detailPackageTitleColor; detailPackageDescFont - 表情包详情页描述文字字体property (nonatomic, strong) UIFont *detailPackageDescFont; detailPackageDescColor - 表情包详情页描述文字颜色property (nonatomic, strong) UIColor *detailPackageDescColor; detailPackagePreviewFont - 表情包详情页长按表情可预览文字字体property (nonatomic, strong) UIFont *detailPackagePreviewFont; detailPackagePreviewColor - 表情包详情页长按表情可预览文字颜色property (nonatomic, strong) UIColor *detailPackagePreviewColor; downloadTitleFont - 表情包列表下载按钮文字字体property (nonatomic, strong) UIFont *downloadTitleFont; downloadedTilteColor - 表情包列表下载按钮文字颜色property (nonatomic, strong) UIColor *downloadedTilteColor; artCentreTitleFont - 表情作者主页标题文字字体(内测版暂未开放)property (nonatomic, strong) UIFont *artCentreTitleFont; artCentreTitleColor - 表情作者主页标题文字颜色(内测版暂未开放)property (nonatomic, strong) UIColor *artCentreTitleColor; artistTitleFont - 表情作者主页作者名文字字体(内测版暂未开放)property (nonatomic, strong) UIFont *artistTitleFont; artistTitleColor - 表情作者主页作者名文字颜色(内测版暂未开放)property (nonatomic, strong) UIColor *artistTitleColor; copyrightFont - 底部版权文字字体property (nonatomic, strong) UIFont *copyrightFont; copyrightColor - 底部版权文字颜色property (nonatomic, strong) UIColor *copyrightColor;Rest接口说明平台同步应用信息接口接口说明： 此接口主要是为了同步第三方接入平台与表情MM平台之间的app信息，以供第三方平台的应用正常使用表情MM平台所提供的表情服务。 Path：/api/v1/sync/platform_id Http Method： POST URL Params: timestamp=时间戳(毫秒)&signature=32位签名字符串(见下方：Signature计算方式) Request Header: Content-Type: application/json;charset=UTF-8 Request Body: apps: appEname: wechat, appName: 微信, externalId: huanxinW10012 / 第三方平台上的应用id , appEname: momo, appName: 陌陌, externalId: huanxinW10023 Response Body: data: apps: guid: c3c992c433cc42c3810667e3c00f3b6a, / 应用在表情MM上的app id appName: 微信, appsecret: 7f95ad21c2a34616a903a69b44d5585e, externalId: huanxinW10012 , guid: 14667389f86a48d68c452d99d1db629c, appName: 陌陌, appsecret: 02dd0933a47847438c75bfce8d446172, externalId: huanxinW10023 , error_code: 0, / 错误编码， 0 表示接口返回成功 message: / e