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 等进行相应的操作。

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

注册及登录

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

注册的示例:

easemob::EMErrorPtr result = chatClient->createAccount("zhangsan", "passw0rd");
if(result->mErrorCode == EMError::NO_ERROR) { 
    cout << "Sing up successfully." << endl; 
} else { 
    cout << result->mDescription << endl; 
}

登录的示例 :

easemob::EMErrorPtr result = chatClient->login("zhangsan", "passw0rd");
if(result->mErrorCode == EMError::NO_ERROR) { 
    cout << "Login successfully" << endl; 
} else { 
    cout << result->mDescription << endl; 
}

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

添加好友

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

chatClient->getContactManager().inviteContact("contact01", "hi, contact01");

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

与好友聊天

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

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

chatClient->getChatManager().addListener(this);

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

    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);

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

easemob::EMCallbackObserverHandle mHandle;

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


上一章节:Windows客户端集成

下一页:技术参数