navigator
navigator用于管理浏览器运行环境信息
方法:
- closeSplashscreen: 关闭程序启动界面
- createShortcut: 创建应用快捷方式
- isFullscreen: 判断应用当前是否全屏模式显示
- isLogs: 判断应用当前是否输出日志
- setFullscreen: 设置应用是否全屏显示
- setLogs: 设置应用是否输出日志
- setStatusBarBackground: 设置系统状态栏背景颜色
- getStatusBarBackground: 获取系统状态栏背景颜色
- setStatusBarStyle: 设置系统状态栏样式
- getStatusBarStyle: 获取系统状态栏样式
- getStatusbarHeight: 获取系统状态栏高度
- isImmersedStatusbar: 判断当前是否为沉浸式状态栏模式
- setUserAgent: 设置userAgent值
- getUserAgent: 获取userAgent值
- setCookie: 设置Cookie值
- getCookie: 获取Cookie值
- removeAllCookie: 删除应用所有Cookie值
- removeCookie: 删除应用Cookie
- removeSessionCookie: 删除应用所有会话期Cookie值
对象:
- ShortcutOptions: JSON对象,创建应用快捷方式要设置的参数
回调方法:
- ShortcutSuccessCallback: 创建桌面快捷方式成功的回调函数
- NavigatorErrorCallback: 操作错误回调函数接口
权限:
permissions
"Navigator": {
"description": "浏览器信息"
}
ShortcutOptions
JSON对象,创建应用快捷方式要设置的参数
属性:
- name: (String
类型
)快捷方式名称
如果未设置则使用应用的名称,manifest.json中name属性值。
- icon: (String
类型
)快捷方式的图标
如果未设置则优先使用应用中指定的图标(manifest.json中icon节点下对应分辨率的图标),如未区配则使用应用的图标(仅在独立打包时),否则使用runtime提供的默认图标。
- toast: (String
类型
)创建快捷方式后的提示信息
快捷方式创建成功后显示,默认提示内容为“"XXXX"已创建桌面快捷方式”,其中"XXXX"为程序的名称,如果不需要提示则设置此值为空字符串。
- extra: (JSON
类型
)快捷方式的扩展参数
其中key和value值都必须是字符串类型。
- classname: (String
类型
)要启动Activity类名
通常情况下不需要指定此值,仅在5+SDK集成时自定义Activity才用到。
ShortcutSuccessCallback
创建桌面快捷方式成功的回调函数
void onSuccess( Event event ){
var sure=event.sure; // 是否确定创建桌面快捷方式成功
}
参数:
- event:
(
Event
)
必选 创建桌面快捷方式返回的数据
在部分Launcher上无法确定是否创建桌面快捷方式成功,此时可通过event.sure(Boolean类型)获取是否确定创建成功。
返回值:
void : 无NavigatorErrorCallback
操作错误回调函数接口
function void onError( Exception error ) {
// Error.
var code = error.code; // 错误编码
var message = error.message; // 错误描述信息
}
参数:
- error:
(
Exception
)
必选 操作失败信息
可通过error.code(Number类型)获取错误编码; 可通过error.message(String类型)获取错误描述信息。