目录

引入头文件

  1.     <script type="text/javascript" src="mimc-min_1_0_0.js"></script>

用户初始化

  1. user = new MIMCUser(appAccount);
  2. user.registerFetchToken(fetchMIMCToken);         //获取token回调
  3. user.registerStatusChange(statusChange);         //登录结果回调
  4. user.registerServerAckHandler(serverAck);        //发送消息后，服务器接收到消息ack的回调
  5. user.registerP2PMsgHandler(receiveP2PMsg);       //接收单聊消息回调
  6. user.registerGroupMsgHandler(receiveP2TMsg);     //接收群聊消息回调
  7. user.registerDisconnHandler(disconnect);         //连接断开回调

安全认证

参考 安全认证 ，实现以下API：

  1.     function fetchMIMCToken() {
  2.         // 访问AppProxyService，从返回数据中获取[小米TokenService返回的原始数据]并直接返回
  3.     }

登录

  1.     user.login();

在线状态变化回调

  1.     /**
  2.      * @param[bindResult] bool: true/false 表示登录成功/失败
  3.      * @param[errType] string: 登录失败类型
  4.      * @param[errReason] string: 登录失败原因
  5.      * @param[errDesc] string: 登录失败描述
  6.      **/
  7.     function statusChange(bindResult, errType, errReason, errDesc) {
  8.     }

发送单聊消息

  1.     /**
  2.      * @param[appAccount] string: 消息接收者在App帐号系统的帐号ID
  3.      * @param[message] string utf8: 用户自定义消息体
  4.      * @param[isStore] bool: 消息是否存储在mimc服务端，true 存储, false 不存储, 默认存储
  5.      # @return string: 由客户端生成的消息ID
  6.      **/
  7.     var packetId = user.sendMessage(appAccount, message, isStore);

发送群聊消息

  1.     /**
  2.      * @param[groupId] string: 群ID，也成为topicId
  3.      * @param[message] string utf8: 用户自定义消息体
  4.      * @param[isStore] bool: 消息是否存储在mimc服务端，true 存储, false 不存储, 默认存储
  5.      # @return string: 由客户端生成的消息ID
  6.      **/
  7.     var packetId = user.sendMessage(groupId, message, isStore);

服务器响应回调

  1.     /**
  2.      * @param[packetId] string: 成功发送到服务器消息的packetId，即sendMessage(,)的返回值
  3.      * @param[sequence] string: 服务器生成，单用户空间内递增唯一，可用于排序（升序）/去重
  4.      * @param[timeStamp] string: 消息到达服务器时间（ms）
  5.      * @param[errMsg] string: 服务器返回的错误信息
  6.      **/
  7.     function serverAck(packetId, sequence, timeStamp, errMsg) {
  8.     }

接收消息回调

  1.     /**
  2.      * @param[P2PMsg] object: 接收到的P2P消息体
  3.      **/
  4.     function receiveP2PMsg(P2PMsg) {
  5.         P2PMsg.getPacketId(); // 客户端生成的消息ID
  6.         P2PMsg.getSequence(); // 由服务器生成，用于去重排序(升序)
  7.         P2PMsg.getFromAccount(); // 消息发送者在APP帐号系统的帐号ID
  8.         P2PMsg.getTimeStamp(); // 消息发送时间戳
  9.         P2PMsg.getPayload(); // payload为用户自定义消息，utf-8 string类型
  10.     }

接收群聊消息回调

  1.     /**
  2.      * @param[P2TMsg] object: 接收到的P2T消息体
  3.      **/
  5.     function receiveP2TMsg(P2TMsg) {
  6.         P2TMsg.getPacketId(); // 客户端生成的消息ID
  7.         P2TMsg.getSequence(); // 由服务器生成，用于去重排序(升序)
  8.         P2TMsg.getFromAccount(); // 消息发送者在APP帐号系统的帐号ID
  9.         P2TMsg.getTopicId(); // 群ID
  10.         P2TMsg.getTimeStamp(); // 消息发送时间戳
  11.         P2TMsg.getPayload(); // payload为用户自定义消息，utf-8 string类型
  12.     }

连接断开回调

  1.     function disconnect() {
  2.     }

注销

  1.     user.logout();

回到顶部