navigator用于管理浏览器运行环境信息
1、方法
1.1、checkPermission: 检查运行环境的权限
String plus.navigator.checkPermission( permission );
说明:向系统检查当前程序的权限状态,不触发权限相对应的功能API的调用。
参数:permission: ( PermissionNames) 必选 要检查的权限名称
返回值:String : 可返回以下值: "authorized"表示程序已被用户授权使用此权限; "denied"表示程序已被用户拒绝使用此权限; "undetermined"表示程序未确定是否可使用此权限,此时调用对应的API时系统会弹出提示框让用户确认; "unknown"表示程序未知此权限状态; "unsupported"表示程序不支持此权限。
示例:
// H5 plus事件处理
function plusReady(){
}
if(window.plus){
plusReady();
}else{
document.addEventListener("plusready",plusReady,false);
}
// 检查定位权限
function checkPermissionPos(){
var pp = plus.navigator.checkPermission("LOCATION");
switch(pp){
case "authorized":
plus.nativeUI.alert("已开启定位权限");
break;
case "denied":
plus.nativeUI.alert("已关闭定位权限");
break;
case "undetermined":
plus.nativeUI.alert("未确定定位权限");
break;
case "unknown":
plus.nativeUI.alert("无法查询定位权限");
break;
default:
plus.nativeUI.alert("不支持定位权限");
break;
}
}
检查权限
检查定位权限
1.2、closeSplashscreen: 关闭程序启动界面
void plus.navigator.closeSplashscreen();
说明:很多情况下,程序启动后需要一段时间加载数据,为了避免界面显示空白内容,提高用户体验效果,这时可显示启动界面。 等数据加载完成后再关闭启动界面进入应用,通常可在应用首界面加载数据完成并更新显示内容后调用此方法。 注意:HBuilder7.1版本后启动界面不调用此方法超过6秒后会自动关闭。
返回值:void : 无
示例:
// H5 plus事件处理
function plusReady(){
// 关闭程序启动界面
plus.navigator.closeSplashscreen();
}
if(window.plus){
plusReady();
}else{
document.addEventListener("plusready",plusReady,false);
}
关闭程序启动界面
1.3、updateSplashscreen: 更新程序启动界面
void plus.navigator.updateSplashscreen(options);
说明:可设置启动界面显示的图片(仅支持本地文件路径,如果是网络资源可先通过plus.downloader.*下载到本地), 更新启动界面后程序下次启动时生效。
返回值:void : 无
平台支持:Android - ALL (支持),iOS - ALL (不支持)
示例:
// H5 plus事件处理
function plusReady(){
}
if(window.plus){
plusReady();
}else{
document.addEventListener("plusready",plusReady,false);
}
// 更新启动界面
function updateSplash(){
plus.navigator.updateSplashscreen({image:"_www/splash.png"});
}
更新程序启动界面
Update
1.4、setSplashscreen:
1.5、createShortcut: 创建应用快捷方式
void plus.navigator.createShortcut( options, successCallback, errorCallback );
说明:在系统桌面创建应用的快捷方式,点击后可直接启动应用。
参数:
options: ( ShortcutOptions ) 可选 桌面快捷方式的参数
successCallback: ( ShortcutSuccessCallback ) 可选 创建桌面快捷方式成功回调
可通过回调函数参数的sure属性判断创建桌面快捷方式是否确定成功。
errorCallback: ( NavigatorErrorCallback ) 可选 创建桌面快捷方式失败回调
返回值:void : 无
平台支持:Android - 2.3+ (支持): 注意:需要添加创建快捷方式的权限“”。iOS - ALL (支持): 仅在流应用环境下支持创建桌面快捷方式(不支持通过options参数自定义快捷方式名称、图标等信息),在5+ APP环境不支持此功能。
示例:
// H5 plus事件处理
function plusReady(){
// 创建快捷方式
plus.navigator.createShortcut();
}
if(window.plus){
plusReady();
}else{
document.addEventListener("plusready",plusReady,false);
}
创建应用快捷方式
1.6、hasShortcut: 查询是否存在应用快捷方式
void plus.navigator.hasShortcut(options, successCallback);
参数:
options: ( ShortcutOptions ) 可选 查询桌面快捷方式的参数
successCallback: ( ShortcutSuccessCallback ) 可选 查询桌面快捷方式是否存在回调函数。可通过回调函数参数的result属性判断获取结果: "existing":快捷方式已存在;"none":快捷方式不存在(支持创建);"unsupport