UMM MAM

UMM MAM

UMM MAM 相关的API，主要用于Summer框架开发移动工作台时对接UMM的MAM能力的API。

注意：Android 6以上版本使用此部分API时需要手动申请权限,权限申请参考 Summer API -> 应用管理 -> 应用权限下的 API summer.getPermission()（仅Android）

Android需申请的权限:
android.permission.INTERNET
android.permission.READ_EXTERNAL_STORAGE
android.permission.WRITE_EXTERNAL_STORAGE
android.permission.READ_PHONE_STATE

emm.getUserCommonApps()

获取用户的常用应用列表，前置API emm.writeConfig()、emm.registerDevice()

语法

emm.getUserCommonApps({
    "userid": "",
    "companyId": "",
    "categoryname":""
}, "successFn()","errorFn()")
function successFn(){
}
function errorFn(){
}

参数：

JSON
- userid：用户ID
- companyId：UMM的租户ID
- categoryname：应用分类名称，可选，如不传则返回所有分类的常用应用
successFn：成功回调
errorFn：失败回调

示例代码

emm.getUserCommonApps({
    "userid": "admin",
    "companyId":'hrtest88',
    "categoryname":'常用应用'
}, "successFn(ret)","errorFn(ret)")
function successFn(ret){
    alert($summer.jsonToStr(ret));
}
function errorFn(ret){
    alert($summer.jsonToStr(ret));
    alert('请求用户常用应用列表错误');
}

emm.getSystemApps()

获取全部应用列表，前置API emm.writeConfig()、emm.registerDevice()

语法

emm.getSystemApps({
    "userid": "",
    "companyId": ""
}, "successFn()","errorFn()")
function successFn(){
}
function errorFn(){
}

参数：

JSON
- userid：用户ID
- companyId：UMM的租户ID
successFn：成功回调
errorFn：失败回调

示例代码

emm.getSystemApps({
    "userid": "admin",
    "companyId":'hrtest88'
}, "successFn(ret)","errorFn(ret)")
function successFn(ret){
    alert($summer.jsonToStr(ret));
}
function errorFn(ret){
    alert($summer.jsonToStr(ret));
    alert('获取系统app列表失败！！！');
}

emm.getRecommendedApps()

获取其他APP列表，前置API emm.writeConfig()、emm.registerDevice()

语法

emm.getRecommendedApps({
    "userid": "",
    "deviceid":"",
    "os":"",
    "categoryname":""
}, "successFn()","errorFn()")
function successFn(){
}
function errorFn(){
}

参数：

JSON
- userid：用户ID
- deviceid：设备ID
- os：系统(“android”或”ios”)
- categoryname：应用分类名称
successFn：成功回调
errorFn：失败回调

示例代码

emm.getRecommendedApps({
    "userid": "admin",
    "deviceid":"D8YDU15A31007455868753026659499",
    "os":"android",
    "categoryname":"首页应用"
}, "successFn(ret)","errorFn(ret)")
function successFn(ret){
    alert($summer.jsonToStr(ret));
}
function errorFn(ret){
    alert($summer.jsonToStr(ret));
}

emm.updateUserApps()

更新用户常用应用列表，前置API emm.writeConfig()、emm.registerDevice()

语法

emm.updateUserApps({
    "apps": [],
    "userid": "",
    "companyId": "",
    "categoryname": ""
}, "successFn()","errorFn()")
function successFn(){
}
function errorFn(){
}

参数：

JSON
- apps：应用列表
- userid：用户ID
- companyId：UMM的租户ID
- categoryname：类别名称
successFn：成功回调
errorFn：失败回调

示例代码

var newArr=[];
emm.updateUserApps({
    "apps": newArr,
    "userid": "admin",
    "companyId":"hrtest88",
    "categoryname": "常用应用"
}, "successFn(ret)","errorFn(ret)")
function successFn(ret){
    alert($summer.jsonToStr(ret));
}
function errorFn(ret){
    alert($summer.jsonToStr(ret));
}

emm.upgradeWebApp()

应用升级，前置API emm.writeConfig()、emm.registerDevice()

语法

emm.upgradeWebApp({
    "appid":"",
    "version":"",
    "downloadURL":"",
},"successFn()","errorFn()")
function successFn(){
}
function errorFn(){
}

参数：

JSON
- appid：应用ID
- version：应用版本
- downloadURL：下载地址
successFn：成功回调
errorFn：失败回调

示例代码

emm.upgradeWebApp({
    "appid":"001",
    "version":"3.0",
    "downloadURL":"http://apps/download",
}, "successFn(ret)","errorFn(ret)")
function successFn(ret){
    alert($summer.jsonToStr(ret));
}
function errorFn(ret){
    alert($summer.jsonToStr(ret));
}

emm.upgradeSilentSignal()

判断应用是否可以静默升级，前置API emm.writeConfig()、emm.registerDevice()

语法

emm.upgradeSilentSignal({
    "appid":"",
    "companyId":""
},"successFn()","errorFn()")
function successFn(){
}
function errorFn(){
}

参数：

JSON
- appid：应用ID
- companyId：租户ID
successFn：成功回调
errorFn：失败回调

示例代码

emm.upgradeSilentSignal({
    "appid":"001",
    "companyId":"xxx"
}, "successFn(ret)","errorFn(ret)")
function successFn(ret){
    alert($summer.jsonToStr(ret));
}
function errorFn(ret){
    alert($summer.jsonToStr(ret));
}

返回值

{
    result={
        "tp": "none",
        "data": {
            "appdata": [
                {
                    "appgroupid": "00000000000000000001AA10000000000TMA",
                    "apps": [
                        {
                            "downloadURL": "https://file-cdn.yonyoucloud.com/iuapmobile/emm/app_packages/summer.zip",
                            "scop_type": "1",
                            "appname": "资讯",
                            "appid": "yanggfc",
                            "homepage": "",
                            "iconURL": "https://file-cdn.yonyoucloud.com/8186.png",
                            "version": "3.22",
                            "isupdate": "false",
                            "installed": "false"
                        }
                    ],
                    "appgroupname": "默认类别"
                }
            ],
            "code": "1",
            "msg": "数据查询成功"
        }
    },
    callback_object=com.yyuap.summer.core.IUAPServiceCallback@c1fafe5
}
//下载进度的回调返回（例子）
{"code":"1","percent":3.9202351570129395,"message":"progress","isfinish":"0"}
//下载完成的回调返回（例子）
{"code":"1","percent":100,"message":"success","isfinish":"1"}

emm.upgradeSummerApp()

Summer应用升级，前置API emm.writeConfig()、emm.registerDevice()

语法

emm.upgradeSummerApp({
    "appid":"",
    "version":"",
    "downloadURL":""
},"successFn()","errorFn()")
function successFn(){
}
function errorFn(){
}

参数：

JSON
- appid：应用ID
- version：应用版本
- downloadURL：下载地址
successFn：成功回调
errorFn：失败回调

示例代码

emm.upgradeSummerApp({
    "appid":"001",
    "version":"3.0",
    "downloadURL":"http://apps/download"
}, "successFn(ret)","errorFn(ret)")
function successFn(ret){
    alert($summer.jsonToStr(ret));
}
function errorFn(ret){
    alert($summer.jsonToStr(ret));
}

emm.installWebApp()

安装应用，前置API emm.writeConfig()、emm.registerDevice()

语法

emm.installWebApp({
    "appid": ""
}, "successFn(ret)", "errorFn()")
function successFn(ret){
    alert($summer.jsonToStr(ret));
}
function errorFn(){
}

参数：

JSON
- appid：应用ID
successFn：成功回调
errorFn：失败回调

示例代码：

emm.installWebApp({
    "appid": "001"
}, "successFn(ret)", "errorFn()")
function successFn(ret){
    if (ret.isfinish == 0) {
        $('.btn1').html('安装应用：下载中 - ' + ret.percent);
    } else {
        $('.btn1').html('安装应用：已安装');
    }
}
function errorFn(){
}

emm.openWebApp()

打开应用，前置API emm.writeConfig()、emm.registerDevice()

语法

emm.openWebApp({
    "appid": ""
}, "successFn()", "errorFn()")
function successFn(){
}
function errorFn(){
}

参数：

JSON
- app_type：应用类型
- appid：应用ID
- downloadURL：下载地址
- homepage: 打开应用主页
- startupclass: 启动类
- actionBar: 原生头配置
- addBackListener: 返回监听
- pageParam: {} 打包应用的参数
- animation:动画参数，不传时使用默认动画movein，type：动画类型，subType：动画子类型。可参考openWin()API中的该参数
successFn：成功回调
errorFn：失败回调

示例代码：

emm.openWebApp({
    "appid": "001"
    "app_type": app_type,
    "downloadURL": downloadURL,
    "homepage": homepage,
    "startupclass": startupclass,
    "actionBar": actionbar,
    "addBackListener": addBackListener,
    "params": params
}, "successFn()", "errorFn()")
function successFn(){
}
function errorFn(){
}

startupclass 参数说明：
1、库文件打的DSL原生应用ApkInfo.txt中的Startup-Class需要配置成com.yonyou.uap.um.activity.WelcomeActivity
2、库文件打的Summer原生应用ApkInfo.txt中的Startup-Class需要配置成com.yyuap.summer.StartSummerActivity
3、其它原生请咨询应用开发者配置Startup-Class为应用启动Activity

emm.removeWebApp()

删除应用，前置API emm.writeConfig()、emm.registerDevice()

语法

emm.removeWebApp({
    "appid": "",
    "params": {}
}, "successFn()", "errorFn()")
function successFn(){
}
function errorFn(){
}

参数：

JSON
- appid：应用ID
successFn：成功回调
errorFn：失败回调

示例代码：

emm.removeWebApp({
    "appid": "001"
}, "successFn()", "errorFn()")
function successFn(){
}
function errorFn(){
}

emm.getApps()（兼容）

获取应用列表，前置API emm.writeConfig()、emm.registerDevice()

语法

emm.getApps({
}, "successFn()", "errorFn()")
function successFn(){
}
function errorFn(){
}

参数：
无

返回值：

JSON
- appid:应用ID
- appname:应用名称
- appicon:应用图标
- appdetail:应用详情
- appgroupcode:应用分组ID
- appgroup:应用分组名称
- version:当前版本
- lastversion:最新版本
- isupdate:是否更新
successFn：成功回调
errorFn：失败回调

JSON

{
    "appid":"",
    "appname":"",
    "appicon":"",
    "appdetail":"",
    "appgroupcode":"",
    "appgroup":"",
    "version":"",
    "lastversion":"",
    "isupdate":"",
}{
}

示例代码：

emm.getApps({
}, "successFn(ret)", "errorFn(ret)")
function successFn(ret){
    alert($summer.jsonToStr(ret);
}
function errorFn(ret){
    alert($summer.jsonToStr(ret));
}

emm.getLocalApps()

获取本地已经安装的应用列表，前置API emm.writeConfig()、emm.registerDevice()

语法

emm.getLocalApps({}, "successFn()", "errorFn()");
function successFn(){
};
function errorFn(){
};

参数：

JSON：{}
successFn：成功回调
errorFn：失败回调

示例代码：

emm.getLocalApps({}, "successFn()", "errorFn()");
function successFn(args){
    $summer.alert(args);
};
function errorFn(args){
    $summer.alert(args);
};

返回值：

{
    result:[{
        appid:"demo1",
        version:"1.0"
    },{
        appid:"demo2",
        version:"2.0"
    }]
}

文档更新时间: 2018-04-09 14:33

MAM API

UMM MAM

emm.getUserCommonApps()

emm.getSystemApps()

emm.getRecommendedApps()

emm.updateUserApps()

emm.upgradeWebApp()

emm.upgradeSilentSignal()

emm.upgradeSummerApp()

emm.installWebApp()

emm.openWebApp()

emm.removeWebApp()

emm.getApps()（兼容）

emm.getLocalApps()