插件配置

插件图标配置

module.exports = {
res:{
plugins:["/native/res/plugins/light.png","/native/res/plugins/email.png"]
}
};

插件内容配置

可以在plugins配置项中配置APP中使用的插件信息,如扫一扫,分享等;

module.exports = {
plugins:{
"scan":{
},
"share":{
}
}
};

可选插件

分享组件

module.exports = {
plugins:{
"share":{
"inputParams": {
"title": "default title",
"content": "default content",
"url": "default url",
"image": "default image url"
},
"config": {
"wechat_appKey": "",
"dingtalk_appKey": "",
"qq_appId": "",
"weibo_appKey": ""
}
}
}
};

注意事项:

  • 钉钉分享的AppKey必须与申请的bundleId匹配,否则会分享失败,其他平台无此限制
  • QQ分享使用的是AppId(10位纯数字),而不是AppKey(字母数字混合)
  • QQ分享的URL Schemes还可配”QQ”+十六进制的AppId,不足8位开头补0,如果两个都配会优先使用QQ而不是tencent

极光推送 && 个推 && 阿里云推送

module.exports = {
plugins:{
"push": {
"config": {
"jpush_appKey": "b061314719ab8463db7cc551", //极光推送平台的AppKey
//个推
"getui_appId":"NEPRD01fb18sS1z4muQ7aA",
"getui_appKey":"ht2JArqg686JFVc5DtE1b6",
"getui_appScrect":"RY1Adm4lTg5FgZfrzqYZB3",
//阿里云推送-IOS
"alipush_appKey_iOS":"25298013",
"alipush_appScrect_iOS":"bce53d52657eb231c679519095e35edb",
//阿里云推送-Android
"alipush_appKey_android": "25275247",
"alipush_appSecret_android":"4b7878faee0b31444eb023db401d52a9",
"mipush_appId":"2882303761517895607",
"mipush_appKey":"5791789545607"
}
}
}
};

极光推送网站
个推网站
阿里云推送网站

注意事项:

  • 默认情况下使用极光推送,如果 alipush_appKey_iOSgetui_appId 等字段和 jpush_appKey一起配置的情况下也是用的极光推送。阿里云key和个推的key只有单独配置的情况下才生效。
  • 如果只配个推key和阿里云key时,以阿里云推送为优先。
  • 【个推】由于个推不支持获取和删除标签,所以LightSDK.native.pushGetTagsLightSDK.native.pushDeleteTags接口会不生效。
  • 【个推】由于个推控台上没有提供添加apns自定义参数的功能,只能通过后端服务器对接个推后台才能实现该功能。因此light原有的点击通知跳转到应用内对应页面的功能(传入url字段,跳转页面功能)需要后台支持才能生效。
  • 【个推】iOS暂不支持多媒体推送功能。
  • 【阿里云推送】控台不支持设置别名和标签,需要后端服务器配合。
  • 【阿里云推送】不支持一次性删除全部标签功能,所以LightSDK.native.pushDeleteTags接口如果删除全部标签会不生效。
  • 【阿里云推送】小米必须要配置 mipush_appIdmipush_appKey 才能够支持彻底关闭应用后接收到推送信息。
  • 【阿里云推送】android版针对华为、小米手机做了额外处理,他们支持在应用彻底关闭(在recent中杀死清除应用)后,仍然可以接收到推送消息。其他品牌的手机只能支持到通过双击返回键退出后还能接收到消息。
  • 【阿里云推送】应用彻底关闭的情况下,服务器发送推送消息,小米基本在1分钟以内收到。华为需要5-15分钟的等待时间。

扫一扫

module.exports = {
plugins:{
"scanning":{
"inputParams": {
"title":"扫一扫"
},
"outputParam": [

],
"navigationbar": {
"show": true,
"left_item": {
},
"right_item": {
}
},
"menu": {
"show": false
},
"style": {

},
"config": {
}
}
}
};

手势指纹

module.exports = {
plugins:{
"lock": {
"inputParams": {
"title": "手势密码"
},
"navigationbar":{
"disableSystemBarTint":false,
"backgroundColor": "#e81f1f"
},
"style": {
"backgroundColor": "#000000",//背景色
"headerBackgroundColor": "#ffffff",
"headerTextColor": "#ffffff",
"hintTextColor": "#ffffff",//错误提示文字颜色
"defaultColor": "#ffffff",//手势未输入状态时默认颜色
"selectedColor": "#6D90FB",//已输入手势的颜色
"inCorrectColor": "#db5329",//手势输入有误后的颜色
"lineColor": "#6D90FB",//手势输入过程中连接的线的颜色
"lineWidth": 3//线的宽度
},
"config": {
"maxNumberOfRetries":3,//重试次数
"minNumberOfNodes":4,//最少连接的节点个数
"freezeTime":10,//超过重试次数后的锁定时间
"backgroundImage":"iconName"//自定义背景图片 iconName自定义,图片路径配置在plugins内
}
}
}
};

安全键盘

module.exports = {
plugins:{
"safekeyboard": {
"config": {
"textShow": "instantAsterisk",
"disorder": "none",
"pressEffect": "default",
"keyboardType": "alpha|number|symbol",
"maxLength": 16,
"encryptMode": "md5",
"titleText": "Hundsun SafeKeyboard"
}
}
}
};

登录组件

module.exports = {
plugins:{
"login": {
"inputParams": {
"title": "登录"
},
"navigationbar": {
"show": true
},
"menu": {
"show": false
},
"config": {
"loginUrl":"https://2i3ydhmhd.lightyy.com/index.html",
"mustForcedToLogin":true
}
}
}
};

支付

module.exports = {
plugins:{
"pay": {}
}
};

反馈组件

module.exports = {
plugins:{
"feedback": {
"inputParams": {
"title": "反馈新问题"
},
"navigationbar": {
"show": true
},
"menu": {
"show": false
},
"style": {
"nicknameTextColor" : "@textColor2",
"placeholderTextColor" : "@textColor3",
"queryChatBackgroundColor" : "#dedede",
"queryChatTextColor":"@textColor1",
"replyChatBackgroundColor" : "#f0dad2",
"replyChatTextColor":"@textColor1"
},
"config": {
"placeholder" : "感谢反馈,请写下你的问题或意见"
}
}

}
};

地图组件

module.exports = {
plugins:{
"jsnbaidumap":{},
"location":{
"config": {
"baidu_APIKey": "GViLdGaQF******PZR2wd",
"baidu_APIKey_iOS": "uEHT********agcacvMiEIsYgg",
"baidu_APIKey_Android": "a********OoSWlbGU2wD2PT"
}
}
}

}

注:使用时用标签map

该标签有2个方法relocate (重新定位)和getLocation (获取位置信息)
参考demohttps://r250t0dsj.lightyy.com/index.html#/index/mapComp

文件组件

module.exports = {
plugins:{
"file": {
"navigationbar": {
"show": true,
"immersiveMode": false
},
"config": {
"showShareButton":true
}
}

}
};

安全组件

module.exports = {
plugins:{
"appsecurity": {
"config":{
"backgroundBlur":true, //开启后台屏幕模糊后,应用进入后台后界面自动模糊,防止窥探。true开启模糊,false不开启(仅对iOS有效)
"antiHijack":true, //Android专用,防劫持加固功能,true打开防劫持,false关闭防劫持
"simulatorEnable":true, //禁止模拟器上运行加固功能,true允许在模拟器上运行,false不允许在模拟器上运行
"rootAlert":false //手机越狱(iOS)或root(Android)状态弹框提示功能,true提示,false不提示
}
}

}
};

悬浮球组件

module.exports = {
plugins:{
"assistivetouch": {
"config": {
"src": "assistivetouch_bg",
"waitingTime": 1000,
"alpha":0.1,
"height":100,
"width":100,
"margin": 20,
"onlyShowInMainPage":true,
"action": "gmu://web?startPage=https://www.lightyy.com"
}
}

}
};

配置参数说明

字段 可选 类型及范围 说明
src string 浮动按钮背景图片,支持base64和资源路径(路径暂时只支持读取gmu_icon目录下图片)两种方式
action string 浮动按钮点击事件的响应操作,目前仅支持标准gmu协议的URL(例:gmu://web?startPage=https://www.lightyy.com)
waitingTime number 进入睡眠状态的等待时长(用户对浮动按钮无操作多长时间后会进入睡眠状态,单位ms,默认值为5000ms)
alpha number 睡眠状态时浮动按钮透明度(支持范围0 ~ 1.0),默认值为0.5
height number 浮动按钮显示高度(背景图片按照指定宽高值固定比例缩放),默认值为60
width number 浮动按钮显示宽度(背景图片按照指定宽高值固定比例缩放),默认值为60
margin number 浮动按钮吸附到屏幕边缘时的边距,默认值为18
onlyShowInMainPage bool 浮动按钮是否只在首页显示,进入二级页面即隐藏,默认为false