ide開(kāi)發(fā)平臺(tái)相關(guān)jssdk26.widget模塊

1、widget 模塊1、簡(jiǎn)介管理當(dāng)前應(yīng)用2、API 概覽2.1、方法uap.widget.startWidget(apwidget,animId,funName,info,animDuration,callback) /在當(dāng)前widget加載一個(gè)子參數(shù):ap：子 widget 的 apanimId：子 widget 載入時(shí)的動(dòng)畫 id:0：無(wú)動(dòng)畫1:從左向右推入2:從右向左推入3:從上向下推入4:從下向上推入5:淡入淡出6:左翻頁(yè)7:右翻頁(yè)8:水波紋9:由左向右切入10:由右向左切入11:由上先下切入12:由下向上切入13:由左向右切出14:由右向左切出15:由上向下切出16:由下向上切出fun

2、Name：方法名，子 widget 結(jié)束時(shí)將 String 型的任意字符回調(diào)給該方法，可為空。 注意：只在主窗口中有效，浮動(dòng)窗口中無(wú)效info：傳給子 widget 的信息animDuration：動(dòng)畫持續(xù)時(shí)長(zhǎng)，為毫秒，默認(rèn)200毫秒callback(err,data,daype,o):(Function) 回調(diào)函數(shù)err:Error 對(duì)象，如果為空表示沒(méi)有錯(cuò)誤data:回調(diào)返回的數(shù)據(jù)，0-成功 1-失敗daype:回調(diào)返回的數(shù)據(jù)類型，默認(rèn)為2：類型o:操作 ID，在此函數(shù)中不起作用，可忽略支持: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) /退出一個(gè) widget參數(shù):resultInfo：此 widget 結(jié)束時(shí)，傳遞給 opener 的信息ap：要結(jié)束的 widget 的 ap，為空時(shí)退出的是當(dāng)前的 wi

4、dgetNumber：isWgtBG 結(jié)束此 widget 的方式，0表示銷毀該 widget，下次再調(diào) 用 startWidget 時(shí)，重新打開(kāi)；1表示把該 widget 置于，下次再調(diào)用 startWidget 時(shí)，不重新打開(kāi)，操作數(shù)據(jù)全部保存。不傳或?yàn)榭諘r(shí)，默認(rèn)為0。注意傳該參數(shù)時(shí)，必須要傳 ap參數(shù)。支持: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) /刪除一個(gè) widget參數(shù):ap：widget 的 ap，主 widget 不能被刪除callback(err,data,daype,o):(Function) 回調(diào)函數(shù)err:Error 對(duì)象，如果為空表示沒(méi)有錯(cuò)誤data:回調(diào)返回的數(shù)據(jù)，0-成功 1-失敗daype:參數(shù)類型o:操作 ID，在此函數(shù)中不起作用，可忽略支持: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) /檢查當(dāng)前 widget 是否有更新參數(shù):callback(err,data,daype,o):(Function) 回調(diào)函數(shù)err:Error 對(duì)象，如果為空表示沒(méi)有錯(cuò)誤data:檢查結(jié)果0- 需要更新 1- 不需要更新 2-錯(cuò)誤daype:參數(shù)類型o:操作 ID，在此函數(shù)中不起作用，可忽略支持: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) /啟動(dòng)第應(yīng)用（iOS）參數(shù):appInfo：(String)第應(yīng)用的 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) /啟動(dòng)第應(yīng)用（Android）參數(shù):startMode：?jiǎn)?dòng)方式，0表示通過(guò)包名和類名啟動(dòng)，1表示通過(guò) Action啟動(dòng)optInfo：附加參數(shù)，鍵值對(duì)，key:value格式多個(gè)用英文”,”隔開(kāi)startMode：?jiǎn)?dòng)類型，0或者1；mainInfo：包名（startMode 為0時(shí)）；action(startMode 為1時(shí))addInfo：類名，為空時(shí)啟動(dòng)應(yīng)用類（startMode 為0時(shí)）；category或 data（startMode 為1時(shí)）json 格式如下category: android.ent.category.WID,android.ent.category

9、.WID1,data: mimeType: image/png,scheme: sipcallback(info):啟動(dòng)第應(yīng)用的回調(diào)方法，該方法在未成功調(diào)用第三方應(yīng)用時(shí)回調(diào)。info:回調(diào)返回信息；支持:Android 2.2+JS-SDK 版本支持:1.0.0+注意事項(xiàng)：如果通過(guò)包名類名啟動(dòng) uap 應(yīng)用，而且需要onLoadByOtherApp回調(diào)方法，則 addInfo 為必選。調(diào)用方法如下： 若包名為com.uap.develop(開(kāi)發(fā)者在使用時(shí)只需要更換包名即可),則調(diào)用代碼如下：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.要啟動(dòng)的 AndroidManifest.xml 文件如下：/通過(guò)包名啟動(dòng)，非必須/通過(guò) action 啟動(dòng)時(shí)，category DEFAULT 屬性必須，否則無(wú)法調(diào)起2.啟動(dòng)該應(yīng)用對(duì)應(yīng)界面示

11、例如下：function startAppP(mode)var main,add,opt;main = com.dongjf.mytest;switode)case 0:uap.widget.startApp(startMode : 0,mainInfo : main);/啟動(dòng)應(yīng)用的主類break;case 1:add = com.dongjf.mytest.SecondActivity;uap.widget.startApp(startMode : 0,mainInfo : main,addInfo :add);/啟動(dòng)應(yīng)用的 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);/啟動(dòng)應(yīng)用的 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);/啟動(dòng)應(yīng)用的 MainActivity 類break;case 1:main = com.djf.test.second;add = data:scheme:;uap.widget.startApp(startMode : 1,mainInfo : main,addInfo :add);/啟動(dòng)應(yīng)用的 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);/啟動(dòng)應(yīng)用的 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);/啟動(dòng)應(yīng)用的 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,);/啟動(dòng)應(yīng)用的 ThirdActivity 類break;uap.widget.getOpenerInfo(callback) /獲取打開(kāi)者傳入此 widget 的相關(guān)信息即調(diào)用 startWid

16、get 時(shí)傳入的 info 參數(shù)值。參數(shù):callback(err,data,daype,o):(Function) 回調(diào)函數(shù)err:Error 對(duì)象，如果為空表示沒(méi)有錯(cuò)誤data:返回的數(shù)據(jù) 本 widget 的打開(kāi)者通過(guò)startWidget 函數(shù)打開(kāi)本widget 時(shí)傳入的 info 參數(shù)值daype:參數(shù)類型o:操作 ID，在此函數(shù)中不起作用，可忽略支持: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) /根據(jù)安裝包所在路徑安裝一個(gè) apk(Android 方法)參數(shù):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) /獲取推送消息,上報(bào)消息到管理參數(shù):callback(data,daype,o):(Function) 回調(diào)函數(shù)err:Error 對(duì)象，如果為空表示沒(méi)有錯(cuò)誤data:返回的數(shù)據(jù) json 格式字符串daype:參數(shù)類型o:操作 ID，在此函數(shù)中不起作用，可忽略支持: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) /回調(diào)推送通知頁(yè)面如果應(yīng)用開(kāi)啟了推送功能，那么當(dāng)有消息推送進(jìn)來(lái)時(shí)，將調(diào)用指定的 cbFunction 函數(shù)通知頁(yè)面。參數(shù):cbFunction：(String)回調(diào)函數(shù)方法名支持:Android 2.2+iOS 6.0+JS-SDK 版本支持:1.0.0+示例:uap.widget.setPushNotifyCallback(pushCallback);function pushCallback()alert(收到推送消息);uap.widget.setPushInfo(uId,uNickName

20、) /設(shè)置推送用戶信息參數(shù):uId：用戶 IDuNickName：用戶昵稱支持:Android 2.2+iOS 6.0+JS-SDK 版本支持:1.0.0+示例:uap.widget.setPushInfo(uId: user10001,uNickName : );uap.widget.setPushSe(se) /設(shè)置推送服務(wù)的狀態(tài)參數(shù):se: 推送服務(wù)狀態(tài)0-關(guān)閉1-開(kāi)啟支持:Android 2.2+iOS 6.0+JS-SDK 版本支持:1.0.0+示例:uap.widget.setPushSe(0);uap.widget.getPushSe(callback) /獲取推送服務(wù)的狀態(tài)參數(shù)

21、:callback(data,daype,o):(Function) 回調(diào)函數(shù)err:Error 對(duì)象，如果為空表示沒(méi)有錯(cuò)誤data:0-關(guān)閉 1-開(kāi)啟daype:參數(shù)類型o:操作 ID，在此函數(shù)中不起作用，可忽略支持: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) /是否安裝某第應(yīng)用參數(shù):appData:(Strin

22、g)第應(yīng)用數(shù)據(jù),android為第應(yīng)用包名；iOS為 Scheme Urlcallback(data):(Function) 回調(diào)函數(shù)err:Error 對(duì)象，如果為空表示沒(méi)有錯(cuò)誤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);/錯(cuò)誤);2.2方法所有的方法都得在 root 頁(yè)面進(jìn)行uap.widget.onLoadByOtherApp /被第應(yīng)用調(diào)起的方法JS-SDK 版本支持:1.0.0+示例:uap.widget.onLoadByOtherApp = function(jsonData)alert(jsonData);/key1:value1,key2:value2uap.widget.loadByOtherApp(callback) /被第應(yīng)用調(diào)起的回調(diào)方法參數(shù):callback(jsonData):(Function) 回調(diào)函數(shù)jsonData:(String類型 )必選 傳遞的數(shù)據(jù)， json格式 key1:value1,key2:value2,key3:value3,key4:value4JS-SDK 版本支持:1.0.0+示例:應(yīng)用1啟動(dòng)應(yīng)用2的代碼(Android)var packageName =com.uap.develop;var claame = .zywx.wbpatar.engine.EBrowserActivity;var optionInfo = key1:value1,key2:value2;uap.widget.