目录

C#应用配置修改

  1. 1、可先下载demo，并更新demo项目依赖路径到 sdk/0.0.X，建议采用最新版本，然后运行demo；
  2. 2、在项目中添加sdk目录中最新的dll包：
  3.    |-- mimc-csharp-sdk.dll
  4.       |--Newtonsoft.Json.dll
  5.       |--protobuf-net.dll
  6.       |--StreamJsonRpc.dll
  7.       |--log4net.dll
  8. 3、项目采用Visual Studio 2017开发；
  9. 4、日志采用log4net组件，项目中已经做了简单配置，可以按照需要自行修改；

用户初始化

  1. /**
  2.  * @param[appId]: 开发者在小米开放平台申请的appId
  3.  * @param[appAccount]: 用户在APP帐号系统内的唯一帐号ID
  4.  **/
  5. User user = new User(appId, appAccount);

安全认证

参考 详细文档安全认证

  1. user.RegisterTokenFetcher(IMIMCTokenFetcher fetcher);

实现接口：

  1. interface IMIMCTokenFetcher {
  2.     /// <summary>
  3.     /// MIMCUser如果采用Login()方式登录 则必须实现该接口
  4.     ///  FetchToken()访问APP应用方自行实现的AppProxyService服务，
  5.     ///  该服务实现以下功能：
  6.     ///1. 存储appId/appKey/appSecret(appKey/appSecret不可存储在APP客户端，以防泄漏)
  7.     ///2. 用户在APP系统内的合法鉴权
  8.     ///3. 调用小米TokenService服务，并将小米TokenService服务返回结果通过fetchToken()原样返回
  9.     /// </summary>
  10.     /// <returns>小米TokenService服务下发的原始数据</returns>
  11.     string FetchToken();
  13.     /// <summary>
  14.     ///  MIMCUser如果采用LoginAsync()方式登录 则必须实现该接口
  15.     /// </summary>
  16.     /// <returns>小米TokenService服务下发的原始数据</returns>
  17.     Task<string> FetchTokenAsync();
  18. }

登录

  1. /**
  2.  * @note: 用户登录接口，除在APP初始化时调用，APP从后台切换到前台时也建议调用一次
  3.  */
  4. user.Login();
  5. user.LoginAsync();

在线状态变化回调

  1.   ///添加事件
  2.   user.StateChangeEvent += HandleStatusChange;
  3.   public void HandleStatusChange(object source, StateChangeEventArgs e)
  4.   {
  5.        logger.InfoFormat("{0} OnlineStatusHandler status:{1},errType:{2},errReason:{3},errDescription:{4}!",e.User.AppAccount(), e.IsOnline, e.ErrType, e.ErrReason, e.ErrDescription);
  6.   }

发送单聊消息

  1.   /**<summary>
  2.   * 发送单聊消息
  3.   * </summary>
  4.   *  <param name="toAppAccount">消息接收者在APP帐号系统内的唯一帐号ID</param>
  5.   *  <param name="msg">开发者自定义消息体，二级制数组格式</param>
  6.   * <returns>packetId客户端生成的消息ID</returns>
  7.   **/
  8. String packetId = user.SendMessage(string toAppAccount, byte[] msg)
  9. String packetId = user.SendMessageAsync(string toAppAccount, byte[] msg)
  11.   /**    <summary>
  12.   * 发送单聊消息
  13.   * </summary>
  14.   *  <param name="toAppAccount">消息接收者在APP帐号系统内的唯一帐号ID</param>
  15.   *  <param name="msg">开发者自定义消息体，二级制数组格式</param>
  16.   *  <param name="isStore">是否保存历史记录，true：保存，false：不存</param>
  17.   * <returns>packetId客户端生成的消息ID</returns>
  18.   **/
  19. String packetId = user.SendMessage(string toAppAccount, byte[] msg, bool isStore)
  20. String packetId = user.SendMessageAsync(string toAppAccount, byte[] msg, bool isStore)

发送群聊消息

  1.    /// <summary>
  2.    /// 发送群聊消息
  3.    /// </summary>
  4.    /// <param name="topicId">群ID</param>
  5.    /// <param name="msg">开发者自定义消息体，二级制数组格式</param>
  6.    /// <returns>packetId客户端生成的消息ID</returns>
  7. String packetId = user.SendGroupMessage(long topicId, byte[] msg)
  8. String packetId = user.SendGroupMessageAsync(long topicId, byte[] msg)
  11.    /// <summary>
  12.    /// 发送群聊消息
  13.    /// </summary>
  14.    /// <param name="topicId">群ID</param>
  15.    /// <param name="msg">开发者自定义消息体，二级制数组格式</param>
  16.    /// <param name="isStore">是否保存历史记录，true：保存，false：不存</param>
  17.    /// <returns>packetId客户端生成的消息ID</returns>
  18. String packetId = user.SendGroupMessage(long topicId, byte[] msg, bool isStore)
  19. String packetId = user.SendGroupMessageAsync(long topicId, byte[] msg, bool isStore)

接收消息回调

  1. ///添加事件
  2. user.MessageEvent += HandleMessage;
  3. user.MessageTimeOutEvent += HandleMessageTimeout;
  4. user.GroupMessageEvent += HandleGroupMessage;
  5. user.GroupMessageTimeoutEvent += HandleGroupMessageTimeout;
  6. user.ServerACKEvent += HandleServerACK;
  7. public void HandleMessageTimeout(object source, SendMessageTimeoutEventArgs e)
  8. {
  9.     P2PMessage msg = e.P2PMessage;
  10.     logger.InfoFormat("MIMCMessageHandler HandleSendMessageTimeout, to:{0}, packetId:{1}, sequence:{2}, ts:{3}, payload:{4}",
  11.     e.User.AppAccount(), msg.PacketId, msg.Sequence, msg.Timestamp,
  12.     Encoding.UTF8.GetString(msg.Payload));
  13. }
  15. public void HandleGroupMessage(object source, GroupMessageEventArgs e)
  16. {
  17.      List<P2TMessage> packets = e.Packets;
  18.      logger.InfoFormat("MIMCMessageHandler HandleGroupdMessage, to:{0}, packetCount:{1}", e.User.AppAccount(), packets.Count);
  19.      if (packets.Count == 0)
  20.      {
  21.          logger.WarnFormat("HandleGroupdMessage packets.Count==0");
  22.          return;
  23.      }
  24.      foreach (P2TMessage msg in packets)
  25.      {
  26.          logger.InfoFormat("MIMCMessageHandler HandleGroupdMessage, to:{0}, packetId:{1}, sequence:{2}, ts:{3}, payload:{4}",
  27.          e.User.AppAccount(), msg.PacketId, msg.Sequence, msg.Timestamp,
  28.          Encoding.UTF8.GetString(msg.Payload));
  29.      }
  30. }
  32. public void HandleGroupMessageTimeout(object source, SendGroupMessageTimeoutEventArgs e)
  33. {
  34.     P2TMessage msg = e.P2tMessage;
  35.     logger.InfoFormat("MIMCMessageHandler HandleSendGroupdMessageTimeout, to:{0}, packetId:{1}, sequence:{2}, ts:{3}, payload:{4}",
  36.     e.User.AppAccount(), msg.PacketId, msg.Sequence, msg.Timestamp,
  37.     Encoding.UTF8.GetString(msg.Payload));
  38. }
  40. public void HandleServerACK(object source, ServerACKEventArgs e)
  41. {
  42.     ServerAck serverAck = e.ServerAck;
  43.     logger.InfoFormat("{0} MIMCMessageHandler HandleServerACK, appAccount:{0}, packetId:{1}, sequence:{2}, ts:{3}",
  44.     e.User.AppAccount(), serverAck.PacketId, serverAck.Sequence, serverAck.Timestamp);
  45. }

注销

  1. user.Logout();

回到顶部