即时通信软件

任务介绍

使用极光IMSDK实现登录注册，加好友和互发消息功能

解决思路

前端采用ListView+LinearLayout布局得到基础的界面，后端调用极光SDK的API接口实现相应的功能

具体实现

1. 导入极光IMSDK：

   在2.0.0之后增加了自动集成功能，所以不用再繁琐的添加配置文件只需要确认android studio的 Project 根目录的主 gradle 中配置了jcenter支持，在 module 的 gradle 中添加依赖和AndroidManifest的替换变量就可以使用极光IMSDK了。

---

2. 登陆注册功能

   ——登陆：JMessageClient.login(String username, String password, BasicCallback callback);

   参数说明：
   String username 用户名
   String password 用户密码
   BasicCallback callback 结果回调

   ---

   ——注册：JMessageClient.register(String username, String password, BasicCallback callback);

   参数说明
   String username 用户名
   String password 用户密码
   RegisterOptionalUserInfo optionalUserInfo 注册时的用户其他信息
   BasicCallback callback 结果回调

---

3. 加好友：

   ——发送好友添加请求
   public static void sendInvitationRequest(final String targetUsername,String appKey, final String reason, final BasicCallback callback)

   参数定义
   String targetUsername 被邀请方用户名
   String appKey 被邀请方用户的appKey,如果为空则默认从本应用appKey下查找用户。
   String reason 申请理由
   BasicCallback callback 结果回调

   ---

   ——接受好友请求

   ContactManager.acceptInvitation(final String targetUsername, String appKey, final BasicCallback callback)

   参数定义

   String targetUsername 邀请方的用户名
   String appKey 邀请方用户的appKey,如果为空则默认从本应用appKey下查找用户。
   BasicCallback callback 结果回调

   ---

   ——拒绝好友请求

   ContactManager.declineInvitation(final String targetUsername, String appKey, String reason, final BasicCallback callback)

   参数定义
   String targetUsername 邀请方用户名
   String appKey 邀请方用户的appKey,如果为空则默认从本应用appKey下查找用户。
   String reason 拒绝理由
   BasicCallback callback 结果回调

   ---

   ——获取好友列表

   ContactManager.getFriendList(final GetUserInfoListCallback callback)

   参数定义

   GetUserInfoListCallback callback 结果回调。

---

4. 在线通话
   ——创建单聊会话

   Conversation.createSingleConversation(String username, String appkey)

   参数说明
   String username 会话对象的username.
   String appkey 用户所属应用的appkey,如果填空则默认为本应用的appkey

   ---

   ——获取会话列表

   MessageClient.getConversationList();

   参数说明
   无

   返回
   List 会话列表。

   ---

   ——获取单个单聊会话

   JMessageClient.getSingleConversation(String username, String appkey);

   参数说明
   String username 目标的用户用户名。
   String appkey 用户所属应用的appkey

   返回
   Conversation 根据参数匹配得到的单聊会话对象。

   ---

   —— 消息发送结果监听

   message.setOnSendCompleteCallback(BasicCallback sendCompleteCallback)

   参数说明

   BasicCallback sendCompleteCallback 回调接口

   ---

   ——发送消息

   JMessageClient.sendMessage(Message message);

   参数说明
   Message message 消息对象

   ---

   ——创建文字消息

   JMessageClient.createSingleTextMessage(String username, String appKey, String text)

主要工作

自己先做了一个丑的内面，目的是能够实现相应的功能，截图如下所示。功能实现之后再转交给前端工作人员去优化界面。

老版本截图

新版本截图

总结

Android开发经久不衰的原因就是手机是人们必不可少的工具。通过两周多的实践，从0基础发展到现在的小试牛刀，Android开发不仅给了我很多的挑战，同时也带给了我很多的快乐，看着自己一步一步实现了相应的功能，界面一天一天完善，感到很有成就感，这次的生产实习仿佛让我看到了未来工作的生活，让我明白：生活永远是向前的~Keep Moving!!

参考文献

极光IMSDK：
https://docs.jiguang.cn/jmessage/client/jmessage_android_guide/
博客：
https://blog.youkuaiyun.com/BUCTOJ/article/details/94402698
https://blog.youkuaiyun.com/BUCTOJ/article/details/95445980
https://blog.youkuaiyun.com/BUCTOJ/article/details/95681426
https://blog.youkuaiyun.com/BUCTOJ/article/details/95591789
https://blog.youkuaiyun.com/BUCTOJ/article/details/95109877

源码

Github地址
Old分支下为旧版本，New分支下为新版本