客户端开发说明
轻应用是APP NEST为企业打造的移动办公入口,通过轻应用可以将企业的业务审批、内部系统、生成、协作、管理、上下游沟通以轻应用形式发布到APP NEST的门户客户端,更简单和低成本实现企业移动化; 结合APP NEST门户客户端的基础通信能力,让企业应用更活跃,员工更高效,移动化成本更低。
而客户端开发说明将为轻应用提供调用原生控件的能力,带给轻应用接近原生代码的体验。
1. 开发工具说明
APP NEST产品提供了开发工具方便开发者开发基于APP NEST的轻应用,如果对接口调用参数有疑问,请使用调试工具。
开发工具中创建工程后,生成的项目工程中自动引入JS文件,JS文件中引入了APP NEST所提供的各类接口,可供客户端开发人员快速调用。详细接口说明见下面章节:
2. 电池信息
描述:获取现在的电池状态,是否充电以及当前电量0.00-1.0
方法:getBatteryinfo()
参数:无
返回值:
isPlugged: 是否处于充电状态true/false
level:当前电量
3. 设备IMEI
描述:获取设备IMEI
方法:getDeviceImei()
参数:无
返回值:设备IMEI号
4. 系统版本
描述:获取设备系统版本
方法:getDeviceSysVersion()
参数:无
返回值:系统版本
5. 设备名称
描述:获取设备名称
方法:getDeviceModelName()
参数:无
返回值:设备名称
6. 设备分辨率
描述:获取设备分辨率
方法:getDeviceScreenSize()
参数:无
返回值:
heightPixels:高度(px)
widthPixels:宽度(px)
7. 地理位置
描述:获取当前地理位置
方法:getGeolocation()
参数:无
返回值:
latitude:纬度
longitude: 经度
radius:半径范围
time:地位日期及时间
8. 网络状态
描述:获取当前网络类型
方法:getConnection()
参数:无
返回值:返回网络状态码
9. 扫码
描述:扫描二维码或一维码
方法:startCaptureQRCode()
参数:codeType :number扫描对象类型。取值 0、1
返回值:会自动根据当前二维码的动作信息,进行处理。门户内人员的二维码信息会自动打开门户内的人员信息。URL类二维码会打开浏览器。
10.客户端类型
描述:判断客户端类型
方法:NS_RMADPlugin.checkOSForIOS
参数:无
返回值:返回布尔值,true为IOS,false为android
11. 网络请求POST
描述:发送网络请求POST
方法:sendRequestByPost(sendparams_post, bodyJson_post);
参数:
sendparams_post,sendparams_get object 类型 包含以下参数:
Interface 调用meap接口名(string)
method 调用meap方法名(string)
group 调用 meap服务组名 (string)
isCompres 传输报文是否压缩true/false (string)
isSalt 传输是否加需要签名较验true/false (string)
encryptionType 加密类型—–01:无加密 / 02:3des / 03:rsa (string)
Ishttps 是否是https请求—-01:http 02:单向https 03:双向https (string)
bodyJson_get object 类型
返回值:返回请求内容
示例代码:
var sendparams_post = {
"Interface": "com.nqsky.meap.api.sso.service.ISsoAPIService",
"method": "login",
"group": "",
"isCompres": "",
"isSalt": "",
"encryptionType": "",
"Ishttps": ""
};
var bodyJson_post = {
"userName": "wangpanfeng",
"password": "11111111",
"agencyCode": "001"
};
function sendRequestByPost(sendparams_post, bodyJson_post) {
NS_RMADPlugin.LocalRuntime.NetworkRequest.post(sendparams_post, bodyJson_post, function(msg) {
alert('success:' + msg);
}, function(msg) {
alert('failure:' + msg);
});
}
12. 网络请求GET
描述:发送网络请求GET
方法:sendRequestByGet(sendparams_get, bodyJson_get)
参数:
sendparams_post,sendparams_get object 类型 包含以下参数:
Interface 调用meap接口名(string)
method 调用meap方法名(string)
group 调用 meap服务组名 (string)
isCompres 传输报文是否压缩true/false (string)
isSalt 传输是否加需要签名较验true/false (string)
encryptionType 加密类型—–01:无加密 / 02:3des / 03:rsa (string)
Ishttps 是否是https请求—-01:http 02:单向https 03:双向https (string)
bodyJson_get object 类型
返回值:返回请求内容
13. 选人
描述:获取指定ID人员的信息
方法:getUserInfoById(id)
参数:id string 人员的ID
返回值:返回人员信息JSON
14. 获取部门信息
描述:获取指定ID部门的信息
方法:getDepartmentById(id)
参数:id string 部门的ID
返回值:返回部门信息JSON
15. 用户信息
描述:获取当前登录用户的信息
方法:getUserInfo()
参数:无
返回值:返回用户信息JSON
16. 设置title背景色
描述:设置title背景色
方法:setTitleBG(color)
参数:color string类型 #000000-#FFFFFF
返回值:无
17. 设置tilte内容
描述:设置tilte内容
方法:setTitleContent(content)
参数:content string类型 Title内容
返回值:无
18. 设置title字体颜色
描述:设置title字体颜色
方法:setTitleColor(color)
参数:color string类型 #000000-#FFFFFF
返回值:无
19. 设置导航栏右侧按钮
描述:设置导航栏右侧单个或多个按钮
方法:setMoreMenu(moreObj)
参数:
method registerHandler 注册的方法名,当设置items子菜单时此方法不起作用,传空字符串即可 string类型
name 自定义 按钮名称 string
visible 更多按钮 是否可见
items 更多按钮 子菜单 Array Object
返回值:无
20. 单点认证
方法:getSSOTicket
参数:无
返回值:返回SSOTicket JSON
21. 从组织架构选择部门
方法:chooseDepartment
参数:无
返回值: 返回部门信息JSON
22. 从组织架构选择人员
方法:chooseStaff
参数:无
返回值:返回人员信息JSON
23. 从常用联系人选择人员
方法:chooseFrequentContact
参数:无
返回值:返回常用联系人信息JSON