下载文档

widgetOne模块
更新时间:2016-01-08

appcan.widgetOne

关于appcan系统全局对象操作的基础功能的封装

appcan.widgetOne.getPlatformName()

获取系统名称,如Android、iOS等。

参数:

平台支持:

Android2.2+

iOS6.0+

JS SDK版本支持

1.0.0+

例如:

  1. //获取当前终端的系统名称
  2. var platname = appcan.widgetOne.getPlatName();
  3. //另外一种使用方式
  4. var widgetone = appcan.require("widgetOne");
  5. var platName = widgetone.getPlatName();

appcan.widgetOne.getPlatVersion()

获取系统的版本,如2.3.4 、4.3.1等。

参数:

平台支持:

Android2.2+

iOS6.0+

JS SDK版本支持

1.0.0+

例如:

  1. //获取当前终端系统的版本
  2. var platversion =appcan.widgetOne.getPlatVersion();
  3. //另外一种使用方式
  4. var widgetone = appcan.require("widgetOne");
  5. var platversion = widgetone.getPlatVersion();

appcan.widgetOne.isIOS7Style()

判断当前应用是否为iOS7风格,0为非iOS7风格,1为iOS7风格。

参数:

平台支持:

iOS6.0+

JS SDK版本支持

1.0.0+

例如:

  1. //判断当前应用是否为iOS7风格
  2. var is=appcan.widgetOne.isIOS7Style();
  3. //另外一种使用方式
  4. var widgetone = appcan.require("widgetOne");
  5. var is = widgetone.isIOS7Style();

appcan.widgetOne.isFullScreen()

判断当前应用是否为全屏,0非全屏(显示状态栏),1为全屏(不显示状态栏)。

参数:

平台支持:

iOS6.0+

JS SDK版本支持

1.0.0+

例如:

  1. //判断当前应用是否为全屏
  2. var is=appcan.widgetOne.isFullScreen();
  3. //另外一种使用方式
  4. var widgetone = apppcan.require("widgetOne");
  5. var is = widgetone.isFullScreen();

appcan.widgetOne.getPlatform(callback)

获取平台信息

参数:

  1. callback(err,data,dataType,opId):
  2. err:当出现错误的时候error,否则为空
  3. data:返回当前手机平台的类型,0IOS1Android2Chrome
  4. dataType: 返回数据类型,此方法未2Number类型
  5. opId:操作ID,在此函数中不起作用,可忽略

平台支持:

Android2.2+

iOS6.0+

JS SDK版本支持

1.0.0+

例如:

  1. appcan.widgetOne.getPlatform(function(err,data,dataType,opId){
  2. if(err){
  3. alert(err);
  4. }else{
  5. alert(data);
  6. }
  7. });
  8. //另外一种使用方式
  9. var widgetone = appcan.require("widgetOne");
  10. widgetone.getPlatform(function(err,data,dataType,opId){
  11. if(err){
  12. alert(err);
  13. }else{
  14. alert(data);
  15. }
  16. });

appcan.widgetOne.exit(flag)

退出程序

参数:

  1. flag:Number ;当flag0的时候不弹出关闭提示框,反之弹出(如果flag不为Number类型,则执行时不会弹出关闭提示框)

平台支持:

Android2.2+

iOS6.0+

JS SDK版本支持

1.0.0+

例如:

  1. appcan.widgetOne.exit(1);
  2. //另外一种使用方式
  3. var widgetone = appcan.require("widgetOne");
  4. widgetone.exit(1);

appcan.widgetOne.getCurrentWidgetInfo(callback)

获取当前widget信息

参数:

  1. callback(err,data,dataType,opId)
  2. err:判断获取当前widget信息是否出错,当err为空的时候,获取正常,反之返回错误信息
  3. data:当err为空的时候,返回当前widget的相关信息,json数据格式
  4. dataType:返回data的数据类型,此处应为1json字符串
  5. opId:操作ID,在此函数中不起作用,可忽略

平台支持:

Android2.2+

iOS6.0+

JS SDK版本支持

1.0.0+

例如:

  1. appcan.widgetOne.getCurrentWidgetInfo(function(err,data,dataType,opId){
  2. if(err){
  3. alert(err);
  4. }else{
  5. alert(data);
  6. }
  7. });
  8. //另外一种使用方式
  9. var widgetone = appcan.require("widgetOne");
  10. widgetone.getCurrentWidgetInfo(function(err,data,dataType,opId){
  11. if(err){
  12. alert(err);
  13. }else{
  14. alert(data);
  15. }
  16. });

appcan.widgetOne.cleanCache(callback)

清除当前应用缓存,仅主widget调用此接口有效

参数:

  1. callback(err,data,dataType,opId)
  2. err:当出现错误的时候error,否则为空
  3. data:返回清除缓存结果;0:成功;1:失败
  4. dataType:回调返回数据类型,此处为2Number
  5. opId:操作ID,在此函数中不起作用,可忽略

平台支持:

Android2.2+

iOS6.0+

JS SDK版本支持

1.0.0+

例如:

  1. appcan.widgetOne.cleanCache(function(err,data,dataType,opId){
  2. if(err){
  3. alert(err);
  4. }else{
  5. alert(data);
  6. }
  7. });
  8. //另外一种方式
  9. var widgetone = appcan.require("widgetOne");
  10. widgetone.cleanCache(function(err,data,dataType,opId){
  11. if(err){
  12. alert(err);
  13. }else{
  14. alert(data);
  15. }
  16. })

appcan.widgetOne.getMainWidgetId(callback)

获取主widget的appId

参数:

  1. callback(err,data,dataType,opId)
  2. err:判断获取主widgetappId是否成功,当err为空的时候,获取成功,反之获取失败,出现错误
  3. data:返回主widgetappId
  4. dataType:参数类型详见CONSTANTCallback方法数据类型
  5. opId:操作ID,在此函数中不起作用,可忽略

平台支持:

Android2.2+

iOS6.0+

JS SDK版本支持

1.0.0+

例如:

  1. appcan.widgetOne.getMainWidgetId(function(err,data,dataType,opId){
  2. if(err){
  3. alert(err);
  4. }else{
  5. alert(data);
  6. }
  7. })
  8. //另外一种使用方式
  9. var widgetone = appcan.require("widgetOne");
  10. widgetone.getMainWidgetId(function(err,data,dataType,opId){
  11. if(err){
  12. alert(err);
  13. }else{
  14. alert(data);
  15. }
  16. })

appcan.widgetOne.error(callback)

出现异常时的回调方法

  1. callback(data,dataType,opId)
  2. data:错误信息
  3. dataType:错误代码详见ErrorCode
  4. opId:操作ID,在此函数中不起作用,可忽略

说明:

JS SDK版本支持

1.0.0+

例如:

  1. appcan.widgetOne.error(function(data,dataType,opId){
  2. alert('data:'+data+';dataType:'+dataType);
  3. })
  4. //另外一种使用方式
  5. var widgetone = appcan.require("widgetOne");
  6. widgetone.error(function(data,dataType,opId){
  7. alert('data:'+data+';dataType:'+dataType);
  8. })

appcan.widgetOne.onError

出现异常时的监控方法

JS SDK版本支持

1.0.0+

例如:

  1. appcan.widgetOne.onError = function(data,dataType){
  2. alert('错误信息:'+data);
  3. alert('错误信息类型:'+dataType);
  4. }