iOS - XMPP 的使用

最新推荐文章于 2018-06-27 15:13:28 发布
最新推荐文章于 2018-06-27 15:13:28 发布
阅读量658 收藏
点赞数
分类专栏： XMPP

  1. iOS - XMPP 的使用

    1、XMPP

    • XMPP 是一个基于 Socket 通信的即时通讯的协议，它规范了即时通信在网络上数据的传输格式，比如登录，获取好友列表等等的格式。XMPP 在网络传输的数据是 XML 格式。

    • 开发架构：

      IM3

    • iOS 框架：XMPPFramework

    • 服务器：Openfire

    • 数据库：MySQL

    2、XMPPFramework 框架简介

    2.1 XMPPFramework 简介

    • XMPPFramework 是一个 OS X/iOS 平台的开源项目，使用 Objective-C 实现了 XMPP 协议（RFC-3920），同时还提供了用于读写 XML 的工具，大大简化了基于 XMPP 的通信应用的开发。

    2.2 XMPPFramework 结构

    • 1、XMPPFramework 的目录结构如下：

      IM5

      目录 说明
      Authentication 授权，与授权验证相关，如用户名密码等
      Categories 分类，XMPP 自己写的一些分类，尤其是 NSXMLElement+XMPP 扩展是必备的
      Core 核心，这里是 XMPP 的核心文件目录，我们最主要的目光还是要放在这个目录上
      Extensions 扩展，XMPP 的扩展模块，用于扩展各种协议和各种独立的功能，其下每个子目录都是对应的一个单独的子功能
      Utilities 工具，都是辅助类，我们开发者不用关心这里
      Vendor 第三方库，这个目录是 XMPP 所引用的第三方类库，我们也不用关心这里

      • 虽然这里有很多个目录，但是我们在开发中基本只关心 Core 和 Extensions 这两个目录下的类。

      • 在 Core 中：

        目录 说明
        XMPPElement 是一个基类，延展出三个子类
        XMPPIQ 请求，用户登录，用户注册，添加好友等
        XMPPMessage 消息，用来发各种消息等
        XMPPPresence 展现，用户上线下线提示等
        XMPPStream 流，非常常用，大部分类的加载都在写在流的懒加载里

      • 在 Extensions 中：

        目录 说明
        CoreDataStorage coreData 存储
        Reconnect 重新连接
        Roster 好友管理
        SystemInputActivityMonitor 系统输入的活动监控

      • 在 Vendor 中：

        文件夹 说明
        CocoaAsyncSocket 异步 Socket
        CocoaLumberjack ⽇志相关
        KissXML XML 解析

    • 2、XMPPFramework 中常用的类：

      类 说明
      XMPPStream XMPP 基础服务类
      XMPPRoster 好友列表类
      XMPPUserCoreDataStorageObject 管理用户的类
      XMPPRosterCoreDataStorage 好友列表（用户账号）在 core data 中的操作类
      XMPPvCardCoreDataStorage 好友名片（昵称，签名，性别，年龄等信息）在 core data 中的操作类
      XMPPvCardTemp 好友名片实体类，从数据库里取出来的都是它
      xmppvCardAvatarModule 好友头像
      XMPPReconnect 如果失去连接，自动重连
      XMPPRoom 提供多用户聊天支持
      XMPPPubSub 发布订阅
      XMPPMessageArchiving 其中有数据表
      XMPPMessageArchiving_Message_CoreDataObject 取出当前信息的类

    • 3、XMPPFramework 几个常用到的扩展协议：

      协议 协议简介
      XEP-0006 使能与网络上某个 XMPP 实体间的通信
      XEP-0009 在两个 XMPP 实体间传输 XML-RPC 编码请求和响应
      XEP-0012 最后的活动（判断上线，离开断开）
      XEP-0045 多人聊天相关协议
      XEP-0054 名片格式的标准文档，个人信息设置
      XEP-0060 提供通用公共订阅功能
      XEP-0065 两个 XMPP 用户之间建立一个带外流，主要用于文件传输，sockets5 字节流
      XEP-0066 二进制数据传输（特殊信息的发送）
      XEP-0082 日期和时间信息的标准化表示
      XEP-0085 聊天对话中通知用户状态，聊天状态通知
      XEP-0100 表述了 XMPP 客户端与提供传统的 IM 服务的代理网关之间交换的最佳实践
      XEP-0115 广播和动态发现客户端、设备、或一般实体能力
      XEP-0136 为服务端备份和检索 XMPP 消息定义机制和偏好设置，聊天记录归档
      XEP-0153 用于交换用户头像，基于名片的头像
      XEP-0184 消息送达回执协议
      XEP-0199 XMPP ping 协议（用来 ping 服务器和 ping 自己）
      XEP-0202 用于交换实体间的本地时间信息
      XEP-0203 用于延迟发送
      XEP-0224 引起另一个用户注意的协议
      XEP-0335 JSON 容器（可能以后某些信息传输将用 JSON 格式）

      • XMPP 的扩展协议 Jingle 使得其支持语音和视频，目前 iOS 尚不支持。

        • iOS 发送附件（图片，语音，文档…）时比较麻烦，XMPP 框架没有提供发送附件的功能，需要自己实现。

        • iOS 发送附件实现方法：

          • 1、将获取到的图片／音频文件通过 base64 加密，直接通过 xmpp 的消息体发送过去，然后解码。

          • 2、通过 http 请求的方式将图片／音频文件上传到服务器，然后将图片／音频文件的下载地址通过 xmpp 消息体发送过去，另外一个客户端下载。

          • 音频文件建议转码为 amr，这种格式的音频文件比较小。

    2.3 XMPPJID 类

    • 登录需要到账号，而所谓的账号其实就是用户唯一标识符（JID），在 XMPP 中使用 XMPPJID 类来表示。

    • JID 一般由三部分构成：用户名，域名和资源名，格式为 user@domain/resource，例如：test@example.com/Anthony。对应于 XMPPJID 类中的三个属性 user、domain、resource。

    • 如果没有设置主机名（HOST），则使用 JID 的域名（domain）作为主机名，而端口号是可选的，默认是 5222，一般也没有必要改动它。

    2.4 XMPPStream 类

    • 我们要与服务器连接，就必须通过 XMPPStream 类了，它提供了很多的 API 和属性设置，通过 socket 来实现的。Verdor 目录包含了 CocoaAsyncSocket 这个非常有名的 socket 编程库。XMPPStream 类还遵守并实现了 GCDAsyncSocketDelegate 代理，用于客户端与服务器交互。

          @interface XMPPStream : NSObject <GCDAsyncSocketDelegate>

    • 当我们创建 XMPPStream 对象后，我们需要设置代理，才能回调我们的代理方法，这个是支持 multicast delegate，也就是说对于一个 XMPPStream 对象，可以设置多个代理对象，其中协议是XMPPStreamDelegate。

          - (void)addDelegate:(id)delegate delegateQueue:(dispatch_queue_t)delegateQueue;

    • 而当我们不希望某个 XMPPStream 对象继续接收到代理回调时，我们通过这样的方式来移除代理。

          - (void)removeDelegate:(id)delegate delegateQueue:(dispatch_queue_t)delegateQueue;
    - (void)removeDelegate:(id)delegate;

    • 接下来，我们要设置主机和端口，通过设置这两个属性。

          // 主机，可选设置，如果没有设置默认会使用 domain
    @property (readwrite, copy) NSString *hostName;

    // 端口号，默认为 5222
    @property (readwrite, assign) UInt16 hostPort;

    • XMPPStream 有 XMPPJID 类对象作为属性，标识用户，因为我们后续很多操作都需要到 myJID。

          @property (readwrite, copy) XMPPJID *myJID;

    • 而管理用户在线状态的就交由 XMPPPresence 类了，它同样被作为 XMPPStream 的属性，组合到 XMPPStream 中，后续很多关于用户的操作是需要到处理用户状态的。

          @property (strong, readonly) XMPPPresence *myPresence;

    2.5 XMPPStreamDelegate

    • 这个协议是非常关键的，我们的很多主要操作都集中在这个协议的代理回调上。它分为好几种类型的代理 API，比如授权的、注册的、安全的等。

          @protocol XMPPStreamDelegate
    @optional

    // 将要与服务器连接
    - (void)xmppStreamWillConnect:(XMPPStream *)sender;

    // 已经与服务器连接，
    // 当 TCP Socket 已经与远程主机连接上时会回调此方法
    // 若 App 要求在后台运行，需要设置 XMPPStream's enableBackgroundingOnSocket 属性
    - (void)xmppStream:(XMPPStream *)sender socketDidConnect:(GCDAsyncSocket *)socket;

    // 当 TCP 与服务器建立连接后会回调此方法
    - (void)xmppStreamDidStartNegotiation:(XMPPStream *)sender;

    // TLS 传输层协议在将要验证安全设置时会回调
    // 参数 settings 会被传到 startTLS，此方法可以不实现的
    // 若服务端使用自签名的证书，需要在 settings 中添加 GCDAsyncSocketManuallyEvaluateTrust = YES
    - (void)xmppStream:(XMPPStream *)sender willSecureWithSettings:(NSMutableDictionary *)settings;

    // 上面的方法执行后，下一步就会执行这个代理回调
    // 用于在 TCP 握手时手动验证是否受信任
    - (void)xmppStream:(XMPPStream *)sender didReceiveTrust:(SecTrustRef)trust
                                          completionHandler:(void (^)(BOOL shouldTrustPeer))completionHandler;

    // 当 stream 通过了 SSL/TLS 的安全验证时，会回调此代理方法
    - (void)xmppStreamDidSecure:(XMPPStream *)sender;

    // 当 XML 流已经完全打开时（也就是与服务器的连接完成时）会回调此代理方法。此时可以安全地与服务器通信了
    - (void)xmppStreamDidConnect:(XMPPStream *)sender;

    // 注册新用户成功时的回调
    - (void)xmppStreamDidRegister:(XMPPStream *)sender;

    // 注册新用户失败时的回调
    - (void)xmppStream:(XMPPStream *)sender didNotRegister:(NSXMLElement *)error;

    // 授权通过时的回调，也就是登录成功的回调
    - (void)xmppStreamDidAuthenticate:(XMPPStream *)sender;

    // 授权失败时的回调，也就是登录失败时的回调
    - (void)xmppStream:(XMPPStream *)sender didNotAuthenticate:(NSXMLElement *)error;

    // 将要绑定 JID resource 时的回调，这是授权程序的标准部分
    // 当验证 JID 用户名通过时，下一步就验证 resource。若使用标准绑定处理，return nil 或者不要实现此方法
    - (id <XMPPCustomBinding>)xmppStreamWillBind:(XMPPStream *)sender;

    // 如果服务器出现 resouce 冲突而导致不允许 resource 选择时，会回调此代理方法
    // 返回指定的 resource 或者返回 nil 让服务器自动帮助我们来选择。一般不用实现它
    - (NSString *)xmppStream:(XMPPStream *)sender alternativeResourceForConflictingResource:(NSString *)conflictingResource;

    // 将要接收 IQ（消息查询）时的回调
    - (XMPPIQ *)xmppStream:(XMPPStream *)sender willReceiveIQ:(XMPPIQ *)iq;

    // 将要接收到消息时的回调
    - (XMPPMessage *)xmppStream:(XMPPStream *)sender willReceiveMessage:(XMPPMessage *)message;

    // 将要接收到用户在线状态时的回调
    - (XMPPPresence *)xmppStream:(XMPPStream *)sender willReceivePresence:(XMPPPresence *)presence;

    // 通过实现此代理方法，可以知道被过滤的原因，有一定的帮助
    // 当 xmppStream:willReceiveX: (也就是前面这三个 API 回调后)，过滤了 stanza，会回调此代理方法
    - (void)xmppStreamDidFilterStanza:(XMPPStream *)sender;

    // 在接收了 IQ（消息查询后）会回调此代理方法
    - (BOOL)xmppStream:(XMPPStream *)sender didReceiveIQ:(XMPPIQ *)iq;

    // 在接收了消息后会回调此代理方法
    - (void)xmppStream:(XMPPStream *)sender didReceiveMessage:(XMPPMessage *)message;

    // 在接收了用户在线状态消息后会回调此代理方法
    - (void)xmppStream:(XMPPStream *)sender didReceivePresence:(XMPPPresence *)presence;

    // 在接收 IQ/messag、presence 出错时，会回调此代理方法
    - (void)xmppStream:(XMPPStream *)sender didReceiveError:(NSXMLElement *)error;

    // 将要发送 IQ（消息查询时）时会回调此代理方法
    - (XMPPIQ *)xmppStream:(XMPPStream *)sender willSendIQ:(XMPPIQ *)iq;

    // 在将要发送消息时，会回调此代理方法
    - (XMPPMessage *)xmppStream:(XMPPStream *)sender willSendMessage:(XMPPMessage *)message;

    // 在将要发送用户在线状态信息时，会回调此方法
    - (XMPPPresence *)xmppStream:(XMPPStream *)sender willSendPresence:(XMPPPresence *)presence;

    // 在发送 IQ（消息查询）成功后会回调此代理方法
    - (void)xmppStream:(XMPPStream *)sender didSendIQ:(XMPPIQ *)iq;

    // 在发送消息成功后，会回调此代理方法
    - (void)xmppStream:(XMPPStream *)sender didSendMessage:(XMPPMessage *)message;

    // 在发送用户在线状态信息成功后，会回调此方法
    - (void)xmppStream:(XMPPStream *)sender didSendPresence:(XMPPPresence *)presence;

    // 在发送 IQ（消息查询）失败后会回调此代理方法
    - (void)xmppStream:(XMPPStream *)sender didFailToSendIQ:(XMPPIQ *)iq error:(NSError *)error;

    // 在发送消息失败后，会回调此代理方法
    - (void)xmppStream:(XMPPStream *)sender didFailToSendMessage:(XMPPMessage *)message error:(NSError *)error;

    // 在发送用户在线状态失败信息后，会回调此方法
    - (void)xmppStream:(XMPPStream *)sender didFailToSendPresence:(XMPPPresence *)presence error:(NSError *)error;

    // 当修改了 JID 信息时，会回调此代理方法
    - (void)xmppStreamDidChangeMyJID:(XMPPStream *)xmppStream;

    // 当 Stream 被告知与服务器断开连接时会回调此代理方法
    - (void)xmppStreamWasToldToDisconnect:(XMPPStream *)sender;

    // 当发送了 </stream:stream> 节点时，会回调此代理方法
    - (void)xmppStreamDidSendClosingStreamStanza:(XMPPStream *)sender;

    // 连接超时时会回调此代理方法
    - (void)xmppStreamConnectDidTimeout:(XMPPStream *)sender;

    // 当与服务器断开连接后，会回调此代理方法
    - (void)xmppStreamDidDisconnect:(XMPPStream *)sender withError:(NSError *)error;

    // P2P 类型相关的
    - (void)xmppStream:(XMPPStream *)sender didReceiveP2PFeatures:(NSXMLElement *)streamFeatures;
    - (void)xmppStream:(XMPPStream *)sender willSendP2PFeatures:(NSXMLElement *)streamFeatures;

    - (void)xmppStream:(XMPPStream *)sender didRegisterModule:(id)module;
    - (void)xmppStream:(XMPPStream *)sender willUnregisterModule:(id)module;

    // 当发送非 XMPP 元素节点时，会回调此代理方法
    // 也就是说，如果发送的 element 不是 <iq>, <message> 或者 <presence>，那么就会回调此代理方法
    - (void)xmppStream:(XMPPStream *)sender didSendCustomElement:(NSXMLElement *)element;

    // 当接收到非 XMPP 元素节点时，会回调此代理方法
    // 也就是说，如果接收的element不是 <iq>, <message> 或者 <presence>，那么就会回调此代理方法
    - (void)xmppStream:(XMPPStream *)sender didReceiveCustomElement:(NSXMLElement *)element;

    2.6 XMPPIQ 类

    • 消息查询（IQ）就是通过此类来处理的了。XMPP 给我们提供了 IQ 方便创建的类，用于快速生成 XML 数据。

          @interface XMPPIQ : XMPPElement

    // 生成 IQ

    + (XMPPIQ *)iq;
    + (XMPPIQ *)iqWithType:(NSString *)type;
    + (XMPPIQ *)iqWithType:(NSString *)type to:(XMPPJID *)jid;
    + (XMPPIQ *)iqWithType:(NSString *)type to:(XMPPJID *)jid elementID:(NSString *)eid;
    + (XMPPIQ *)iqWithType:(NSString *)type to:(XMPPJID *)jid elementID:(NSString *)eid child:(NSXMLElement *)childElement;
    + (XMPPIQ *)iqWithType:(NSString *)type elementID:(NSString *)eid;
    + (XMPPIQ *)iqWithType:(NSString *)type elementID:(NSString *)eid child:(NSXMLElement *)childElement;
    + (XMPPIQ *)iqWithType:(NSString *)type child:(NSXMLElement *)childElement;

    - (id)init;
    - (id)initWithType:(NSString *)type;
    - (id)initWithType:(NSString *)type to:(XMPPJID *)jid;
    - (id)initWithType:(NSString *)type to:(XMPPJID *)jid elementID:(NSString *)eid;
    - (id)initWithType:(NSString *)type to:(XMPPJID *)jid elementID:(NSString *)eid child:(NSXMLElement *)childElement;
    - (id)initWithType:(NSString *)type elementID:(NSString *)eid;
    - (id)initWithType:(NSString *)type elementID:(NSString *)eid child:(NSXMLElement *)childElement;
    - (id)initWithType:(NSString *)type child:(NSXMLElement *)childElement;

    // IQ 类型
    - (NSString *)type;

    // 判断 type 类型

    - (BOOL)isGetIQ;
    - (BOOL)isSetIQ;
    - (BOOL)isResultIQ;
    - (BOOL)isErrorIQ;

    // 当 type 为 get 或者 set 时，这个 API 是很有用的，用于指定是否要求有响应
    - (BOOL)requiresResponse;

    - (NSXMLElement *)childElement;
    - (NSXMLElement *)childErrorElement;

    @end

    • IQ 是一种请求／响应机制，从一个实体发送请求，另外一个实体接受请求并进行响应。例如，Client 在 stream 的上下文中插入一个元素，向 Server 请求得到自己的好友列表，Server 返回一个，里面是请求的结果。

    • <type></type> 有以下类别（可选设置如：<type>get</type>）

      type 说明
      get 获取当前域值。类似于 http get 方法
      set 设置或替换 get 查询的值。类似于 http put 方法
      result 说明成功的响应了先前的查询。类似于 http 状态码 200
      error 查询和响应中出现的错误

    • 下面是一个 IQ 例子：

          <iqfrom="huangyibiao@welcome.com/ios"  
        id="xxxxxxx" 
        to="biaoge@welcome.com/ios"  
        type="get"> 
      <queryxmlns="jabber:iq:roster"/> 
    </iq>

    2.7 XMPPPresence 类

    • 这个类代表节点，我们通过此类提供的方法来生成 XML 数据。presence 它代表用户在线状态。

          @interface XMPPPresence : XMPPElement

    // Converts an NSXMLElement to an XMPPPresence element in place (no memory allocations or copying)
    + (XMPPPresence *)presenceFromElement:(NSXMLElement *)element;

    + (XMPPPresence *)presence;
    + (XMPPPresence *)presenceWithType:(NSString *)type;

    // type：用户在线状态，to：接收方的 JID
    + (XMPPPresence *)presenceWithType:(NSString *)type to:(XMPPJID *)to;

    - (id)init;
    - (id)initWithType:(NSString *)type;
    - (id)initWithType:(NSString *)type to:(XMPPJID *)to;

    - (NSString *)type;

    - (NSString *)show;
    - (NSString *)status;

    - (int)priority;

    - (int)intShow;

    - (BOOL)isErrorPresence;

    @end

    • presence 用来表明用户的状态，如：online、offline、away、dnd (请勿打扰) 等。当改变自己的状态时，就会在 stream 的上下文中插入一个 Presence 元素，来表明自身的状态。要想接受 presence 消息，必须经过一个叫做 presence subscription 的授权过程。

    • <type></type> 有以下类别（可选设置如：<type>subscribe</type>）：

      type 说明
      available 上线
      unavailable 下线
      away 离开
      do not disturb 忙碌
      subscribe 订阅其他用户的状态
      probe 请求获取其他用户的状态
      unavailable 不可用，离线（offline）状态

    • <show></show> 节点有以下类别，如 <show>dnd</show> ：

      show 说明
      chat 聊天中
      away 暂时离开
      xa eXtend Away，长时间离开
      dnd 勿打扰

    • <status></status> 节点

      • 这个节点表示状态信息，内容比较自由，几乎可以是所有类型的内容。常用来表示用户当前心情，活动，听的歌曲，看的视频，所在的聊天室，访问的网页，玩的游戏等等。

    • <priority></priority> 节点

      • 范围 -128~127。高优先级的 resource 能接受发送到 bare JID 的消息，低优先级的 resource 不能。优先级为负数的 resource 不能收到发送到 bare JID 的消息。

    • 发送一个用户在线状态的例子：

          <presencefrom="alice@wonderland.lit/pda"> 
      <show>dnd</show> 
      <status>浏览器搜索</status> 
    </presence>

    2.8 XMPPMessage 类

    • XMPPMessage 是 XMPP 框架给我们提供的，方便用于生成 XML 消息的数据。

          @interface XMPPMessage : XMPPElement

    // Converts an NSXMLElement to an XMPPMessage element in place (no memory allocations or copying)
    + (XMPPMessage *)messageFromElement:(NSXMLElement *)element;

    + (XMPPMessage *)message;
    + (XMPPMessage *)messageWithType:(NSString *)type;
    + (XMPPMessage *)messageWithType:(NSString *)type to:(XMPPJID *)to;
    + (XMPPMessage *)messageWithType:(NSString *)type to:(XMPPJID *)jid elementID:(NSString *)eid;
    + (XMPPMessage *)messageWithType:(NSString *)type to:(XMPPJID *)jid elementID:(NSString *)eid child:(NSXMLElement *)childElement;
    + (XMPPMessage *)messageWithType:(NSString *)type elementID:(NSString *)eid;
    + (XMPPMessage *)messageWithType:(NSString *)type elementID:(NSString *)eid child:(NSXMLElement *)childElement;
    + (XMPPMessage *)messageWithType:(NSString *)type child:(NSXMLElement *)childElement;

    - (id)init;
    - (id)initWithType:(NSString *)type;
    - (id)initWithType:(NSString *)type to:(XMPPJID *)to;
    - (id)initWithType:(NSString *)type to:(XMPPJID *)jid elementID:(NSString *)eid;
    - (id)initWithType:(NSString *)type to:(XMPPJID *)jid elementID:(NSString *)eid child:(NSXMLElement *)childElement;
    - (id)initWithType:(NSString *)type elementID:(NSString *)eid;
    - (id)initWithType:(NSString *)type elementID:(NSString *)eid child:(NSXMLElement *)childElement;
    - (id)initWithType:(NSString *)type child:(NSXMLElement *)childElement;

    - (NSString *)type;
    - (NSString *)subject;
    - (NSString *)body;
    - (NSString *)bodyForLanguage:(NSString *)language;
    - (NSString *)thread;

    - (void)addSubject:(NSString *)subject;
    - (void)addBody:(NSString *)body;
    - (void)addBody:(NSString *)body withLanguage:(NSString *)language;
    - (void)addThread:(NSString *)thread;

    - (BOOL)isChatMessage;
    - (BOOL)isChatMessageWithBody;
    - (BOOL)isErrorMessage;
    - (BOOL)isMessageWithBody;

    - (NSError *)errorMessage;

    @end

    • message 是一种基本 推送 消息方法，它不要求响应。主要用于 IM、groupChat、alert 和 notification 之类的应用中。

    • <type></type> 有以下类别（可选设置如：<type>chat</type>）：

      type 说明
      normal 类似于 email，主要特点是不要求响应
      chat 类似于 qq 里的好友即时聊天，主要特点是实时通讯
      groupchat 类似于聊天室里的群聊
      headline 用于发送 alert 和 notification
      error 如果发送 message 出错，发现错误的实体会用这个类别来通知发送者出错了

    • <body></body> 节点

      • 所要发送的内容就放在 body 节点下

    • 消息节点的例子：

          <messageto="lily@jabber.org/contact" type="chat"> 
        <body>您好？</body>
    </message>

    3、XMPPFramework 框架使用

    3.1 CocoaPods 导入框架

    • 1、通过 CocoaPods 导入第三方框架 XMPPFramework。

      • 在 Podfile 文件中加入如下代码，在终端中，使用命令 pod install 下载添加 XMPPFramework 框架。

            platform :ios, '8.0'

    target 'XMPPDemo' do

        use_frameworks!
        pod 'XMPPFramework', '~> 3.7.0'

    end

    • 2、在需要使用 XMPPFramework 的文件中导入以下头文件。

          #import <XMPPFramework/XMPPFramework.h>

    3.2 导入框架过程中问题解决

    • 1、用 Cocoapods 集成 XMPPFramework 遇 Module 'KissXML' not found 等问题解决方法。

      • 一般来说，通过 Coacopods 集成集成第三方框架，不会再有依赖库方面的问题，所以需要检查导入方式是否正确，最终找到原因，仔细看 githup 上导入说明

            Install

    The minimum deployment target is iOS 8.0 / macOS 10.8.

    The easiest way to install XMPPFramework is using CocoaPods. Remember to add to the top of your Podfile the 
    use_frameworks! line (even if you are not using swift):

      • 因此，Podfile 里必须写入这一句

            use_frameworks!

    • 2、Xcode8 之后 XMPP 重定义 Redefinition of module 'dnssd' 问题解决方法。

      • 在升级 Xcode 到 8 之后，原来的关于 XMPP 的项目运行报错，错误信息为： Redefinition of module 'dnssd'。系统和XMPP框架同时用到了 'dnssd'，大概就是错误的原因。

      • 解决方案：

            # The version pushed to CocoaPods is very out of date, use master branch for now 
    pod 'XMPPFramework', :git => "https://github.com/robbiehanson/XMPPFramework.git", :branch => 'master'

    大概意思是需要更新 XMPP 框架，需要把 Podfile 文件中的 
        pod 'XMPPFramework', '~> 3.6.6' 
    用 
        pod 'XMPPFramework', :git => "https://github.com/robbiehanson/XMPPFramework.git", :branch => 'master'
    来替换

    或者直接改成 
        pod 'XMPPFramework', '~> 3.7.0'

    • 3、在 pod update 的过程中有的童鞋会遇到下面这样的错误。

      IM6

      • 这个是因为更新的 XMPP 框架中支持的最低版本为 iOS 8.0 / macOS 10.8。The minimum deployment target is iOS 8.0 / macOS 10.8.

      • 把 Podfile 文件中

            platform：ios, '7.0'
        • 的 7.0 改为 8.0 或以上。

    • 4、pod 更新完成了，出现下面这样的错误。

      IM7

      • 到报错的工程里面搜一下

            Enable Strict Checking of objc_msgSend Calls
        • 改成相反的值就行了，别改没有报错的工程。

    4、XMPPFramework 实现简单聊天

    • 聊天实现的原理就是，一个客户端通过 XMPP 协议把信息传给服务器，服务器再发消息发给另一个客户端。

    4.1 用户注册

    • 初始化

          /// 包含头文件
    #import <XMPPFramework/XMPPFramework.h>

    /// 遵守协议
    <XMPPStreamDelegate>

    /// 定义 XMPP 服务器相关信息
    #define HOST_DOMAIN     @"jhq0228-macbookair.local"
    #define HOST_NAME       @"jhq0228-macbookair.local"
    #define HOST_PORT       5222

    /// 注册的账号
    @property (nonatomic, copy) NSString *registerUserName;

    /// 注册的密码
    @property (nonatomic, copy) NSString *registerPassWord;

    /// XMPP 流
    @property (nonatomic, strong) XMPPStream *stream;

    /// 初始化
    self.stream = [[XMPPStream alloc] init];
    self.stream.hostName = HOST_NAME;
    self.stream.hostPort = HOST_PORT;
    [self.stream addDelegate:self delegateQueue:dispatch_get_main_queue()];

    • 与服务器建立链接

          /// 与服务器建立链接
    [self connectToSercerWithUserName:self.registerUserName resource:nil];

    #pragma mark 与服务器连接通信

        /// 与服务器建立链接，自定义方法
        - (void)connectToSercerWithUserName:(NSString *)userName resource:(NSString *)resource {

            if ([self.stream isConnected]) {
                [self disconnectWithServer];
            }

            // jid
            self.stream.myJID = [XMPPJID jidWithUser:userName domain:HOST_DOMAIN resource:resource];

            NSError *error = nil;

            // 进行链接
            [self.stream connectWithTimeout:30.0 error:&error];

            if (error != nil) {
                NSLog(@"连接出现问题");
            }
        }

    • 进行注册

          #pragma mark XMPPStreamDelegate 协议方法

        /// 与服务器连接成功
        - (void)xmppStreamDidConnect:(XMPPStream *)sender {

            NSError *error1 = nil;

            // 进行注册
            [self.stream registerWithPassword:self.registerPassWord error:&error1];

            if (error1 != nil) {
                NSLog(@"注册出现问题");
            }
        }

        /// 与服务器连接超时
        - (void)xmppStreamConnectDidTimeout:(XMPPStream *)sender {

            NSLog(@"连接服务器超时，请检查网络链接后再试！");
        }

        /// 注册成功
        - (void)xmppStreamDidRegister:(XMPPStream *)sender {

            NSLog(@"注册成功");
        }

        /// 注册失败
        - (void)xmppStream:(XMPPStream *)sender didNotRegister:(DDXMLElement *)error {

            NSLog(@"注册失败");
        }

    4.2 用户登录、注销

    • 初始化

          /// 包含头文件
    #import <XMPPFramework/XMPPFramework.h>

    /// 遵守协议
    <XMPPStreamDelegate>

    /// 定义 XMPP 服务器相关信息
    #define HOST_DOMAIN     @"jhq0228-macbookair.local"
    #define HOST_NAME       @"jhq0228-macbookair.local"
    #define HOST_PORT       5222

    /// 登录的账号
    @property (nonatomic, copy) NSString *loginUserName;

    /// 登录的密码
    @property (nonatomic, copy) NSString *loginPassWord;

    /// XMPP 流
    @property (nonatomic, strong) XMPPStream *stream;

    /// 初始化
    self.stream = [[XMPPStream alloc] init];
    self.stream.hostName = HOST_NAME;
    self.stream.hostPort = HOST_PORT;
    [self.stream addDelegate:self delegateQueue:dispatch_get_main_queue()];

    • 与服务器建立链接

          /// 与服务器建立链接
    [self connectToSercerWithUserName:self.loginUserName resource:nil];

    #pragma mark 与服务器连接通信

        /// 与服务器建立链接，自定义方法
        - (void)connectToSercerWithUserName:(NSString *)userName resource:(NSString *)resource {

            if ([self.stream isConnected]) {
                [self disconnectWithServer];
            }

            // jid
            self.stream.myJID = [XMPPJID jidWithUser:userName domain:HOST_DOMAIN resource:resource];

            NSError *error = nil;

            // 进行连接
            [self.stream connectWithTimeout:30.0 error:&error];

            if (error != nil) {
                NSLog(@"连接出现问题");
            }
        }

    • 进行登录认证

          #pragma mark XMPPStreamDelegate 协议方法

        /// 与服务器连接成功
        - (void)xmppStreamDidConnect:(XMPPStream *)sender {

            NSError *error = nil;

            // 进行登录认证
            [self.stream authenticateWithPassword:self.loginPassWord error:&error];

            if (error != nil) {
                NSLog(@"登录认证出现问题");
            }
        }

        /// 与服务器连接超时
        - (void)xmppStreamConnectDidTimeout:(XMPPStream *)sender {

            NSLog(@"连接服务器超时，请检查网络链接后再试！");
        }

        /// 登录成功
        - (void)xmppStreamDidAuthenticate:(XMPPStream *)sender {

            NSLog(@"登录成功");

            // 设置用户在线状态，如果没有添加，别人给你发的消息服务器默认为离线状态，是不会给你发送的
            XMPPPresence *presence = [XMPPPresence presenceWithType:@"available"];
            [self.stream sendElement:presence];
        }

        /// 登录失败
        - (void)xmppStream:(XMPPStream *)sender didNotAuthenticate:(DDXMLElement *)error {

            NSLog(@"登录失败");
        }

    • 与服务器断开链接，用户注销

          #pragma mark 与服务器连接通信

        /// 与服务器断开链接，用户注销，自定义方法
        - (void)disconnectWithServer {

            // 断开链接
            [self.stream disconnect];
        }

    #pragma mark XMPPStreamDelegate 协议方法

        /// 注销成功
        - (void)xmppStreamDidDisconnect:(XMPPStream *)sender withError:(NSError *)error {

            NSLog(@"注销成功");

            // 设置用户下线状态
            XMPPPresence *presene = [XMPPPresence presenceWithType:@"unavailable"];
            [self.stream sendElement:presene];
        }

    • 用户登录信息本地化存储

          /// 包含头文件
    #import <SAMKeychain/SAMKeychain.h>

    /// 用户名和密码
    @property (nonatomic, copy) NSString *userName;
    @property (nonatomic, copy) NSString *userPasswd;

    /// 是否记住密码
    @property (nonatomic, assign, getter=isSavePasswd) BOOL savePasswd;

    /// 保存用户登录信息
    - (void)saveUserLoginInfo {

        NSUserDefaults *userDefaults = [NSUserDefaults standardUserDefaults];

        [userDefaults setObject:self.userName forKey:@"userNameKey"];
        [userDefaults setBool:self.isSavePasswd forKey:@"isSavePwdKey"];
        [userDefaults synchronize];

        if (self.isSavePasswd) {
            [SAMKeychain setPassword:self.userPasswd forService:[NSBundle mainBundle].bundleIdentifier account:self.userName];

            NSLog(@"保存用户登录信息");

        } else {
            self.userPasswd = nil;
            [SAMKeychain deletePasswordForService:[NSBundle mainBundle].bundleIdentifier account:self.userName];

            NSLog(@"不保存用户登录信息");
        }
    }

    /// 读取用户登录信息
    - (void)loadUserLoginInfo {

        NSUserDefaults *userDefaults = [NSUserDefaults standardUserDefaults];

        self.userName = [userDefaults objectForKey:@"userNameKey"];
        self.savePasswd = [userDefaults boolForKey:@"isSavePwdKey"];

        self.userPasswd = [SAMKeychain passwordForService:[NSBundle mainBundle].bundleIdentifier account:self.userName];
    }

    4.3 好友管理

    • 初始化

          /// 遵守协议
    <XMPPStreamDelegate, XMPPRosterDelegate, XMPPRosterMemoryStorageDelegate>

    /// 好友列表
    @property (nonatomic, strong) XMPPRoster *roster;

    /// 本地好友存储器
    @property (nonatomic, strong) XMPPRosterMemoryStorage *rosterMemoryStorage;

    // 添加好友模块
    self.rosterMemoryStorage = [[XMPPRosterMemoryStorage alloc] init];
    self.roster = [[XMPPRoster alloc] initWithRosterStorage:self.rosterMemoryStorage
                                              dispatchQueue:dispatch_get_global_queue(0, 0)];
    [self.roster activate:self.stream];                                       // 激活
    [self.roster addDelegate:self delegateQueue:dispatch_get_main_queue()];   // 设置代理
    [self.roster setAutoFetchRoster:YES];                                     // 设置好友同步策略，XMPP 一旦连接成功，自动同步好友到本地
    [self.roster setAutoAcceptKnownPresenceSubscriptionRequests:NO];          // 关掉自动接收好友请求，默认开启自动同意

    • 获取好友列表

          // 手动同步好友列表到本地好友存储器
    [self.roster fetchRoster];

    // 获取好友列表，从本地好友存储器中读取好友信息
    NSArray *users = self.rosterMemoryStorage.unsortedUsers;

    // 获取好友账号名称
    NSString *userName = [user[0] jid].user;

    // 获取好友昵称
    NSString *userName = [users[0] nickname];

    // 获取好友在线状态
    BOOL userStatus = [user[0] isOnline];

    #pragma mark XMPPRosterDelegate 协议方法

        /// 开始同步好友列表到本地
        - (void)xmppRosterDidBeginPopulating:(XMPPRoster *)sender withVersion:(NSString *)version {

        }

        /// 同步到一个好友节点到本地
        - (void)xmppRoster:(XMPPRoster *)sender didReceiveRosterItem:(NSXMLElement *)item {

        }

        /// 同步好友列表到本地完成
        - (void)xmppRosterDidEndPopulating:(XMPPRoster *)sender {

        }

    • 刷新好友列表

          #pragma mark - XMPPRosterMemoryStorageDelegate 协议方法

        /// 本地好友存储器发生改变
        - (void)xmppRosterDidChange:(XMPPRosterMemoryStorage *)sender {

            // 如果设置了自动同步，当服务器的好友列表发生改变时，会自动同步存入本地好友存储器 
        }

    • 刷新好友状态

          #pragma mark XMPPStreamDelegate 协议方法

        /// 好友状态改变
        - (void)xmppStream:(XMPPStream *)sender didReceivePresence:(XMPPPresence *)presence {

            // 收到对方取消定阅我的消息，对方删除我、对方状态改变

            if ([presence.type isEqualToString:@"unsubscribe"]) {

                // 从我的本地好友存储器中将对方移除
                [self.roster removeUser:presence.from];
            }
        }

    • 添加好友

          /// 添加好友，自定义方法
    - (void)addFriendWithUserName:(NSString *)userName remarkName:(NSString *)remarkName {

        NSString *jidString = userName;

        // 判断有没有域名，如果没有域名，自己添加形成完整的 jid
        NSString *domainString = [NSString stringWithFormat:@"@%@", HOST_DOMAIN];
        if (![jidString containsString:domainString]) {
            jidString = [jidString stringByAppendingString:domainString];
        }

        XMPPJID *friendJID = [XMPPJID jidWithString:jidString];

        // 添加好友，remarkName 为备注名称
        [self.roster addUser:friendJID withNickname:remarkName];

        // [self.roster subscribePresenceToUser:friendJID];
    }

    • 收到添加好友申请

          #pragma mark XMPPRosterDelegate 协议方法

        /// 收到添加好友请求
        - (void)xmppRoster:(XMPPRoster *)sender didReceivePresenceSubscriptionRequest:(XMPPPresence *)presence {

            NSString *name = [NSString stringWithFormat:@"添加 %@ 为好友？", presence.from.user];

            // 同意并添加对方为好友，YES 存入本地好友存储器
            [self.roster acceptPresenceSubscriptionRequestFrom:presence.from andAddToRoster:YES];

            // 拒绝添加对方为好友
            [self.roster rejectPresenceSubscriptionRequestFrom:presence.from];
        }

    • 删除好友

          /// 删除好友，自定义方法
    - (void)removeFriendWithUserName:(NSString *)userName {

        NSString *jidString = userName;

        // 判断有没有域名，如果没有域名，自己添加形成完整的 jid
        NSString *domainString = [NSString stringWithFormat:@"@%@", HOST_DOMAIN];
        if (![jidString containsString:domainString]) {
            jidString = [jidString stringByAppendingString:domainString];
        }

        XMPPJID *friendJID = [XMPPJID jidWithString:jidString];

        // 删除好友
        [self.roster removeUser:friendJID];
    }

    4.4 文本消息管理

    • 初始化

          /// 遵守协议
    <XMPPStreamDelegate>

    /// 定义 XMPP 服务器相关信息
    #define HOST_DOMAIN     @"jhq0228-macbookair.local"

    • 发送文本消息

          /// 发送文本消息，自定义方法
    - (void)sendMessage:(NSString *)message toUser:(NSString *)userName {

        // 消息结构
        /*
            <message type="chat" to="xiaoming@example.com">
                <body>Hello World</body>
            </message>
        */

        NSString *jidString = userName;                                             // 设置消息接收者
        NSString *domainString = [NSString stringWithFormat:@"@%@", HOST_DOMAIN];
        if (![jidString containsString:domainString]) {
            jidString = [jidString stringByAppendingString:domainString];
        }

        // 构建消息
        NSXMLElement *msg = [NSXMLElement elementWithName:@"message"];
        [msg addAttributeWithName:@"type" stringValue:@"chat"];
        [msg addAttributeWithName:@"to" stringValue:jidString];

        NSXMLElement *body = [NSXMLElement elementWithName:@"body"];
        [body setStringValue:message];                                              // 设置文本消息内容

        [msg addChild:body];

        // 发送
        [self.stream sendElement:msg];
    }

    • 接收文本消息

          #pragma mark XMPPStreamDelegate 协议方法

        /// 接收到消息
        - (void)xmppStream:(XMPPStream *)sender didReceiveMessage:(XMPPMessage *)message {

            NSString *msg = [[message elementForName:@"body"] stringValue];
        }

    • 消息回执

      • 这个是 XEP－0184 协议的内容。

      • 发送消息时附加回执请求

            // 消息结构
    /*
        <message
            from="northumberland@shakespeare.lit/westminster"
            id="richars2-4.1.247"
            to="kingrichard@royalty.england.lit/throne">
            <body>Hello World</body>
            <request xmlns="urn:xmpp:receipts"/>
        </message>
     */

    NSString *jidString = userName;                                             // 设置消息接收者
    NSString *domainString = [NSString stringWithFormat:@"@%@", HOST_DOMAIN];
    if (![jidString containsString:domainString]) {
        jidString = [jidString stringByAppendingString:domainString];
    }

    // 构建消息
    NSString *siID = [XMPPStream generateUUID];
    XMPPJID *jid = [XMPPJID jidWithString:jidString];

    XMPPMessage *msg = [XMPPMessage messageWithType:@"chat" to:jid elementID:siID];

    NSXMLElement *receipt = [NSXMLElement elementWithName:@"request" xmlns:@"urn:xmpp:receipts"];
    [msg addChild:receipt];                                                     // 设置消息回执

    [msg addBody:message];                                                      // 设置消息内容

    // 发送
    [self.stream sendElement:msg];

      • 收到回执请求的消息，发送回执

            /// 接收到消息，XMPPStreamDelegate 协议方法
    - (void)xmppStream:(XMPPStream *)sender didReceiveMessage:(XMPPMessage *)message {

        // 消息结构
        /*
            <message
                from="kingrichard@royalty.england.lit/throne"
                id="bi29sg183b4v"
                to="northumberland@shakespeare.lit/westminster">
                <received xmlns="urn:xmpp:receipts" id="richars2-4.1.247">
            </message>
         */

        // 回执判断
        NSXMLElement *request = [message elementForName:@"request"];

        if (request) {

            // 消息回执
            if ([request.xmlns isEqualToString:@"urn:xmpp:receipts"]) {

                // 组装消息回执
                XMPPMessage *msg = [XMPPMessage messageWithType:[message attributeStringValueForName:@"type"]
                                                             to:message.from
                                                      elementID:[message attributeStringValueForName:@"id"]];

                NSXMLElement *recieved = [NSXMLElement elementWithName:@"received" xmlns:@"urn:xmpp:receipts"];
                [msg addChild:recieved];

                // 发送回执
                [self.stream sendElement:msg];
            }

        } else {

            NSXMLElement *received = [message elementForName:@"received"];

            if (received) {

                // 消息回执
                if ([received.xmlns isEqualToString:@"urn:xmpp:receipts"]) {

                    // 发送成功
                    NSLog(@"message send success!");
                }
            }
        }

        // 消息处理
        // ...
    }

    4.5 图片消息管理

    • 图片和语音文件发送的基本思路：

      • 先将图片/语音转化成二进制文件，然后将二进制文件进行 base64 编码，编码成字符串。在即将发送的 message 内添加一个子节点，节点的 stringValue（节点的值）设置这个编码后的字符串。
      • 然后消息发出后取出消息文件的时候，通过 messageType 先判断是不是图片/语音信息，如果是图片/语音信息先通过自己之前设置的节点名称，把这个子节点的 stringValue 取出来，应该是一个 base64 之后的字符串。

    • 选择图片

          /// 遵守协议
    <UIImagePickerControllerDelegate, UINavigationControllerDelegate>

    UIImagePickerController *picker = [[UIImagePickerController alloc]init];
    picker.delegate = self;
    [self presentViewController:picker animated:YES completion:nil];

    #pragma mark - UIImagePickerControllerDelegate 代理方法

        - (void)imagePickerController:(UIImagePickerController *)picker didFinishPickingMediaWithInfo:(NSDictionary *)info {

            UIImage *image = info[UIImagePickerControllerOriginalImage];
            NSData *imageData = UIImagePNGRepresentation(image);

            // 发送图片消息，自定义方法
            [[XMPPManager defaultManager] sendMessage:imageData msgType:@"image" toUser:self.userName];

            [self dismissViewControllerAnimated:YES completion:nil];
        }

    • 发送图片消息

      • msgType 自定义消息类型，image：图片消息，audio：音频消息
          // 发送图片消息
    [[XMPPManager defaultManager] sendMessage:imageData msgType:@"image" toUser:self.userName];

    /// 发送图片/音频消息，自定义方法
    - (void)sendMessage:(NSData *)msgData msgType:(NSString *)type toUser:(NSString *)userName {

        NSString *jidString = userName;                                             // 设置消息接收者
        NSString *domainString = [NSString stringWithFormat:@"@%@", HOST_DOMAIN];
        if (![jidString containsString:domainString]) {
            jidString = [jidString stringByAppendingString:domainString];
        }

        XMPPJID *jid = [XMPPJID jidWithString:jidString];
        XMPPMessage *msg = [XMPPMessage messageWithType:@"chat" to:jid];

        [msg addBody:type];

        // 转换成 base64 的编码
        NSString *base64str = [msgData base64EncodedStringWithOptions:0];

        // 设置节点内容
        XMPPElement *attachment = [XMPPElement elementWithName:@"attachment" stringValue:base64str];

        // 包含子节点
        [msg addChild:attachment];

        // 发送消息
        [self.stream sendElement:msg];
    }

    • 接收图片消息

          #pragma mark XMPPStreamDelegate 协议方法

        /// 接收到消息
        - (void)xmppStream:(XMPPStream *)sender didReceiveMessage:(XMPPMessage *)message {

            if ([message.body isEqualToString:@"image"]) {

                for (XMPPElement *node in message.children) {

                    // 取出消息的解码
                    NSString *base64str = node.stringValue;
                    NSData *data = [[NSData alloc] initWithBase64EncodedString:base64str options:0];

                    UIImage *image = [[UIImage alloc] initWithData:data];
                }
            }
        }

    4.6 语音消息管理

    • 图片和语音文件发送的基本思路：

      • 先将图片/语音转化成二进制文件，然后将二进制文件进行 base64 编码，编码成字符串。在即将发送的 message 内添加一个子节点，节点的 stringValue（节点的值）设置这个编码后的字符串。
      • 然后消息发出后取出消息文件的时候，通过 messageType 先判断是不是图片/语音信息，如果是图片/语音信息先通过自己之前设置的节点名称，把这个子节点的 stringValue 取出来，应该是一个 base64 之后的字符串。

    • 录制／播放语音

          /// 包含头文件
    #import <AVFoundation/AVFoundation.h>

    /// 录音器
    @property(nonatomic, strong) AVAudioRecorder *recorder;

    /// 录音时长
    @property(nonatomic, assign) NSTimeInterval recordTime;

    /// 录音地址
    @property(nonatomic, strong) NSURL *recordURL;

    /// 播放器
    @property(nonatomic, strong) AVAudioPlayer *player;

    /// 开始录音

        // 自定义方法
        - (IBAction)startRecord:(UIButton *)sender {

            // 创建录音文件保存路径
            NSString *urlStr = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject];
            self.recordURL = [NSURL URLWithString:[urlStr stringByAppendingPathComponent:@"myRecord.caf"]];

            // 创建录音格式设置
            NSMutableDictionary *dicM = [NSMutableDictionary dictionary];
            [dicM setObject:@(kAudioFormatLinearPCM) forKey:AVFormatIDKey];     // 设置录音格式
            [dicM setObject:@(8000) forKey:AVSampleRateKey];                    // 设置录音采样率，8000 是电话采样率，对于一般录音已经够了
            [dicM setObject:@(1) forKey:AVNumberOfChannelsKey];                 // 设置通道，这里采用单声道
            [dicM setObject:@(8) forKey:AVLinearPCMBitDepthKey];                // 每个采样点位数，分为 8、16、24、32
            [dicM setObject:@(YES) forKey:AVLinearPCMIsFloatKey];               // 是否使用浮点数采样
            NSDictionary *setting = [dicM copy];

            // 创建录音机
            self.recorder = [[AVAudioRecorder alloc] initWithURL:self.recordURL settings:setting error:NULL];

            // 开始录音
            [self.recorder record];
        }

    /// 停止录音

        // 自定义方法
        - (IBAction)stopRecord:(UIButton *)sender {

            NSTimeInterval time = self.recorder.currentTime;
            [self.recorder stop];

            if (time < 1.5) {
                NSLog(@"时间太短");
            } else {
                NSLog(@"录音完成");
            }
        }

    /// 播放录音

        // 自定义方法
        - (void)playAudioData:(NSData *)data {

            self.player = [[AVAudioPlayer alloc] initWithData:data error:NULL];
            self.player.numberOfLoops = 0;
            [self.player prepareToPlay];
            [self.player play];
        }

    • 发送语音消息

      • msgType 自定义消息类型，image：图片消息，audio：音频消息
          // 发送语音消息
    NSData *audioData = [NSData dataWithContentsOfURL:self.recordURL];
    NSString *type = [NSString stringWithFormat:@"audio:%.1f秒", self.recordTime];
    [[XMPPManager defaultManager] sendMessage:audioData msgType:type toUser:self.userName];

    /// 发送图片/音频消息，自定义方法
    - (void)sendMessage:(NSData *)msgData msgType:(NSString *)type toUser:(NSString *)userName {

        NSString *jidString = userName;                                             // 设置消息接收者
        NSString *domainString = [NSString stringWithFormat:@"@%@", HOST_DOMAIN];
        if (![jidString containsString:domainString]) {
            jidString = [jidString stringByAppendingString:domainString];
        }

        XMPPJID *jid = [XMPPJID jidWithString:jidString];
        XMPPMessage *msg = [XMPPMessage messageWithType:@"chat" to:jid];

        [msg addBody:type];

        // 转换成 base64 的编码
        NSString *base64str = [msgData base64EncodedStringWithOptions:0];

        // 设置节点内容
        XMPPElement *attachment = [XMPPElement elementWithName:@"attachment" stringValue:base64str];

        // 包含子节点
        [msg addChild:attachment];

        // 发送消息
        [self.stream sendElement:msg];
    }

    • 接收语音消息

          #pragma mark XMPPStreamDelegate 协议方法

        /// 接收到消息
        - (void)xmppStream:(XMPPStream *)sender didReceiveMessage:(XMPPMessage *)message {

            if ([message.body hasPrefix:@"audio"]) {

                for (XMPPElement *node in message.children) {

                    // 取出消息的解码
                    NSString *base64str = node.stringValue;
                    NSData *data = [[NSData alloc] initWithBase64EncodedString:base64str options:0];
                }
            }
        }

    4.7 心跳检测

    • 为了监听服务器是否有效，增加心跳监听，用 XEP-0199 协议。

    • 在 XMPPFrameWork 框架下，封装了 XMPPAutoPing 和 XMPPPing 两个类都可以使用，因为 XMPPAutoPing 已经组合进了 XMPPPing 类，所以 XMPPAutoPing 使用起来更方便。

    • 初始化并启动 ping

          /// 包含头文件
    #import <XMPPFramework/XMPPFramework.h>

    /// 遵守协议
    <XMPPAutoPingDelegate>>

    /// 心跳检测
    @property (nonatomic, strong) XMPPAutoPing *autoPing;

    // 添加心跳检测模块
    self.autoPing = [[XMPPAutoPing alloc] init];    // 发送的是一个 stream:ping，对方如果想表示自己是活跃的，应该返回一个 pong
    [self.autoPing activate:self.stream];           // 激活
    [self.autoPing addDelegate:self delegateQueue:dispatch_get_main_queue()];
    self.autoPing.pingInterval = 1000;              // 定时发送 ping 时间
    self.autoPing.respondsToQueries = YES;          // 不仅仅是服务器来得响应，如果是普通的用户，一样会响应
    self.autoPing.targetJID = [XMPPJID jidWithString:HOST_DOMAIN];      // 设置 ping 目标服务器
                                                                       // 如果为 nil，则监听 stream 当前连接上的那个服务器

    #pragma mark - XMPPAutoPingDelegate 协议方法

        /// 已经发送 ping
        - (void)xmppAutoPingDidSendPing:(XMPPAutoPing *)sender {

            NSLog(@"xmppAutoPingDidSendPing");
        }

        /// 接收到 pong
        - (void)xmppAutoPingDidReceivePong:(XMPPAutoPing *)sender {

            NSLog(@"xmppAutoPingDidReceivePong");
        }

        /// ping 超时
        - (void)xmppAutoPingDidTimeout:(XMPPAutoPing *)sender {

            NSLog(@"xmppAutoPingDidTimeout");
        }

    • 停止 ping

          // 停止 ping
    [self.autoPing deactivate];
    [self.autoPing removeDelegate:self];
    self.autoPing = nil;

    4.8 自动重连

    • 当意外与服务器断开连接，自动重新连接上去，并且将上一次的信息自动加上去。

    • 初始化

          /// 包含头文件
    #import <XMPPFramework/XMPPFramework.h>

    /// 遵守协议
    <XMPPReconnectDelegate>>

    /// 自动重连
    @property (nonatomic, strong) XMPPReconnect *reconnect;

    // 添加自动重连模块
    self.reconnect = [[XMPPReconnect alloc] init];
    [self.reconnect activate:self.stream];          // 激活
    [self.reconnect addDelegate:self delegateQueue:dispatch_get_main_queue()];
    self.reconnect.autoReconnect = YES;             // 设置是否自动重新连接

    #pragma mark - XMPPReconnectDelegate 协议方法

        /// 设置是否自动重新连接
        - (BOOL)xmppReconnect:(XMPPReconnect *)sender shouldAttemptAutoReconnect:(SCNetworkConnectionFlags)connectionFlags {

            return YES;
        }

        /// 意外断开连接
        - (void)xmppReconnect:(XMPPReconnect *)sender didDetectAccidentalDisconnect:(SCNetworkConnectionFlags)connectionFlags {

            NSLog(@"didDetectAccidentalDisconnect");
        }

    5、XMPPFramework 快速登录

    6、XMPPFramework 重连以及其他问题


    如果您觉得阅读本文对您有帮助，请点一下“推荐”按钮，您的“推荐”将是我最大的写作动力！欢迎各位转载，但是未经作者本人同意，转载文章之后必须在文章页面明显位置给出作者和原文连接，否则保留追究法律责任的权利。
wiseuc_jianghai
关注
专栏目录
ios-xmpp聊天界面.zip
07-11
在iOS开发中，XMPP（Extensible Messaging and Presence Protocol）是一种常见的实时通信协议，常用于...通过这个项目，开发者可以学习到如何在iOS应用中使用XMPP实现即时通讯功能，为构建类似QQ的聊天应用打下基础。
ios-XMPP Pod OpenFire.zip
07-11
第三方 OpenFire 的使用 即时通讯
XMPP获取用户信息及修改用户信息
itiapp的博客
11-04 3047
XMPP默认没有导入电子名片模块，所以得自己手动在XMPPFramework.h里导入 #import "XMPPvCardTempModule.h" //电子名片模块 #import "XMPPvCardCoreDataStorage.h" //电子名片存储模块 #import "XMPPvCardAvatarModule.h" //电子名片头像模块 电子名片的获取过程是发起请求给服务器
KissXML解析问题解决
niejinhao052011的专栏
11-23 965
xmpp客户端集合
linyu19872008的专栏
02-13 200
1  web im  http://www.claros.org/web/home.do
初识xmpp笔记
ClayGuitar的专栏
11-17 613
原文地址：初识xmpp笔记作者：iCocoder #import "AppDelegate.h" //#import "DBAreaItem.h" #pragma mark - #pragma mark Private Interface @interface AppDelegate () typedef enum {     AlertViewStyleConfli
iOS-xmpp资源
06-16
总之，`XMPPFramework-master`为iOS开发者提供了完整的XMPP解决方案，通过合理使用和定制，可以快速构建功能丰富的即时通讯应用。在实际开发过程中，结合Apple的文档和社区资源，可以更好地理解和运用这一框架。
IOS-XMPP框架
05-27
本文将详细介绍iOS下的XMPP框架及其使用方法。 1. **XMPP框架简介** iOS上的XMPP框架是专门为Apple的移动操作系统设计的，它实现了XMPP协议，允许开发者快速构建具备即时通讯功能的应用。这个框架包含了服务器连接...
ios-XMPP即时通讯 好友列表 添加好友.zip
07-11
基于ejabberd服务器的即时通讯客户端，实现了用户登陆、注册、添加好友、显示好友列表，并且能实时更新好友状态：离线、在线。可以成功运行，没有错误。内含XMPP通信框架。
用Cocoapods集成XMPPFramework 遇 Module 'KissXML' not found 问题
weixin_30745553的博客
11-02 363
用Coacopods集成XMPPFramework完成后Command + B,报Module 'KissXML' not found 一般来说，通过Coacopods集成集成第三方框架，不会再有依赖库方面的问题，所以需要检查导入方式是否正确，最终找到原因，仔细看githup上导入说明 因此，Podfile里你需要这要写 bingo,问题解决 一般来说导入swift框架时需...
基于即时通信和LBS技术的位置感知服务（二）：XMPP协议总结以及开源解决方案
xiaoliang_xie的专栏
10-09 1269
在《基于即时通信和LBS技术的位置感知服务（一）：提出问题及解决方案》一文中，提到尝试使用XMPP协议来实现即时通信。本文将对XMPP协议框架以及相关的C/S架构进行介绍，协议的底层实现不再本文的讨论范围。 一、什么是XMPP？ 介绍XMPP之前，我们先来聊聊GTalk。GT
xmpp ios 问题篇
HHuiHao
08-19 1758
libidn.a(stringprep.o), in section __TEXT,__text reloc 8: indirect symbol index out of range for architecture i386 clang: error: linker command failed with exit code 1 (use -v to see invocation) libidn.a
对xep-0030 服务发现的一点理解,属性查询
weixin_30875157的博客
11-19 112
xep 0030对服务发现的理解，可以理解为文件系统查找过程，上篇讲目录 式查询，怎么区分查询结果是目录，还是文件呢，我们希望的是查询到文件，才是我们需要的“服务实体” 于是，我们希望得到上篇文章中查询结果的属性，在xmpp中，叫'http://jabber.org/protocol/disco#info' 要查询"某文件"的属性 我们发送如下:(注意，文件夹也是文件，所以，都可以被查询“属...
JWT全面解读、使用步骤
热门推荐
陈袁的博客
06-27 8万+
JWT全面解读 JWT全面解读 前言 JWT基本使用 在pom.xml引入java-jwt 示例如下 概念介绍 JWT消息构成 头部 playload 标准中注册的声明 (建议但不强制使用) 自定义数据 签名signature JJWT 引入 使用方法 生成token 解析token 前言 JWT是json web token缩写。它将用户信息加密到toke...
XMPP实现动态刷新好友列表
rv0p111
03-21 292
一、简单介绍最近学习了下ios端的XMPP的框架，发现了其有一个很好的机制，我可以在一个客户端如果去删除用户指定好友，然后发送消息到另外一个客户端，然后另外一个客户端由于它是把好友列表缓存到sqlite数据库中的，所以我们再用一个NSFetchedResultsController类去请求获取数据，这个类的话其实是每当有数据插入，删除，更新或者是移动了，NSFetchedResultsContro...
iOS开发笔记（IOS7回归）
dawuafang
10-17 212
&lt;---点击左上角目录，可以快速查找这里是否有你遇到的问题条目&lt;--- 1，iOS中如何设置项目/文件是否支持ARC 旧工程配置arc方案： 1,直接在targets-&gt;build phases中修改compiler Flags,是否支持arc。添加：-fobjc-arc，就可以让旧项目支持arc。如果想让原来支持arc的不使用arc则添加-fno-...
使用XMPP响应服务器ping包
willn_1987的专栏
05-11 1681
IOS使用XMPP做即时聊天，服务器会在yi
数据挖掘（三）相关数据集资源
最新发布
10-27
数据挖掘（三）相关数据集资源
Openfire-xmpp服务器搭建指南
在iOS开发中，如果需要集成XMPP协议，可以使用如XMPPFramework等第三方库来实现与Openfire服务器的交互。这些库封装了XML解析和网络通信等复杂逻辑，使得在iOS应用中实现即时通讯变得更加简单。 Openfire是一个强大...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值