CocoaPods trunk is moving to be read-only. Read more on the blog, there are 17 months to go.

ZebraKing 3.0.8

ZebraKing 3.0.8

×

Maintained by eppeo.

ZebraKing 3.0.8

  • By
  • eppeo

基于腾讯云通信,在swift中优雅的使用即时通讯

CI Status Version License Platform

产品特色

  • 高度可定制会话页面, 暴露接口可实现功能齐全
  • 支持富文本、语音、图片、视频、地理位置等消息,并可根据需求添加自定义消息类型
  • 文本消息支持手机号,地址,日期,URL识别
  • 支持根据chatId在未获取会话对象时,先监听未读消息数,降低耦合性,也不会造成内存泄漏
  • 没有过多依赖第三方库
  • 发送消息时, 根据上下文判断自动添加时间戳

要求

  • iOS 8.2
  • Swift 4.+

配置

使用CocoaPods工具进行安装

不出意外你现在使用的应该是swift项目, 但还是想提醒一下在Podfile别忘记加use_frameworks!然后就是在 Podfile中配置:

use_frameworks!
//swift4.2以前
pod 'ZebraKing', '~> 2.0.8'
//swift4.2及以后版本
pod 'ZebraKing', '~> 3.0.8'

手动安装

  1. 在Build Phases >> Link binary With Libraries 中添加系统依赖库:
  • CoreTelephony
  • SystemConfiguration
  • libc++.tbd
  • libsqlite3.tbd
  • libz.tbd
  1. 然后在Build Settings中 搜索Other Linker Flags 添加 -ObjC 注意大小写拼写. 因为云通信SDK本身不支持Bitcode编码,所以还需要将Enable Bitcode 的值修改为No

IM聊天支持语音输入,苹果在iOS8.0以后的版本中做了限制, 所以还需要在info.plist中添加使用系统麦克风的权限: Privacy - Microphone Usage Description

顺便你可能还需要其他的访问权限, 关于IM常用到的有这么几个:

  • 访问照片权限 Privacy - Photo Library Usage Description
  • 访问相机权限 Privacy - Camera Usage Description
  • 访问定位权限 Privacy - Location Always Usage Description
  • 访问保存照片权限 Privacy - Photo Library Additions Usage Description

开始使用

基础配置并处理消息通知的回调

在AppDelegate中完成初始化, 找到 didFinishLaunchingWithOptions 方法:

// 开发者申请key时可以拿到, 是固定值
let accountType: String = 12345
let appidAt3rd: String = 1234512345

ZebraKing.register(accountType: accountType, appidAt3rd: appid) {
    //新消息通知(登录之后有新消息过来才会调用)
    self.onResponseNotification($0)
}

ZebraKing将消息通知的回调暴露接口供外部使用, 开发者可以利用回调方法处理消息在前台或后台的展示逻辑

登录

let sign = xxxxxxx
let id = 123456
ZebraKing.login(sign: sign, userId: id, appidAt3rd: appid, result: { 
    switch $0 {
    case .success:
    //TODO:登录成功
    case .failure(let error):
    //TODO:登录失败
    }
})

发起会话

ZebraKing.chat(id: receiveId) { result in
                switch result {
                case .success(let conversation):
                    let chattingViewController = ChattingViewController(conversation: conversation)
                    let nav = UINavigationController(rootViewController: chattingViewController)
                    self.present(nav, animated: true, completion: nil)
                case .failure(_):
                    break
                }
            }

接收会话通知

func onResponseNotification(_ notification: ChatNotification) {
        
    //消息发送人的资料
    //let sender = notification.receiver

    //推送的内容
    let content = notification.content

    if case .background = UIApplication.shared.applicationState {
        //处理本地系统推送(只会在后台推送)
        UIApplication.localNotification(title: "推送消息", 
                                        body: content ?? "您收到一条新消息", 
                                        userInfo: ["id": sender.id]) /* 不可将Sender对象直接当做value传入*/
    } else {
        presentChatting(with: sender.id)
    }
    
}

private func presentChatting(with id: String) {
     ZebraKing.chat(id: id) { result in
           switch result {
           case .success(let conversation):
                let vc = ChattingViewController(conversation: conversation)
                let nav = UINavigationController(rootViewController: vc)
                self.present(nav, animated: true, completion: nil)
           case .failure(_): 
               //TODO:
               break
           }
     }
}

版本更新

2.0.8

  1. 修复监听未读消息时, 可能出现监听失效的情况

2.0.7

  1. 修改MessageViewController方法作用域, 便于子类自定义配置.
  2. 移除CommonViewController类, 其功能在上游实现, 避免多级集成带来的阅读压力
  3. 为chat()方法新增一个可选参数, 将配置聊天对象资料的信息封装起来
  4. 解决在iPhone X上的适配问题, 修复刷新视图显示错误

下个版本需要优化的内容

  1. 需要给MessageStatus一个(prepare)状态, 现在语音录制时, 使用的是发送中状态,导致真正到发送中时, 没有loading加载效果不好
  2. 取消消息未发出去时,使用sdk消息替换, 这样就不需要主动判断sender是我还是对方, 并且还不用在拉取资料给它赋值了
  3. 发消息出去, 个人资料不显示
  4. 点击时间戳没有触发响应导致不能收回键盘
  5. 新增插件的功能, 方便做日志埋点
  6. 切换文本和语音消息是, 如果文本消息超过一行, 当切换到发送语音状态后, inputBar会升高

License

ZebraKing is available under the MIT license. See the LICENSE file for more info.