npm - m8-framework-mcp - Versions diffs - 1.0.0 → 1.0.1 - Mend

m8-framework-mcp 1.0.0 → 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (388) hide show

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

@@ -1,761 +0,0 @@
-# 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  | 包名，不安全时返回                     |