ZebraKing 3.0.8

ZebraKing 3.0.8

×

由eppeo维护。

ZebraKing 3.0.8

  • 由
  • eppeo

基于腾讯云通信，在Swift中优雅地使用即时通讯

CI Status Version License Platform

产品特色

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

要求

  • 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中添加使用系统麦克风的权限：隐私 - 麦克风使用描述

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

  • 访问照片权限 隐私 - 照片库使用描述
  • 访问相机权限 隐私 - 摄像头使用描述
  • 访问定位权限 隐私 - 持续定位使用描述
  • 访问保存照片权限 隐私 - 添加到照片库使用描述

开始使用

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

在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消息替换，这样就不需要在发送者是我还是对方上主动判断，并且也不需要在拉取资料给它赋值了。
  3. 发送消息时，个人资料不会显示。
  4. 点击时间戳没有触发响应，导致无法收回键盘。
  5. 新增插件功能，方便进行日志埋点。
  6. 在切换文本和语音消息时，如果文本消息超过一行，切换到发送语音状态后，inputBar会升高。

许可证

ZebraKing遵循MIT许可证。更多信息请参阅LICENSE文件。