====== Linux SDK 集成说明 ======

----

Linux SDK 是为在 Linux 及其他嵌入式设备中集成 IM 功能提供的 SDK。用户可以用 SDK 实现 IM 功能。目前支持文本消息、图片、语音、位置等消息以及透传消息，还可以实现好友管理、群组管理等功能。

目前已经支持 ARM 平台及 MIPS 平台。

===== 集成准备 =====

获取环信 IM Linux SDK，SDK中包含如下文件：

  * release
  * doc
  * demo

release 目录中包含SDK的库文件和头文件，libeasemob.a 是 SDK 静态库文件，include 目录包含 sdk 的头文件，doc 目录包含对 sdk 的详细说明，demo 包含使用 SDK 的 demo 程序。

===== 集成示例 =====

==== 获取 EMClient ====

EMClient 是 IM 服务的入口，可以直接调用 EMClient 的接口，也可以通过 EMClient 获得相应 EMContactManager、EMChatManager 等进行相应的操作。

<code cpp>
    #include "emclient.h"
    ...
    using namespace easemob;
    
    easemob::EMChatConfigsPtr configPtr = easemob::EMChatConfigsPtr(new easemob::EMChatConfigs(resourcePath, workPath, "easemob-demo#chatdemoui"));
    chatClient = easemob::EMClient::create(configPtr);
</code>

==== 注册及登录 ====

调用 chatclient 的 createAccount(), login() 接口可以实现注册、登录功能。

注册的示例：
<code cpp>
easemob::EMErrorPtr result = chatClient->createAccount("zhangsan", "passw0rd");
if(result->mErrorCode == EMError::NO_ERROR) { 
    cout << "Sing up successfully." << endl; 
} else { 
    cout << result->mDescription << endl; 
}
</code>

登录的示例 ：
<code cpp>
easemob::EMErrorPtr result = chatClient->login("zhangsan", "passw0rd");
if(result->mErrorCode == EMError::NO_ERROR) { 
    cout << "Login successfully" << endl; 
} else { 
    cout << result->mDescription << endl; 
}
</code>

**注意：**createAccount(), login() 是需要与后台服务器通讯的操作，可能需要一定时间，如果程序想同时显示 UI 的话，需要放在单独线程中处理。

==== 添加好友 ====

管理好友的操作需要通过 EMChatManager 进行。

<code cpp>
chatClient->getContactManager().inviteContact("contact01", "hi, contact01");
</code>

添加好友需要等待对方的确认，也可以由程序设置成自动接受好友邀请。

==== 与好友聊天 ====

接收消息需要实现 EMChatManagerListener 的 onReceiveMessage() 方法并且注册该listener。

<code cpp>
class Chat : public easemob::EMChatManagerListener { 
    void onReceiveMessage(const easemob::EMMessageList &messages); 
} 

chatClient->getChatManager().addListener(this);
</code>

发送消息需要创建 EMMessage 实例，目前支持文本、图片、音频文件等消息类型。

<code cpp>
    EMTextMessageBody* body = new EMTextMessageBody("How are you, du");
    easemob::EMMessagePtr msg = EMMessage::createSendMessage(loginUser, to, body);

    easemob::EMCallbackPtr callback(new easemob::EMCallback(mHandle,
				[=]()->bool{
                    window_->AddOutput("Msg send success");
                    return true;
                }, 
				[=](const easemob::EMErrorPtr error)->bool{
                    window_->AddOutput( "Send message failed: " + error->mDescription);
                    return true;
                }));

    msg->setCallback(callback);
    chatClient->getChatManager().sendMessage(msg);
</code>

请注意 callback 的定义，为了能够获知 callback 的拥有者是否仍然存在，需要在您的类中定义''EMCallbackObserverHandle''。

<code cpp>
easemob::EMCallbackObserverHandle mHandle;
</code>

具体接口说明及使用可以参考 SDK 中的文档和 demo 程序。

----
<WRAP group>
<WRAP half column>
上一章节：[[im:windowssdk:sdkintegration|Windows客户端集成]]
</WRAP>

<WRAP half column>
下一页：[[im:350linuxsdkintegration:50techspec|技术参数]]
</WRAP>
</WRAP>