目录

安卓应用配置修改

包名”com.xiaomi.mimcdemo”必须替换成APP自己的包名

  1. <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
  2. <uses-permission android:name="android.permission.INTERNET" />
  3. <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
  4. <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
  5. <uses-permission android:name="com.xiaomi.xmsf.permission.LOG_PROVIDER" />
  7. <!-- 这里的包名"com.xiaomi.mimcdemo"必须替换成App自己的包名 -->
  8. <permission
  9.     android:name="com.xiaomi.mimcdemo.permission.MIMC_RECEIVE"
  10.     android:protectionLevel="signature" />
  11. <uses-permission android:name="com.xiaomi.mimcdemo.permission.MIMC_RECEIVE" />
  13. <service
  14.     android:name="com.xiaomi.mimc.MIMCService"
  15.     android:enabled="true"
  16.     android:exported="false" />
  18. <service
  19.     android:name="com.xiaomi.mimc.MIMCCoreService"
  20.     android:enabled="true"
  21.     android:exported="false"
  22.     android:process=":mimc"/>
  24. <service
  25.     android:name="com.xiaomi.mimc.MIMCJobService"
  26.     android:enabled="true"
  27.     android:exported="false"
  28.     android:permission="android.permission.BIND_JOB_SERVICE"
  29.     android:process=":mimc" />
  31. <receiver
  32.     android:name="com.xiaomi.mimc.receivers.MIMCReceiver"
  33.     android:exported="true">
  34.     <intent-filter>
  35.     <action android:name="com.xiaomi.channel.PUSH_STARTED" />
  36.     <action android:name="com.xiaomi.push.service_started" />
  37.     <action android:name="com.xiaomi.push.channel_opened" />
  38.     <action android:name="com.xiaomi.push.channel_closed" />
  39.     <action android:name="com.xiaomi.push.new_msg" />
  40.     <action android:name="com.xiaomi.push.kicked" />
  41.     </intent-filter>
  42. </receiver>
  44. <receiver android:name="com.xiaomi.mimc.receivers.MIMCPingReceiver">
  45.     <intent-filter>
  46.     <action android:name="com.xiaomi.push.PING_TIMER" />
  47.     </intent-filter>
  48. </receiver>

备注：

  1. 我们将MIMCCoreService / MIMCJobService定义在了mimc进程中。
  2. 开发者也可以配置其运行在任意进程，如果没有配置android:process这个属性，那么它们将运行在应用的主进程中。

用户初始化

  1. MIMCClient.initialize(this);
  3. /**
  4.  * @param[appAccount]: 用户在APP帐号系统内的唯一帐号ID
  5.  */
  6. MIMCUser user = new MIMCUser(appAccount);

安全认证

参考 安全认证

  1. user.registerTokenFetcher(MIMCTokenFetcher fetcher);
  2. interface MIMCTokenFetcher {
  3.     /**
  4.      * @note: fetchToken()访问APP应用方自行实现的AppProxyService服务，该服务实现以下功能：
  5.             1. 存储appId/appKey/appSecret(appKey/appSecret不可存储在APP客户端，以防泄漏)
  6.             2. 用户在APP系统内的合法鉴权
  7.             3. 调用小米TokenService服务，并将小米TokenService服务返回结果通过fetchToken()原样返回
  8.     * @return: 小米TokenService服务下发的原始数据
  9.     */
  10.     public String fetchToken();
  11. }

登录

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

在线状态变化回调

  1. user.registerOnlineStatusListener(MIMCOnlineStatusListener listener);
  2. interface MIMCOnlineStatusListener {
  3.     /**
  4. 　　　* @param[status]: 登录状态，MIMCConstant.STATUS_LOGIN_SUCCESS 在线，MIMCConstant.STATUS_LOGOUT 离线。
  5. 　　　* @param[code]: 状态码
  6. 　　　* @param[msg]: 状态描述
  7.      */
  8.     public void onStatusChanged(int status, int code, String msg);
  9. }

发送单聊消息

  1. /**
  2.  * @param[toAppAccount]: 消息接收者在APP帐号系统内的唯一帐号ID
  3.  * @param[payload]: 开发者自定义消息体
  4.  * @param[isStore]: 消息是否存储在mimc服务端，true存储，false不存储，默认存储
  5.  * @return: 客户端生成的消息ID
  6.  */
  7. String packetId = user.sendMessage(String toAppAccount, byte[] payload, boolean isStore);

发送群聊消息

  1. /**
  2.  * @param[groupId]: 群ID，也称为topicId
  3.  * @param[payload]: 开发者自定义消息体
  4.  * @param[isStore]: 消息是否存储在mimc服务端，true存储，false不存储，默认存储
  5.  * @return: 客户端生成的消息ID
  6.  */
  7. String packetId = user.sendGroupMessage(long groupID, byte[] payload, boolean isStore);

接收消息回调

  1. user.registerMessageHandler(MIMCMessageHandler handler);
  2. interface MIMCMessageHandler {
  3.     /**
  4.      * @param[packets]: 单聊消息集
  5.      * @note: MIMCMessage 单聊消息
  6.      *        MIMCMessage.packetId: 消息ID
  7.      *        MIMCMessage.sequence: 序列号
  8.      *        MIMCMessage.fromAccount: 发送方帐号
  9.      *        MIMCMessage.toAccount: 接收方帐号
  10.      *        MIMCMessage.payload: 消息体
  11.      *        MIMCMessage.timestamp: 时间戳
  12.      */
  13.     public void handleMessage(List<MIMCMessage> packets);
  15.     /**
  16.      * @param[packets]: 群聊消息集
  17.      * @note: MIMCGroupMessage 群聊消息
  18.      *        MIMCGroupMessage.packetId: 消息ID
  19.      *        MIMCGroupMessage.groupId: 群ID
  20.      *        MIMCGroupMessage.sequence: 序列号
  21.      *        MIMCGroupMessage.fromAccount: 发送方帐号
  22.      *        MIMCGroupMessage.payload: 消息体
  23.      *        MIMCGroupMessage.timestamp: 时间戳
  24.      */
  25.     public void handleGroupMessage(List<MIMCGroupMessage> packets);
  27.     /**
  28.      * @param[serverAck]: 服务器返回的serverAck对象
  29.      *       serverAck.packetId: 客户端生成的消息ID
  30.      *       serverAck.timestamp: 消息发送到服务器的时间(单位:ms)
  31.      *       serverAck.sequence: 服务器为消息分配的递增ID，单用户空间内递增唯一，可用于去重/排序
  32.     */
  33.     public void handleServerAck(MIMCServerAck serverAck);
  35.     /**
  36.      * @param[message]: 发送超时的单聊消息
  37.      */
  38.     public void handleSendMessageTimeout(MIMCMessage message);
  40.     /**
  41.      * @param[groupMessage]: 发送超时的群聊消息
  42.      */
  43.     public void handleSendGroupMessageTimeout(MIMCGroupMessage groupMessage);
  44. }

注销

  1. user.logout();

回到顶部