MAM

调用MAM功能接口梳理

1、设置MAM服务的配置信息

 emm.writeConfig({
     "host" : "",
     "port" : ""
 })

参数说明：

• host: MAM的IP地址;
• port:MAM的端口号；

2、在EMM上注册设备

     emm.registerDevice({
            "username": "",
            "password": "",
            "companyId": "",
            "istenantid":"false",
        }, "registerS()", "registerE()")

参数说明

• username:用户名，用户登录app的账号;
• password:用户密码，用户登录app的密码;
• companyId:用户的租户id值，登录app成功返回后的租户id值;
• istenantid:字符串格式，判断传入的是否是租户id值，是租户id值为‘true’，是租户code值为‘false’；
• registerS():注册成功的回调，
• registerE():注册失败的回调

3、获取应用列表

根据业务需求，获取应用列表分为四类:

3.1 获取系统app列表

emm.getSystemApps({
     "userid": ""，
     "companyId":""
     },
     "success()","error()"
   })

传递参数说明：

• userid：用户id,登录app成功后返回的userid值,
• companyId:用户的租户id值

返回参数说明

  "{
      "tp": "none",
      "data": {
          "appdata": [
              {
                  "appgroupid": "35011ba5-d0ee-44de-be62-6c9dda6ddfa2",
                    "appgroupname": "员工生活"
                  "apps": [
                      {
                          "downloadURL": "",
                          "appname": "HR日历",
                          "appid": "office-guide1",
                          "iconURL": "https://172.20.7.98:8080/mobem/img/icon/web2017042701324360.png",
                          "version": "1.0"，
                           installed: true,
                           isupdate: "true",
                           homepage:''
                          
                      }
                  ],
              }
          ],
          "code": "1",
          "msg": "数据查询成功"
      }
  }"

• tp：是否加密，
• data：接口返回的数据，
• appdata:app信息列表信息，数组格式包含不同的系统应用的分类，
• appgroupid：应用分类id值，
• appgroupname：应用分类名称，
• apps：数组，对用分类下app应用的具体信息，
• appname:app名称，
• appid：app的id值，
• downloadURL：应用下载地址，
• iconURL: 应用图标地址,
• installed：应用是否已安装，true表示已经安装，false表示未安装，
• isupdate：应用是否需要更新，'true'表示需要更新，'false'表示不需要更新,
• homepage: 应用的启动页面路径，
• version：当前应用版本信息，

3.2 获取用户常用app列表

 emm.getUserCommonApps({
              "userid": "",
              "companyId":"",
              "categoryname":''
              },
              "success()","error()")

传递参数说明补充：

• categoryname:应用分类名称，例如："我的应用";
• userid:用户的id值;
• companyId：用户的租户id值

返回的参数与3.1相同，部分参数补充说明：

• appdata：json对象，不再是数组;
• installed：值为true

3.3 获取工作台推荐应用列表

 emm.getRecommendedApps({
                  "userid": "",
                  "companyId":"",
                  "categoryname":''
                  },
                  "success()","error()")

用法和3.2相同；

3.4 同步用户常用应用列表

 emm.updateUserApps({
 "apps": [
     {
         "appid": "test00",
         "soft": "0"
     },
     {
         "appid": "test01",
         "soft": "1"
     }
 ],
 "userid": "z",
 "companyId":"",
 "categoryname": "常用应用"
 },
 "success()","error()"

 )

传递参数说明：

• userid：用户id值，
• deviceid：设备id值，
• categoryname：应用分类名称，该参数的左右待确定
• apps：传入应用的集合，包含用户常用应用列表的每一个应用
• appid：应用的id值，
• companyId:用户的住户id值
• soft：应用的索引值，
• success：成功的回调，
• error：失败的回调

4.安装应用

 emm.installWebApp({
     "appid": "",
   "version":'',
"downloadURL":'',
 }, "success()", "error()")

参数说明

• appid:需要下载安装的应用的id值;
• version: 应用版本号；
• downloadURL:应用下载地址；
• success:安装成功的回调，为持续的回调函数;
• error：安装失败的回调; 安装完成后，应用的installed的属性值应该为true

5.应用升级

emm.upgradeWebApp({
"appid":'',
"version":'',
"downloadURL":'',
},"success()","error()")

参数说明参照应用安装；

6.打开应用

 emm.openWebApp({
        "appid": appid,
         "id":"",
         "homepage":"",
        "params": {}
    }, "success()", "error()")

打开应用传递的参数与summer.openWin()的参数相似，具体参数说明：

• appid：应用的id值，
• id:应用id,
• homepage:打开应用的启动页，在获取列表时会返回，
• params：打开应用传递的参数，该参数参照openWin()中参数的传递(包含，pageParams和animate等);

7.移除应用

emm.removeWebApp({
        "appid": ''
    }, "success()", "error()")

• appid:要删除应用的id值

8.跨应用打开页面

    summer.openWin(){
       appid:'',
       id:'',
       url:''
    }

• appid：应用的id值，
• id:应用id,
• url：所打开页面的路径;

9.退出登录MAM

emm.logout({
  }, "success()", "error()")