客户端开发说明

轻应用是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