即时通信（IM-instant messager）

即时通信又叫实时通信，简单来讲就是两个及以上的人使用网络进行文字、文件、语音和视频的交流。

首先，进行网络进行通讯，确定须要网络协议，即时通信专用的协议就是xmpp。xmpp协议要传递的消息类型是xml格式的。 
http协议的实现类是socket，xmpp协议的实现类叫smack。

其次，即时通信确定须要服务器端（Openfire）和客户端（Spark）。 
Openfire,spark和smack三者的关系以下： 

即时通信发送消息的方式有四种： 
- 即时在线通信：两我的都在线 
- 即时代理通信：两我的都在线，但因为网络或其余问题消息发送不到，先将消息发送到服务器，再又服务器转发给对方 
- 离线通信：对方不在线，由服务器暂存，对方在线时再发给对方 
- 其余方式：对方不在线，经过短信或邮件等方式告知对方

---

下面基于环信的三方SDK，进行一个简要的开发。

1. 在官网中获取appkey

填入应用名、描述、包名等信息获取appkey

2. 服务器端

这里对服务器端不作介绍。。。

3. 客户端：

1. 下载并导入SDK 
   SDK中会有一个Demo，直接运行就能达到即时通信的功能了，可是要将代码融入
2. 配置信息 
   在清单文件AndroidManifest.xml里加入如下权限，以及写上你注册的appkey

权限配置(实际开发中可能须要更多的权限，可参考demo)：

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="Your Package"
android:versionCode="100"
android:versionName="1.0.0">

    <!-- Required -->
    <uses-permission android:name="android.permission.VIBRATE" />
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.RECORD_AUDIO" />
    <uses-permission android:name="android.permission.CAMERA" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.ACCESS_MOCK_LOCATION" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"/>  
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    <uses-permission android:name="android.permission.GET_TASKS" />
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
    <uses-permission android:name="android.permission.WAKE_LOCK" />
    <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
    <uses-permission android:name="android.permission.READ_PHONE_STATE" />
    <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />

    <application
        android:icon="@drawable/ic_launcher"
        android:label="@string/app_name"
        android:name="Your Application">

        <!-- 设置环信应用的appkey -->
        <meta-data android:name="EASEMOB_APPKEY"  android:value="Your AppKey" />
        <!-- 声明sdk所需的service SDK核心功能-->
        <service android:name="com.hyphenate.chat.EMChatService" android:exported="true"/>
        <!-- 声明sdk所需的receiver -->
        <receiver android:name="com.hyphenate.chat.EMMonitorReceiver">
            <intent-filter>
                <action android:name="android.intent.action.PACKAGE_REMOVED"/>
                <data android:scheme="package"/>
            </intent-filter>
            <!-- 可选filter -->
            <intent-filter>
                <action android:name="android.intent.action.BOOT_COMPLETED"/>
                <action android:name="android.intent.action.USER_PRESENT" />
            </intent-filter>
        </receiver>
    </application>
</manifest>

1. app打包混淆

在proguard文件中加入如下keep

-keep class com.hyphenate.** {*;}
-dontwarn  com.hyphenate.**

---

发送消息

配置完成就能够发送消息了

1. 发送文本消息

//建立一条文本消息,content为消息文字内容，toChatUsername为对方用户或者群聊的id，后文皆是如此
EMMessage message = EMMessage.createTxtSendMessage(content, toChatUsername);
//若是是群聊，设置chattype,默认是单聊
message.setChatType(ChatType.GroupChat);
//发送消息
EMClient.getInstance().chatManager().sendMessage(message);

2. 发送语音消息

//filePath为语音文件路径，length为录音时间(秒)
EMMessage message = EMMessage.createVoiceSendMessage(filePath, length, toChatUsername);
//若是是群聊，设置chattype,默认是单聊
message.setChatType(ChatType.GroupChat);
EMClient.getInstance().chatManager().sendMessage(message);

3. 发送视频消息

//videoPath为视频本地路径，thumbPath为视频预览图路径，videoLength为视频时间长度
EMMessage message = EMMessage.createVideoSendMessage(videoPath, thumbPath, videoLength, toChatUsername);
//若是是群聊，设置chattype,默认是单聊
message.setChatType(ChatType.GroupChat);
EMClient.getInstance().chatManager().sendMessage(message);

4. 发送图片消息

//imagePath为图片本地路径，false为不发送原图(默认超过100k的图片会压缩后发给对方),须要发送原图传false
EMMessage.createImageSendMessage(imagePath, false, toChatUsername);
//若是是群聊，设置chattype,默认是单聊
message.setChatType(ChatType.GroupChat);
EMClient.getInstance().chatManager().sendMessage(message);

接收消息

经过注册消息监听来接收消息

EMClient.getInstance().chatManager().addMessageListener(msgListener);
EMMessageListener msgListener = new EMMessageListener() {

    @Override
    public void onMessageReceived(List<EMMessage> messages) {
        //收到消息
    }

    @Override
    public void onCmdMessageReceived(List<EMMessage> messages) {
        //收到透传消息
    }

    @Override
    public void onMessageReadAckReceived(List<EMMessage> messages) {
        //收到已读回执
    }

    @Override
    public void onMessageDeliveryAckReceived(List<EMMessage> message) {
        //收到已送达回执
    }

    @Override
    public void onMessageChanged(EMMessage message, Object change) {
        //消息状态变更
    }
};

记得在不须要的时候移除listener，如在activity的onDestroy()时 
EMClient.getInstance().chatManager().removeMessageListener(msgListener);