本文介绍如何使用swift快速集成环信即时通讯 IM iOS SDK 实现单聊。
前提条件
• Xcode (推荐最新版本)。
• 安装 iOS 10.0 或更高版本的 iOS 模拟器或 Apple 设备。
• CocoaPods 1.10.1 或更高版本。
• 有效的环信即时通讯 IM 开发者账号(注册环信账号)和 App Key,见 环信即时通讯云管理后台。
• 如果你的网络环境部署了防火墙,请联系环信技术支持设置白名单。
集成方式
使用CocoaPods来添加环信SDK,具体步骤如下:
platform :ios, ‘10.0’
use_frameworks!
target ‘YourTarget’ do
pod ‘HyphenateChat’, ‘~> 4.0.2’
end
然后在终端中运行pod install,即可将环信SDK添加到项目中。
因为环信sdk是OC的代码,所以需要创建桥接文件(Bridging Header)来让Swift可以调用Objective-C的代码和库。下面是创建桥接文件的步骤:
1. 创建桥接文件
在Xcode项目中,选择File -> New -> File…,在弹出的对话框中选择iOS -> Source -> Header File,然后给该文件起一个名字,例如YourProjectName-Bridging-Header.h
2.配置桥接文件选项
在桥接文件的属性中,设置Objective-C Bridging Header选项。具体操作如下:
• 选中项目,在Xcode菜单中选择Build Settings
• 在搜索框中输入bridging header,找到Objective-C bridges Header选项
• 双击该选项,然后在弹出的对话框中输入桥接文件的路径,例如$(SRCROOT)/YourProjectName/YourProjectName-Bridging-Header.h
3.导入Objective-C头文件
// YourProjectName-Bridging-Header.h #import <HyphenateChat/HyphenateChat.h>
4.初始化环信SDK
在AppDelegate.swift文件中的application(_:didFinishLaunchingWithOptions方法中初始化环信SDK。以下是初始化代码示例:
let options = EMOptions(appkey: "yourappkey#demo") let error = EMClient.shared().initializeSDK(with: options) if error == nil { //初始化成功 } else { //初始化失败 }
5.登录环信服务器
注册服务端账号:http://docs-im-beta.easemob.com/document/server-side/account_system.html
EMClient.shared().login(withUsername: "yourUsername", password: "yourPassword") { (aUserName, aError) in if aError != nil { //登录失败处理 print("\(aUserName) login fail") }else { //登录成功处理 print("\(aUserName) login success") } }
6.发送消息
初始化聊天页面文档链接:http://docs-im-beta.easemob.com/document/ios/quickstart.html#_4-
let chatText = "Hello, World!" let message = EMChatMessage(conversationID: "yourConversationID", from: "yourFrom", to: "yourTo", body: EMTextMessageBody(text: chatText), ext: ["yourKey": "yourValue"]) message.chatType = EMChatTypeChat // 设置为单聊消息 EMClient.shared().chatManager?.send(message, progress: nil) { (aMessage, aError) in if let error = aError { // 发送失败处理 } else { // 发送成功处理 } }
至此,即时通讯的基本功能已经集成完,如果您在集成中遇到问题可以随时联系环信技术支持或IMGeek社区提问。
SDK地址:https://www.easemob.com/download/im
IMGeek社区:
https://www.imgeek.net/
来源:即时通讯网 - 即时通讯开发者社区!
轻量级开源移动端即时通讯框架。
快速入门 / 性能 / 指南 / 提问
轻量级Web端即时通讯框架。
详细介绍 / 精编源码 / 手册教程
移动端实时音视频框架。
详细介绍 / 性能测试 / 安装体验
基于MobileIMSDK的移动IM系统。
详细介绍 / 产品截图 / 安装体验
一套产品级Web端IM系统。
详细介绍 / 产品截图 / 演示视频
知名即时通讯相关技术服务商。
Copyright © 2014-2024 即时通讯网 - 即时通讯开发者社区 / 版本 V4.4
苏州网际时代信息科技有限公司 (苏ICP备16005070号-1)
Processed in 0.093750 second(s), 29 queries , Gzip On.