快速开始指南

接入表情MM SDK,有以下必要步骤:

  1. 下载与安装
  2. 获取必要的接入信息
  3. 开始集成

第一步:下载与安装

目前有两种方式安装表情mm SDK:

  • 通过CocoaPods管理依赖。
  • 手动导入SDK并管理依赖。

1. 使用 CocoaPods 导入SDK

在终端中运行以下命令:

pod search BQMM

如果运行以上命令,没有搜到表情mm SDK,或者搜不到最新的 SDK 版本,您可以运行以下命令,更新您本地的 CocoaPods 源列表。

pod repo update

在您工程的 Podfile中添加最新版本的SDK(在此以1.2.1版本为例):

pod 'BQMM', '1.2.1'

然后在工程的根目录下运行以下命令:

pod install

2. 手动导入SDK

下载当前最新版本,解压缩后获得两个文件夹

  • BQMM
  • BQMM_EXT

BQMM中包含SDK所需的资源文件BQMM.bundle和库文件BQMM.frameworkBQMM_EXT提供了SDK的默认消息显示控件和消息默认格式的开源代码,开发者们导入后可按需修改。

3. 添加系统库依赖

您除了在工程中导入 SDK 之外,还需要添加libz动态链接库。

第二步:获取必要的接入信息

开发者将应用与SDK进行对接时,必要接入信息如下

  • appId - 应用的App ID
  • appSecret - 应用的App Secret

以上信息可以在表情云开发者注册页面获取。

第三步:开始集成

  1. 引用库文件

     #import <BQMM/BQMM.h>
    
  2. 设置接入信息

     [[MMEmotionCentre defaultCentre] setAppId:appId secret:appSecret];
    
  3. 设定表情键盘代理

     [MMEmotionCentre defaultCentre].delegate = self;
    
  4. 实现代理方法

- (void)didSelectEmoji:(MMEmoji *)emoji {
}

- (void)didSendWithInput:(UIResponder<UITextInput> *)input {
}

一个完整示例(Demo)

#import "ViewController.h"
#import <BQMM/BQMM.h>

@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 = @"YOUR_APP_ID";
    NSString *appSecret = @"YOUR_APP_SECRET";
    [[MMEmotionCentre defaultCentre] setAppId:appId
                                       secret:appSecret];
    [MMEmotionCentre defaultCentre].delegate = self;
}

- (IBAction)btnPressed:(id)sender {
    _btn.selected = !_btn.selected;
    if (_btn.selected) {

        //将输入框设为firstResponder
        if (!_inputTextView.isFirstResponder) {
            [_inputTextView becomeFirstResponder];
        }

        [[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;
}

- (void)didSendWithInput:(UIResponder<UITextInput> *)input {
   [self sendText:self.input.mmText];
}

@end

results matching ""

    No results matching ""