m8-framework-mcp 1.0.0

package/docs/ejs-doc/api_device/api_device.md

@@ -0,0 +1,761 @@
+# ejs.device
+
+## setOrientation
+
+设置屏幕方向
+
+**平台差异**
+
+| ejs（H5 应用) | ejs（新点小程序） |   H5   | 钉钉   | 微信小程序 | 支付宝小程序 |
+| :------------ | :---------------: | :----: | :----- | :--------- | :----------- |
+| 支持          |       支持        | 不支持 | 不支持 | 不支持     | 不支持       |
+
+**使用示例**
+
+```js
+ejs.device.setOrientation({
+    orientation: 1,
+    success: function (result) {},
+    error: function (error) {}
+});
+```
+
+**参数说明**
+
+| 参数        |    参数类型     | 说明                                                                        |
+| :---------- | :-------------: | :-------------------------------------------------------------------------- |
+| orientation | Number / String | `必填`，屏幕方向，`1`表示竖屏，`0`表示横屏，其他表示跟随系统,`-1`为跟随系统 |
+
+**注**
+
+微信小程序基础库版本 2.4.0 开始，支持通过 `pageOrientation` 字段设置屏幕旋转，具体可看官方文档：[响应显示区域变化](https://developers.weixin.qq.com/miniprogram/dev/framework/view/resizable.html)。
+
+## setZoomControl
+
+设置页面的缩放控件，仅在`Android`中生效
+
+**平台差异**
+
+| ejs（H5 应用) |        ejs（新点小程序）        |   H5   | 钉钉   | 微信小程序 | 支付宝小程序 |
+| :------------ | :-----------------------------: | :----: | :----- | :--------- | :----------- |
+| 支持          | 支持<br>（ejs-weex 环境不支持） | 不支持 | 不支持 | 不支持     | 不支持       |
+
+**使用示例**
+
+```js
+ejs.device.setZoomControl({
+    isShow: 1,
+    success: function (result) {},
+    error: function (error) {}
+});
+```
+
+**参数说明**
+
+| 参数   |    参数类型     | 说明                                                                                                                      |
+| :----- | :-------------: | :------------------------------------------------------------------------------------------------------------------------ |
+| isShow | Number / String | 是否显示页面的缩放控件，`1`为显示，`0`为隐藏，默认为`0`，一般配合页面的`meta`标签使用，需要`meta`开启缩放后，才会显示控件 |
+
+## setBounce
+
+设置页面是否回弹，仅在`iOS中`生效
+
+注意：`iOS`版本`16.0`至`16.1`, 由于系统 bug，该 API 不生效
+
+**平台差异**
+
+| ejs（H5 应用) | ejs（新点小程序） |   H5   | 钉钉   | 微信小程序 | 支付宝小程序 |
+| :------------ | :---------------: | :----: | :----- | :--------- | :----------- |
+| 支持          |      不支持       | 不支持 | 不支持 | 不支持     | 不支持       |
+
+**使用示例**
+
+```js
+ejs.device.setBounce({
+    isEnable: 1,
+    success: function (result) {},
+    error: function (error) {}
+});
+```
+
+**参数说明**
+
+| 参数     |    参数类型     | 说明                                 |
+| :------- | :-------------: | :----------------------------------- |
+| isEnable | Number / String | 默认为`1`代表开启，为`0`时会关闭回弹 |
+
+## getDeviceId
+
+获取设备 ID
+
+**平台差异**
+
+| ejs（H5 应用) | ejs（新点小程序） |      H5      | 钉钉 | 微信小程序 | 支付宝小程序 |
+| :------------ | :---------------: | :----------: | :--- | :--------- | :----------- |
+| 支持          |       支持        | 跨端框架支持 | 支持 | 支持       | 支持         |
+
+**使用示例**
+
+```js
+ejs.device.getDeviceId({
+    success: function (result) {
+        /**
+         * {
+                deviceId: ''
+           }
+         */
+    },
+    error: function (error) {}
+});
+```
+
+**返回说明**
+
+| 参数      | 参数类型 | 说明                                                                                      |
+| :-------- | :------: | :---------------------------------------------------------------------------------------- |
+| deviceId  |  String  | 对应的设备 ID。在 非 ejs 环境下，由 uni-app 框架生成并存储，清空 Storage 会导致该 id 改变 |
+| uniparams |  Object  | 在非 ejs 环境下，会额外返回 uniAPI 返回的参数                                             |
+
+### ejs-Android 设备 ID 生成原理：
+
+在设备首次启动时，安卓系统会生成一个 64 位的数字（Android 8.0 及以上由系统根据应用签名密钥、用户、设备信息生成；Android 8.0 以下是由系统随机生成），并把这个数字以十六进制字符串的形式保存下来作为设备 ID，设备恢复出厂设置或重装手机系统或者 APK 签名密钥发生更改导致设备 ID 发生变化。
+
+### ejs-iOS 设备 ID 生成原理：
+
+App 首次安装会自动生成 UUID，并保存至系统钥匙串中，系统钥匙串和 App 包名绑定，设备恢复出厂设置或重装手机系统后会发生改变。
+
+## getMacAddress
+
+获取设备 Mac 地址
+
+注，仅 Android 中能用
+
+**平台差异**
+
+| ejs（H5 应用) | ejs（新点小程序） |   H5   | 钉钉   | 微信小程序 | 支付宝小程序 |
+| :------------ | :---------------: | :----: | :----- | :--------- | :----------- |
+| 支持          |       支持        | 不支持 | 不支持 | 不支持     | 不支持       |
+
+**使用示例**
+
+```js
+ejs.device.getMacAddress({
+    success: function (result) {
+        /**
+         * {
+                macAddress: ''
+           }
+         */
+    },
+    error: function (error) {}
+});
+```
+
+**返回说明**
+
+| 参数       | 参数类型 | 说明            |
+| :--------- | :------: | :-------------- |
+| macAddress |  String  | 对应的 mac 地址 |
+
+## getScreenInfo
+
+获取屏幕像素信息
+
+**平台差异**
+
+| ejs（H5 应用) | ejs（新点小程序） |   H5   | 钉钉   | 微信小程序 | 支付宝小程序 |
+| :------------ | :---------------: | :----: | :----- | :--------- | :----------- |
+| 支持          |       支持        | 不支持 | 不支持 | 不支持     | 不支持       |
+
+**使用示例**
+
+```js
+ejs.device.getScreenInfo({
+    success: function (result) {
+        /**
+         * {
+                pixel: '1080*1920'
+           }
+         */
+    },
+    error: function (error) {}
+});
+```
+
+**返回说明**
+
+| 参数  | 参数类型 | 说明                          |
+| :---- | :------: | :---------------------------- |
+| pixel |  String  | 屏幕的像素信息，宽高以`*`分隔 |
+
+## getNetWorkInfo
+
+获取网络状态
+
+**平台差异**
+
+| ejs（H5 应用) | ejs（新点小程序） |      H5      | 钉钉 | 微信小程序 | 支付宝小程序 |
+| :------------ | :---------------: | :----------: | :--- | :--------- | :----------- |
+| 支持          |       支持        | 跨端框架支持 | 支持 | 支持       | 支持         |
+
+**使用示例**
+
+```js
+ejs.device.getNetWorkInfo({
+    success: function (result) {
+        /**
+         * {
+                netWorkType: 1,
+                ip: 192.168.1.1
+           }
+         */
+    },
+    error: function (error) {}
+});
+```
+
+**返回说明**
+
+| 参数        |    参数类型     | 说明                                                    |
+| :---------- | :-------------: | :------------------------------------------------------ |
+| netWorkType | Number / String | 网络状态，`1`代表`wifi`,`0`代表移动网络，`-1`代表无网络 |
+| ip          |     String      | 当前设备 ip, 仅 ejs 及钉钉平台支持                      |
+| uniparams   |     Object      | 在 非 ejs 环境下，会额外返回 uniAPI 返回的参数          |
+
+## getVendorInfo
+
+获取设备厂商信息
+
+同时将设备其它信息也一起返回
+
+**平台差异**
+
+| ejs（H5 应用) | ejs（新点小程序） |      H5      | 钉钉         | 微信小程序 | 支付宝小程序 |
+| :------------ | :---------------: | :----------: | :----------- | :--------- | :----------- |
+| 支持          |       支持        | 跨端框架支持 | 跨端框架支持 | 支持       | 支持         |
+
+**使用示例**
+
+```js
+ejs.device.getVendorInfo({
+    success: function (result) {
+        /**
+         * {
+                netWorkType: 'xxx',
+                deviceId: 'xxx',
+                pixel: '1080*1920',
+                uaInfo: 'android HUAWEI VTR-AL00'
+           }
+         */
+    },
+    error: function (error) {}
+});
+```
+
+**返回说明**
+
+| 参数        |    参数类型     | 说明                                             |
+| :---------- | :-------------: | :----------------------------------------------- |
+| netWorkType | Number / String | 网络状态，`1`代表`wifi`                          |
+| deviceId    |     String      | 对应的设备唯一 ID                                |
+| pixel       |     String      | 屏幕的像素信息，宽高以`*`分隔，非 ejs 环境不支持 |
+| uaInfo      |     String      | 厂商信息，非 ejs 或 h5 环境不支持                |
+| uniparams   |     Object      | 在非 ejs 环境下，会额外返回 uniAPI 返回的参数    |
+
+## isTablet
+
+判断设备是否是平板
+
+**平台差异**
+
+| ejs（H5 应用) | ejs（新点小程序） |   H5   | 钉钉   | 微信小程序 | 支付宝小程序 |
+| :------------ | :---------------: | :----: | :----- | :--------- | :----------- |
+| 支持          |       支持        | 不支持 | 不支持 | 支持       | 支持         |
+
+**使用示例**
+
+```js
+ejs.device.isTablet({
+    success: function (result) {
+        /**
+         * {
+                isTablet: 0
+           }
+         */
+    },
+    error: function (error) {}
+});
+```
+
+**返回说明**
+
+| 参数     |    参数类型     | 说明                       |
+| :------- | :-------------: | :------------------------- |
+| isTablet | Number / String | `0`代表非平板，`1`代表平板 |
+
+## callPhone
+
+拨打电话
+
+**平台差异**
+
+| ejs（H5 应用) | ejs（新点小程序） |  H5  | 钉钉   | 微信小程序 | 支付宝小程序 |
+| :------------ | :---------------: | :--: | :----- | :--------- | :----------- |
+| 支持          |       支持        | 支持 | 不支持 | 支持       | 支持         |
+
+**使用示例**
+
+```js
+ejs.device.callPhone({
+    phoneNum: '182xxxxxxxx',
+    success: function (result) {},
+    error: function (error) {}
+});
+
+// 兼容快速调用
+ejs.device.callPhone('182xxxxxxxx');
+```
+
+**参数说明**
+
+| 参数     |    参数类型     | 说明               |
+| :------- | :-------------: | :----------------- |
+| phoneNum | Number / String | 需要拨打的电话号码 |
+
+## sendMsg
+
+发送短信
+
+**平台差异**
+
+| ejs（H5 应用) | ejs（新点小程序） |  H5  | 钉钉   | 微信小程序 | 支付宝小程序 |
+| :------------ | :---------------: | :--: | :----- | :--------- | :----------- |
+| 支持          |       支持        | 支持 | 不支持 | 不支持     | 不支持       |
+
+**使用示例**
+
+```js
+ejs.device.sendMsg({
+    phoneNum: '182xxxxxxxx',
+    message: 'hello',
+    success: function (result) {},
+    error: function (error) {}
+});
+
+// 兼容快速调用
+ejs.device.sendMsg('182xxxxxxxx', 'hello');
+```
+
+**参数说明**
+
+| 参数     |    参数类型     | 说明           |
+| :------- | :-------------: | :------------- |
+| phoneNum | Number / String | 目标的电话号码 |
+| message  |     String      | 短信内容       |
+
+## sendTo
+
+发送给其他 app、系统分享功能
+
+**平台差异**
+
+| ejs（H5 应用) | ejs（新点小程序） |   H5   | 钉钉   | 微信小程序 | 支付宝小程序 |
+| :------------ | :---------------: | :----: | :----- | :--------- | :----------- |
+| 支持          |       支持        | 不支持 | 不支持 | 不支持     | 不支持       |
+
+**使用示例**
+
+```js
+ejs.device.sendTo({
+    title: '测试标题',
+    url: 'http://www.liantu.com/',
+    imgBase64: '',
+    imgURL: '',
+    sdPath: '',
+    success: function (result) {},
+    error: function (error) {}
+});
+```
+
+**参数说明**
+
+| 参数      | 参数类型 | 说明                   |
+| :-------- | :------: | :--------------------- |
+| title     |  String  | 标题                   |
+| url       |  String  | 链接的 url             |
+| imgBase64 |  String  | 图片的 base64          |
+| imgURL    |  String  | 图片的 URL 地址        |
+| sdPath    |  String  | 图片在 SD 卡内部的路径 |
+
+一般图片三种方式选一种即可
+
+**注意**
+
+在不同平台，分享的调用方式和逻辑有较大差异。
+
+1. 小程序：不支持 API 调用，只能用户主动点击触发分享。可使用自定义按钮方式 `<button open-type="share">` 或监听系统右上角的分享按钮 `onShareAppMessage` 进行自定义分享内容。
+
+2. H5：如果是普通浏览器，浏览器自带分享按钮；如果是在微信内嵌浏览器中，可调用 js-sdk 进行分享，[参考](https://ask.dcloud.net.cn/article/35380)。
+
+## closeInputKeyboard
+
+关闭输入法软键盘，如果已经打开，则关闭
+
+**平台差异**
+
+| ejs（H5 应用) | ejs（新点小程序） |      H5      | 钉钉   | 微信小程序 | 支付宝小程序 |
+| :------------ | :---------------: | :----------: | :----- | :--------- | :----------- |
+| 支持          |       支持        | 跨端框架支持 | 不支持 | 支持       | 支持         |
+
+**使用示例**
+
+```js
+ejs.device.closeInputKeyboard({
+    success: function (result) {},
+    error: function (error) {}
+});
+```
+
+## vibrate
+
+调用原生的震动功能
+
+**平台差异**
+
+| ejs（H5 应用) | ejs（新点小程序） |   H5   | 钉钉 | 微信小程序 | 支付宝小程序 |
+| :------------ | :---------------: | :----: | :--- | :--------- | :----------- |
+| 支持          |       支持        | 不支持 | 支持 | 不支持     | 支持         |
+
+**使用示例**
+
+```js
+ejs.device.vibrate({
+    duration: 200,
+    success: function (result) {},
+    error: function (error) {}
+});
+
+// 支持快速调用
+ejs.device.vibrate(200);
+```
+
+**参数说明**
+
+| 参数     |    参数类型     | 说明                                                                                                         |
+| :------- | :-------------: | :----------------------------------------------------------------------------------------------------------- |
+| duration | Number / String | 只在`Android`中有用，`iOS`中请忽略，震动的持续时间，单位是毫秒，默认是`200`，该参数仅在 ejs 和钉钉环境中有效 |
+
+## shake.enable
+
+开启原生摇一摇功能
+
+**平台差异**
+
+| ejs（H5 应用) | ejs（新点小程序） |      H5      | 钉钉   | 微信小程序 | 支付宝小程序 |
+| :------------ | :---------------: | :----------: | :----- | :--------- | :----------- |
+| 支持          |       支持        | 跨端框架支持 | 不支持 | 支持       | 支持         |
+
+**使用示例**
+
+```js
+ejs.device.shake.enable({
+    success: function (result) {
+        /*
+         * 开启后，原生每次摇一摇成功都会进入回调
+         */
+    },
+    error: function (error) {}
+});
+```
+
+## shake.disable
+
+关闭原生摇一摇功能
+
+**平台差异**
+
+| ejs（H5 应用) | ejs（新点小程序） |      H5      | 钉钉   | 微信小程序 | 支付宝小程序 |
+| :------------ | :---------------: | :----------: | :----- | :--------- | :----------- |
+| 支持          |       支持        | 跨端框架支持 | 不支持 | 支持       | 支持         |
+
+**使用示例**
+
+```js
+ejs.device.shake.disable({
+    success: function (result) {},
+    error: function (error) {}
+});
+```
+
+## checkPermissions
+
+检查权限是否存在
+
+**平台差异**
+
+| ejs（H5 应用) | ejs（新点小程序） |   H5   | 钉钉   | 微信小程序 | 支付宝小程序 |
+| :------------ | :---------------: | :----: | :----- | :--------- | :----------- |
+| 支持(3.1.5)   |    支持(3.1.5)    | 不支持 | 不支持 | 不支持     | 不支持       |
+
+**使用示例**
+
+```js
+ejs.device.checkPermissions({
+    permissionsType: 0,
+    success: function (result) {
+        /**
+         * {
+                permissionGranted: 1
+           }
+         */
+    },
+    error: function (error) {}
+});
+```
+
+**权限类别**
+
+| 值  | 对应权限             |
+| :-- | :------------------- |
+| `0` | location（定位）     |
+| `1` | storage（存储）      |
+| `2` | phone（电话）        |
+| `3` | camera（拍照）       |
+| `4` | sms（短信）          |
+| `5` | contacts（通讯录）   |
+| `6` | microphone（麦克风） |
+
+**参数说明**
+
+| 参数            |    参数类型     | 说明                                  |
+| :-------------- | :-------------: | :------------------------------------ |
+| permissionsType | Number / String | 权限类别，默认为`0`，详情见权限类别表 |
+
+**返回说明**
+
+| 参数              |    参数类型     | 说明                                 |
+| :---------------- | :-------------: | :----------------------------------- |
+| permissionGranted | Number / String | 是否有权限，`1`为有权限，`0`为无权限 |
+
+## requestPermissions
+
+申请特定权限
+
+**平台差异**
+
+| ejs（H5 应用) | ejs（新点小程序） |   H5   | 钉钉   | 微信小程序 | 支付宝小程序 |
+| :------------ | :---------------: | :----: | :----- | :--------- | :----------- |
+| 支持(3.1.5)   |    支持(3.1.5)    | 不支持 | 不支持 | 支持       | 不支持       |
+
+**使用示例**
+
+```js
+ejs.device.requestPermissions({
+    permissionsType: 0,
+    success: function (result) {
+        /**
+         * {
+                resultData: 0
+           }
+         */
+    },
+    error: function (error) {}
+});
+```
+
+**权限类别**
+
+| 值  | 对应权限                             |
+| :-- | :----------------------------------- |
+| `0` | location（定位）                     |
+| `1` | storage（存储），微信小程序不支持    |
+| `2` | phone（电话），微信小程序不支持      |
+| `3` | camera（拍照）                       |
+| `4` | sms（短信），微信小程序不支持        |
+| `5` | contacts（通讯录），微信小程序不支持 |
+| `6` | microphone（麦克风）                 |
+
+**注意**
+
+微信小程序端查询定位权限需要在 `manifest.json` 配置 `permission`字段：
+
+```json
+{
+    "name": "",
+    "appid": "",
+    "mp-weixin": {
+        "permission": {
+            "scope.userLocation": {
+                "desc": "你的位置信息将用于小程序位置接口的效果展示"
+            }
+        }
+    }
+}
+```
+
+**参数说明**
+
+| 参数            |    参数类型     | 说明                                  |
+| :-------------- | :-------------: | :------------------------------------ |
+| permissionsType | Number / String | 权限类别，默认为`0`，详情见权限类别表 |
+
+**返回说明**
+
+| 参数       |    参数类型     | 说明                                                                                                                                                                        |
+| :--------- | :-------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| resultData | Number / String | 申请权限的结果，`0`为申请权限时点了允许，`1`为申请权限时点了拒绝，`2`为由于以前申请权限时点了拒绝并选择不再提示，所以默认拒绝（仅 ejs 环境下支持，非 ejs 环境默认不再提示） |
+
+## beep
+
+调用原生的蜂鸣功能
+
+**平台差异**
+
+| ejs（H5 应用) | ejs（新点小程序） |   H5   | 钉钉   | 微信小程序 | 支付宝小程序 |
+| :------------ | :---------------: | :----: | :----- | :--------- | :----------- |
+| 支持(3.4.0)   |    支持(3.4.0)    | 不支持 | 不支持 | 不支持     | 不支持       |
+
+**使用示例**
+
+```js
+ejs.device.beep({
+    success: function (result) {},
+    error: function (error) {}
+});
+```
+
+## goAppSetting
+
+跳转至应用的权限设置界面
+
+**平台差异**
+
+| ejs（H5 应用) | ejs（新点小程序） |   H5   | 钉钉   | 微信小程序 | 支付宝小程序 |
+| :------------ | :---------------: | :----: | :----- | :--------- | :----------- |
+| 支持(3.4.0)   |    支持(3.4.0)    | 不支持 | 不支持 | 支持       | 支持         |
+
+**使用示例**
+
+```js
+ejs.device.goAppSetting({
+    success: function (result) {},
+    error: function (error) {}
+});
+```
+
+**返回说明**
+
+| 参数        | 参数类型 | 说明                                                                                                            |
+| :---------- | :------: | :-------------------------------------------------------------------------------------------------------------- |
+| authSetting |  Object  | 用户授权结果，其中 key 为 scope 值，value 为 Boolean 值，表示用户是否允许授权，仅其他厂商小程序平台会返回该参数 |
+
+**scope 列表**
+
+| scope                        |     描述     | 平台差异说明     |
+| :--------------------------- | :----------: | :--------------- |
+| scope.userInfo               |   用户信息   |                  |
+| scope.userLocation           |   地理位置   |                  |
+| scope.userLocationBackground |   后台定位   | 仅微信小程序支持 |
+| scope.address                |   通信地址   |                  |
+| scope.record                 |   录音功能   |                  |
+| scope.writePhotosAlbum       |  保存到相册  |                  |
+| scope.camera                 |    摄像头    |                  |
+| scope.invoice                |   获取发票   | 仅微信小程序支持 |
+| scope.invoiceTitle           |   发票抬头   | 仅微信小程序支持 |
+| scope.werun                  | 微信运动步数 | 仅微信小程序支持 |
+
+## setEnableShot
+
+设置是否允许系统截屏，仅在`Android`中生效
+
+**平台差异**
+
+| ejs（H5 应用) | ejs（新点小程序） |   H5   | 钉钉   | 微信小程序 | 支付宝小程序 |
+| :------------ | :---------------: | :----: | :----- | :--------- | :----------- |
+| 支持(3.4.0)   |    支持(3.4.0)    | 不支持 | 不支持 | 支持       | 支持         |
+
+**使用示例**
+
+```js
+ejs.device.setEnableShot({
+    isEnableShot: 0,
+    success: function (result) {},
+    error: function (error) {}
+});
+```
+
+**参数说明**
+
+| 参数         |    参数类型     | 说明                                       |
+| :----------- | :-------------: | :----------------------------------------- |
+| isEnableShot | Number / String | 是否允许系统截屏，默认`0`不允许，`1`为允许 |
+
+## getDeviceInfo
+
+获取系统信息：包含设备 OS 类型、设备版本、设备名称
+
+**平台差异**
+
+| ejs（H5 应用) | ejs（新点小程序） |      H5      | 钉钉         | 微信小程序 | 支付宝小程序 |
+| :------------ | :---------------: | :----------: | :----------- | :--------- | :----------- |
+| 支持(3.4.2)   |    支持(3.4.2)    | 跨端框架支持 | 跨端框架支持 | 支持       | 支持         |
+
+**使用示例**
+
+```js
+ejs.device.getDeviceInfo({
+    success: function (result) {},
+    error: function (error) {}
+});
+```
+
+**返回说明**
+
+| 参数            |    参数类型     | 说明                                                                                 |
+| :-------------- | :-------------: | :----------------------------------------------------------------------------------- |
+| deviceName      |     String      | 设备名称，非 ejs 环境不支持                                                          |
+| osType          |     String      | 设备平台类型，可选值：iOS、android                                                   |
+| osVersion       |     String      | 系统版本                                                                             |
+| deviceID        |     String      | deviceID, 在 非 ejs 环境下，由 uni-app 框架生成并存储，清空 Storage 会导致该 id 改变 |
+| statusBarHeight | Number / String | 原生顶部状态栏高度                                                                   |
+| uniparams       |     Object      | 在 非 ejs 环境下，会额外返回 uniAPI 返回的参数                                       |
+
+## isHasVirtualPosApp
+
+检测手机上是否安装虚拟定位软件（仅 Andriod）
+
+**平台差异**
+
+| ejs（H5 应用) | ejs（新点小程序） |   H5   | 钉钉   | 微信小程序 | 支付宝小程序 |
+| :------------ | :---------------: | :----: | :----- | :--------- | :----------- |
+| 支持(4.0.0)   |    支持(4.0.0)    | 不支持 | 不支持 | 不支持     | 不支持       |
+
+**使用示例**
+
+```js
+ejs.device.isHasVirtualPosApp({
+    success: function (result) {
+        /**
+         *   未安装，安全：
+         *   {
+         *       result: '1'
+         *   }
+         *   安装了，不安全：
+         *   {
+         *       result: '0',
+         *       appname: '应用名称',
+         *       packagename: '包名'
+         *   }
+         */
+    },
+    error: function (error) {}
+});
+```
+
+**返回说明**
+
+| 参数        | 参数类型 | 说明                                   |
+| :---------- | :------: | :------------------------------------- |
+| result      |  String  | '1'：未安装，安全，'0'：安装了，不安全 |
+| appname     |  String  | 应用名称，不安全时返回                 |
+| packagename |  String  | 包名，不安全时返回                     |