赞
踩
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":快捷方式不存在(支持创建);"unsupported"&
Copyright © 2003-2013 www.wpsshop.cn 版权所有,并保留所有权利。