ide开发平台相关jssdk26.widget模块

1、widget 模块1、简介管理当前应用2、API 概览2.1、方法uap.widget.startWidget(apwidget,animId,funName,info,animDuration,callback) /在当前widget加载一个子参数:ap：子 widget 的 apanimId：子 widget 载入时的动画 id:0：无动画1:从左向右推入2:从右向左推入3:从上向下推入4:从下向上推入5:淡入淡出6:左翻页7:右翻页8:水波纹9:由左向右切入10:由右向左切入11:由上先下切入12:由下向上切入13:由左向右切出14:由右向左切出15:由上向下切出16:由下向上切出fun

2、Name：方法名，子 widget 结束时将 String 型的任意字符回调给该方法，可为空。 注意：只在主窗口中有效，浮动窗口中无效info：传给子 widget 的信息animDuration：动画持续时长，为毫秒，默认200毫秒callback(err,data,daype,o):(Function) 回调函数err:Error 对象，如果为空表示没有错误data:回调返回的数据，0-成功 1-失败daype:回调返回的数据类型，默认为2：类型o:操作 ID，在此函数中不起作用，可忽略支持:Android 2.2+iOS 6.0+JS-SDK 版本支持:1.0.0+例子:uap.widg

3、et.startWidget(ap: 12345,animiId : 1,funName : widgetDidFinish,info : open a widget,animDuration : 300,callback : function(err,data,daype,o)if(!err)alert(data:+data);)uap.widget.finishWidget(resultInfo,ap,isWgtBG) /退出一个 widget参数:resultInfo：此 widget 结束时，传递给 opener 的信息ap：要结束的 widget 的 ap，为空时退出的是当前的 wi

4、dgetNumber：isWgtBG 结束此 widget 的方式，0表示销毁该 widget，下次再调 用 startWidget 时，重新打开；1表示把该 widget 置于，下次再调用 startWidget 时，不重新打开，操作数据全部保存。不传或为空时，默认为0。注意传该参数时，必须要传 ap参数。支持:Android 2.2+iOS 6.0+JS-SDK 版本支持:1.0.0+例如：uap.widget.finishWidget(resultInfo: finish a widget,ap: 12345,isWgtBG: 0);uap.widget.removeWidget(ap,

5、callback) /删除一个 widget参数:ap：widget 的 ap，主 widget 不能被删除callback(err,data,daype,o):(Function) 回调函数err:Error 对象，如果为空表示没有错误data:回调返回的数据，0-成功 1-失败daype:参数类型o:操作 ID，在此函数中不起作用，可忽略支持:Android 2.2+iOS 6.0+JS-SDK 版本支持:1.0.0+例子：uap.widget.removeWidget(ap: “12345”,callback : function(err,data,daype,o)if(!err)ale

6、rt(data:+data););uap.widget.checkUpdate(callback) /检查当前 widget 是否有更新参数:callback(err,data,daype,o):(Function) 回调函数err:Error 对象，如果为空表示没有错误data:检查结果0- 需要更新 1- 不需要更新 2-错误daype:参数类型o:操作 ID，在此函数中不起作用，可忽略支持:Android 2.2+iOS 6.0+JS-SDK 版本支持:1.0.0+示例：uap.widget.checkUpdate(function(err,data,daype,o)alert(data

7、:+data);)或者uap.widget.checkUpdate(callback : function(err,data,daype,o)alert(data:+data););uap.widget.loadApp(appInfo) /启动第应用（iOS）参数:appInfo：(String)第应用的 URLSchemes支持:iOS 6.0+JS-SDK 版本支持:1.0.0+例如：var appInfo = ht;uap.widget.loadApp(appInfo);uap.widget.startApp(startMode,mainInfo,addInfo,optInfo,call

8、back) /启动第应用（Android）参数:startMode：启动方式，0表示通过包名和类名启动，1表示通过 Action启动optInfo：附加参数，键值对，key:value格式多个用英文”,”隔开startMode：启动类型，0或者1；mainInfo：包名（startMode 为0时）；action(startMode 为1时)addInfo：类名，为空时启动应用类（startMode 为0时）；category或 data（startMode 为1时）json 格式如下category: android.ent.category.WID,android.ent.category

9、.WID1,data: mimeType: image/png,scheme: sipcallback(info):启动第应用的回调方法，该方法在未成功调用第三方应用时回调。info:回调返回信息；支持:Android 2.2+JS-SDK 版本支持:1.0.0+注意事项：如果通过包名类名启动 uap 应用，而且需要onLoadByOtherApp回调方法，则 addInfo 为必选。调用方法如下： 若包名为com.uap.develop(开发者在使用时只需要更换包名即可),则调用代码如下：var packageName = com.uap.develop;var claame = .zywx

10、.wbpatar.engine.EBrowserActivity;var optInfo = key1:value1,key2:value1;uap.widget.startApp(startMode : 0,mainInfo : packageName,addInfo :claame,optInfo : optInfo,callback:function(info)alert(info););示例：1.要启动的 AndroidManifest.xml 文件如下：/通过包名启动，非必须/通过 action 启动时，category DEFAULT 属性必须，否则无法调起2.启动该应用对应界面示

11、例如下：function startAppP(mode)var main,add,opt;main = com.dongjf.mytest;switode)case 0:uap.widget.startApp(startMode : 0,mainInfo : main);/启动应用的主类break;case 1:add = com.dongjf.mytest.SecondActivity;uap.widget.startApp(startMode : 0,mainInfo : main,addInfo :add);/启动应用的 SecondActivity 类break;case 2:add

12、= com.dongjf.mytest.ThirdActivity;opt = key1: value1,key2: value2;uap.widget.startApp(startMode : 0,mainInfo : main,addInfo :add,optInfo : opt);/启动应用的 ThirdActivity 类break;function startAppA(mode)var main,add,opt;switode)case 0:main = com.djf.test.main;uap.widget.startApp(startMode : 1,mainInfo : ma

13、in);/启动应用的 MainActivity 类break;case 1:main = com.djf.test.second;add = data:scheme:;uap.widget.startApp(startMode : 1,mainInfo : main,addInfo :add);/启动应用的 SecondActivity 类break;case 2:main = com.djf.test.second;add = data:mimeType:text/html;opt = key1: value1,key2: value2;uap.widget.startApp(startMo

14、de : 1,mainInfo : main,addInfo :add,optInfo : opt);/启动应用的 Forctivity 类break;case 3:main = com.djf.test.second;add = data:mimeType:image/png,scheme:sip;opt = key1: value1,key2: value2;uap.widget.startApp.widget.startApp(startMode : 1,mainInfo : main,addInfo :add,optInfo : opt);/启动应用的 ThirdActivity 类b

15、reak;case 4:main = com.djf.test.second;add=category:android.ent.category.WID,android.ent.category.WID1,data:mimeType:image/png,scheme:sip;uap.widget.startApp(startMode : 1,mainInfo : main,addInfo :add,);/启动应用的 ThirdActivity 类break;uap.widget.getOpenerInfo(callback) /获取打开者传入此 widget 的相关信息即调用 startWid

16、get 时传入的 info 参数值。参数:callback(err,data,daype,o):(Function) 回调函数err:Error 对象，如果为空表示没有错误data:返回的数据 本 widget 的打开者通过startWidget 函数打开本widget 时传入的 info 参数值daype:参数类型o:操作 ID，在此函数中不起作用，可忽略支持:Android 2.2+iOS 6.0+JS-SDK 版本支持:1.0.0+示例:uap.widget.getOpenerInfo(function(err,data,daype,o)if(!err)alert(data:+data)

17、;)或者uap.widget.getOpenerInfo(callback : function(err,data,daype,o)if(!err)alert(data:+data);)uap.widget.installApp(appPath) /根据安装包所在路径安装一个 apk(Android 方法)参数:appPath：(String)apk 所在路径支持:Android 2.2+JS-SDK 版本支持:1.0.0+示例:var path = res:/pay.apk;uap.widget.installApp(appPath : path);或者uap.widget.installA

18、pp(path);uap.widget.getPushInfo(callback) /获取推送消息,上报消息到管理参数:callback(data,daype,o):(Function) 回调函数err:Error 对象，如果为空表示没有错误data:返回的数据 json 格式字符串daype:参数类型o:操作 ID，在此函数中不起作用，可忽略支持:Android 2.2+iOS 6.0+JS-SDK 版本支持:1.0.0+示例:uap.widget.getPushInfo(callback: function(err,data,daype,o)if(!err)alert(data:+data

19、););uap.widget.setPushNotifyCallback(cbFunction) /回调推送通知页面如果应用开启了推送功能，那么当有消息推送进来时，将调用指定的 cbFunction 函数通知页面。参数:cbFunction：(String)回调函数方法名支持:Android 2.2+iOS 6.0+JS-SDK 版本支持:1.0.0+示例:uap.widget.setPushNotifyCallback(pushCallback);function pushCallback()alert(收到推送消息);uap.widget.setPushInfo(uId,uNickName

20、) /设置推送用户信息参数:uId：用户 IDuNickName：用户昵称支持:Android 2.2+iOS 6.0+JS-SDK 版本支持:1.0.0+示例:uap.widget.setPushInfo(uId: user10001,uNickName : );uap.widget.setPushSe(se) /设置推送服务的状态参数:se: 推送服务状态0-关闭1-开启支持:Android 2.2+iOS 6.0+JS-SDK 版本支持:1.0.0+示例:uap.widget.setPushSe(0);uap.widget.getPushSe(callback) /获取推送服务的状态参数

21、:callback(data,daype,o):(Function) 回调函数err:Error 对象，如果为空表示没有错误data:0-关闭 1-开启daype:参数类型o:操作 ID，在此函数中不起作用，可忽略支持:Android 2.2+iOS 6.0+JS-SDK 版本支持:1.0.0+示例:uap.widget.getPushSe(callback: function(err,data,daype,o)if(!err)alert(data:+data);)uap.widget.isAppInstalled(appDallback) /是否安装某第应用参数:appData:(Strin

22、g)第应用数据,android为第应用包名；iOS为 Scheme Urlcallback(data):(Function) 回调函数err:Error 对象，如果为空表示没有错误data:0-已安装；1-未安装支持:Android 2.2+iOS 6.0+JS-SDK 版本支持:1.0.0+示例:uap.widget.isAppInstalled(appData : com.tencent.mobile,callback : function(err,data)if(!err)if(data = 0)alert(已安装);else if(data =1)alert(未安装);elsealer

23、t(data);/错误);2.2方法所有的方法都得在 root 页面进行uap.widget.onLoadByOtherApp /被第应用调起的方法JS-SDK 版本支持:1.0.0+示例:uap.widget.onLoadByOtherApp = function(jsonData)alert(jsonData);/key1:value1,key2:value2uap.widget.loadByOtherApp(callback) /被第应用调起的回调方法参数:callback(jsonData):(Function) 回调函数jsonData:(String类型 )必选 传递的数据， json格式 key1:value1,key2:value2,key3:value3,key4:value4JS-SDK 版本支持:1.0.0+示例:应用1启动应用2的代码(Android)var packageName =com.uap.develop;var claame = .zywx.wbpatar.engine.EBrowserActivity;var optionInfo = key1:value1,key2:value2;uap.widget.