android平台下移动DM接入流程?

       中国移动拟建设终端管理与服务系统,通过对终端产品的激活、配置使用等信息的收集,结合终端公司对产品的供应链管理,实现产品全生命周期的掌控。 要求2017年3月起,所有入中国移动产品库的定制、非定制Android终端均要支持终端管理功能。(必选要求)

终端自注册

        第一次开机时,必须将终端的IMEI及其他系统需要的基础信息以数据的方式发送到系统服务器。服务器负责解析此HTTP消息,并在服务器端建立终端IMEI和ICCID的对应关系列表。终端侧机卡对应关系发生变化,终端必须再度进行自注册操作。

▪ 终端心跳采集

     客户端定期采集终端业务配置信息上报到服务器,业务配置信息包括但不限于APN配置、VoLTE开关状态采集业务配置能力可后续扩展。

▪ 终端业务配置
       管理平台服务器通过终端上传的心跳信息判断是否需要对终端进行配置更改, 服务器下发配置指令到对应终端终端业务配置处理流程中,终端用户操作流程应遵循服务器发出的命令现在只有支持Volte的配置

▪应用软件管理

       终端管理及服务系统客户端每7天读取终端应用软件数据并上报到服务器。应用数据内容:终端IMEI,终端第三方APP列表,app打开时长,app打开次数,app消耗流量。

接入流程

    

A、填写邮件

填写《多形态终端appkey申请模板》表格，填写方式请见表格中提示内容

注：

1、因申请邮件数量较多，可能出现遗漏情况，如2个工作日内未收到回复邮件，请将原申请邮件再次发送

2、有新产品接入时请重新发送邮件，如有多个账户，均可登录使用，对入库无影响

3、如产品在《中国移动智能硬件产品及质量白皮书》中找不到合适的分类，可列入各大类中的“XX新型”，NB-IoT产品（模组和整机终端），一级分类填写NB-IoT产品，二级分类按照实际产品填写模组或者终端。

B、登录适配管理平台

1、适配平台地址：https://shipei.fxltsbl.com

2、账户密码为申请邮件中提供账户密码（密码DM平台提供）

3、登录适配平台后，可在平台下载相关文档及代码文件

C、集成适配

集成分为调试版和商用版，在集成测试阶段，请使用调试版（上报地址为适配平台coap://shipei.fxltsbl.com:5683），调试版上报可在适配平台凭账户密码查询上报情况。在集成完成后请按《测试用例_多形态终端测试用例(厂商用)》

测试用例进行测试。

注：优先级为“可选”用例可根据产品实际情况进行选测，不满足测试条件或无法测试项请直接标注“N/A”，在备注进行解释即可。

Android平台：

请将文件直接提供给研发人员，由研发根据自己产品实际情况选择JDK版本对应SDK进行集成，添加android终端技术支持QQ号：2430416846 进行技术咨询

Linux平台：

请将文件直接提供给研发人员，研发人员根据《readme》中内容进行集成相关工作，添加linux终端技术支持QQ号：2361994271进行技术咨询

其他平台：

根据《多形态终端上报接口规范》自行开发，满足相关上报即可，同时添加平台技术支持QQ号：2427714190进行技术咨询

D、送测及发布

完成厂商自测用例全部测试后，需更换商用版（上报地址为商用平台coap://m.fxltsbl.com:5683）送测，在品质部反馈测试通过后，以商用版本发布产品。

 

接入DM的基本流程是什么FAQ？

1）填写《多形态终端appkey申请模板》发送到指定邮箱，获取①适配平台账户密码②每个厂商唯一的APPKEY（也写作APPID）

2）登录适配平台，在文档管理下载所有集成DM相关资料

3）根据材料集成“调试版”DM，登录适配平台根据测试用例验证数据上报

4）测试通过后更换“商用版”并送测

设备没有IMEI如何处理？

 答：没有IMEI的设备需要在终端公司申请CMEI。该CMEI只有在入库时才会分配，所以在调试阶段可以根据IMEI规则自行生成假CMEI用于测试。

 

CMEI如何申请？

提交商用平台测试的CMEI必须用真实的。CMEI前8位tui的申请在营销系统，产品报备时候会自动生成这个字段

SDK是否有日志？

答：Android平台的SDK，在debug版本，会在根目录生成日志文件，文件路径是MTLog

集成成功如何判定？

答：Android平台SDK会打印上报成功相关日志，自注册功能打印“onRegistrationSuccess”，心跳打印“onUpdateSuccess”，看到这些字样后，可以去适配平台验证上报结果。确认成功后，请按《测试用例》进行自测，用例中“必选”为必须测试项，标记“可选”的用例，请跟具设备实际功能进行合理选择测试，能力上不支持的功能可以N/A

 

心跳的间隔时间是多长？

答：适配平台版本是3分钟，正式商用版本是24小时.

没插sim或者无法插sim卡的设备imsi如何传参数？

答：传null就可以。

为什么只有自注册成功，没有心跳成功？

答：心跳功能需要在自注册上报成功后才会启动，在心跳周期时间到达时触发上报。如果中

途出现重启、进程被杀死等情况，则心跳计时器也会被终止，需要重新注册。

送测未通过该怎么处理？

首先自行确认失败原因，是否是上报地址不正确等原因导致测试失败。确认无误后可与调试阶段沟通的技术支持QQ（或QQ群）联系，尝试解决问题，同时与平台“服务窗口”联系，协调下一轮测试的相关事宜。

申请APPKEY邮件未得到相应如何处理？

由于申请厂商数量较多，可能个别邮件被遗漏，1个工作日内未得到回复，请直接在原邮件基础上，再次发送，相关负责人看到邮件后会优先处理。

 

Demo 和文档下载链接 :

            https://download.csdn.net/my

 

在代码中的调用:

 MTSdk.init(ContextUtil.getInstance(), MobileUtil.getDeviceID(mContext), null, MobileUtil.getIMSI(mContext), "Key");

mainfest中添加如下的注册信息:

 <service
            android:name="cn.richinfo.mt.service.MTService"
            android:exported="false" >
        </service>
        
        <receiver android:name="cn.richinfo.mt.receiver.MTBroadCastReceiver" >
            <intent-filter>
                <action android:name="cn.richinfo.mutm.action.HEARTBEAT" />
                <action android:name="android.richinfo.net.conn.CONNECTIVITY_CHANGE" />
            </intent-filter>
        </receiver>

 

如下图,加入SDK和so库到项目中

 

 

当做好这些准备后,再监听网络的状态,连接上网络后开始调用即可.最终的效果如图: