tmui-cli 2.0.2 → 2.0.4

package/data/uni-app-x-docs/api/capture-screen.md

@@ -0,0 +1,55 @@
+## uni.onUserCaptureScreen(callback?) @onusercapturescreen
+
+<!-- UTSAPIJSON.onUserCaptureScreen.description -->
+
+<!-- UTSAPIJSON.onUserCaptureScreen.compatibility -->
+
+<!-- UTSAPIJSON.onUserCaptureScreen.param -->
+
+<!-- UTSAPIJSON.onUserCaptureScreen.returnValue -->
+
+<!-- UTSAPIJSON.onUserCaptureScreen.tutorial -->
+
+## uni.offUserCaptureScreen(callback?) @offusercapturescreen
+
+<!-- UTSAPIJSON.offUserCaptureScreen.description -->
+
+<!-- UTSAPIJSON.offUserCaptureScreen.compatibility -->
+
+<!-- UTSAPIJSON.offUserCaptureScreen.param -->
+
+<!-- UTSAPIJSON.offUserCaptureScreen.returnValue -->
+
+<!-- UTSAPIJSON.offUserCaptureScreen.tutorial -->
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->
+
+
+## uni.setUserCaptureScreen(options) @setusercapturescreen
+
+<!-- UTSAPIJSON.setUserCaptureScreen.description -->
+
+<!-- UTSAPIJSON.setUserCaptureScreen.compatibility -->
+
+<!-- UTSAPIJSON.setUserCaptureScreen.param -->
+
+<!-- UTSAPIJSON.setUserCaptureScreen.returnValue -->
+
+<!-- UTSAPIJSON.setUserCaptureScreen.example -->
+
+<!-- UTSAPIJSON.setUserCaptureScreen.tutorial -->
+
+<!-- UTSAPIJSON.captureScreen.example -->
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->
+
+## tips
+- 本文的截屏指手机自带的截屏事件的监听和取消监听，由用户操作手机按键触发。App平台如需通过代码对view截屏，另见API [takeSnapshot](../dom/unielement.md#takesnapshot)
+- iOS平台该API在iOS 13.0及以上系统支持,在iOS 13.0以下系统调用该API会返回12001:system not support的错误。
+- 因iOS 15.1系统bug，在该系统上调用此API会返回12010:system internal error的错误。
+- Android平台在某些页面暂不支持（如：图片选择等页面以及App原生插件内部原生页面）。
+- `HarmonyOS` 平台使用时需要添加受限开放权限 [ohos.permission.PRIVACY_WINDOW](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/restricted-permissions-V5#section498771912414?ha_source=Dcloud&ha_sourceId=89000448)

package/data/uni-app-x-docs/api/capturescreen.md

@@ -0,0 +1,5 @@
+---
+layout: SimpleLayout
+---
+
+文档已迁移，请前往[captureScreen](capture-screen.md)查看最新文档

package/data/uni-app-x-docs/api/choose-file.md

@@ -0,0 +1,27 @@
+<!-- ## uni.chooseFile(options) @choosefile -->
+
+<!-- UTSAPIJSON.chooseFile.name -->
+
+<!-- UTSAPIJSON.chooseFile.description -->
+
+<!-- UTSAPIJSON.chooseFile.compatibility -->
+
+<!-- UTSAPIJSON.chooseFile.param -->
+
+<!-- UTSAPIJSON.chooseFile.returnValue -->
+
+Android端返回的路径是content协议。
+
+<!-- UTSAPIJSON.chooseFile.example -->
+
+<!-- UTSAPIJSON.chooseFile.tutorial -->
+
+
+## tips
+- chooseFile是系统UI，其风格不同rom可能有差异。多选时有的是长按、有的是checkbox。系统UI的暗黑模式、国际化跟随系统，而不跟随App。
+- chooseFile不仅仅是选择现有文件，有的手机也可以新拍照、拍摄、录音。但不同系统的实现存在差异。
+- 微信小程序端调用的是 [wx.chooseMessageFile](https://developers.weixin.qq.com/miniprogram/dev/api/media/image/wx.chooseMessageFile.html)，从客户端会话选择文件
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->

package/data/uni-app-x-docs/api/choose-image.md

@@ -0,0 +1,40 @@
+<!-- ## uni.chooseImage(options) @chooseimage -->
+
+<!-- UTSAPIJSON.chooseImage.name -->
+
+<!-- UTSAPIJSON.chooseImage.description -->
+
+<!-- UTSAPIJSON.chooseImage.compatibility -->
+
+<!-- UTSAPIJSON.chooseImage.param -->
+
+<!-- UTSAPIJSON.chooseImage.returnValue -->
+
+<!-- UTSAPIJSON.chooseImage.tutorial -->
+
+<!-- UTSAPIJSON.chooseImage.example -->
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->
+
+## 相册选择的2种方式
+App平台的相册选择，有custom自定义方式和system系统方式。这2种方式有不少区别：
+- custom方式
+1. app读取相册文件，所以app需要申请相册/本地文件访问权限。而google play目前仅对合理需要相册权限的应用才开放相册权限。如无法向google证明获取相册权限的合理性，则需要使用system方式。google play 政策详见：[google play 照片和视频权限](https://support.google.com/googleplay/android-developer/answer/14115180)，使用custom方式在上架google play时需要提交一份声明以获得试用的资格。uni-app x的开发者可升级HBuilderX 4.41后使用system方式，而uni-app的开发者遇到此问题可以使用插件[uni-chooseSystemMedia](https://ext.dcloud.net.cn/plugin?id=20744)。
+2. 支持“原图”选项。
+3. 使用非原图，即压缩图片时，会在应用沙盒目录的cache目录产生临时文件（压缩后的图片），位置[详见](file-system-spec.md#cache)
+4. 在4.41以前，Android无论如何都会在应用沙盒目录的cache目录产生临时文件。从4.41起，chooseImage支持了contentURI，选择照片时如果不压缩图片，会返回contentURI，不再向cache目录写临时文件了。
+- system方式
+1. 使用系统选择器时，好处是不需要申请额外权限，它的模式类似于web浏览器中的input type=file，应用其实不具有本机文件访问能力，用户通过系统选择器把图片传给应用。
+2. system方式无需特殊向google申明选择权限的必要性，即可正常上架google play。但注意同时需要在manifest.json中将`<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />`和`<uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />`权限移除。配置方式参考[移除Android权限](https://uniapp.dcloud.net.cn/tutorial/app-nativeresource-android.html#removepermissions)。
+3. 界面ui无法自定义，比如Android、iOS上无法添加“原图”选项。鸿蒙上系统UI自带原图选项。
+4. 界面ui的主题和国际化，跟随手机rom，而不是跟随app（假使App和Rom不一致）
+5. 因为不涉及压缩，所以也没有临时文件，不会在cache目录下生成临时文件。
+
+## Tips
+* 本API会自动申请摄像头、相册等相关权限，如需手动获取app是否拥有摄像头和相册权限，参考 [uni.getAppAuthorizeSetting](get-app-authorize-setting.md)
+* app端拍照和部分情况下的相册选择会在应用沙盒目录的cache目录产生临时文件，位置[详见](file-system-spec.md#cache)。app端如需主动删除临时文件，使用[uni.getFileSystemManager](get-file-system-manager.md)。
+* 从HBuilderX4.41版起，uni.chooseImage在`sourceType`为`['album']`、`albumMode`为`system`、`sizeType`为`['original']`并且未设置`crop`时，支持返回Uri地址。
+* `albumMode`的`system`属性打开的是系统的图片选择器；`custom`属性打开的是uni-app x框架提供的图片选择器。
+* 系统图片选择器的`sizeType`仅支持设置`['original']`或`['compressed']`。在Android 11及以上的系统中，设置`system`调用的是系统的照片选择器，低于android 11的系统中会调用系统的文件选择器。

package/data/uni-app-x-docs/api/choose-location.md

@@ -0,0 +1,304 @@
+<!-- ## uni.chooseLocation(options) @chooselocation -->
+
+<!-- UTSAPIJSON.chooseLocation.name -->
+
+<!-- UTSAPIJSON.chooseLocation.description -->
+
+调用本API会打开一个新窗体，在地图中选择一个位置，在success回调中返回选择的位置名称和坐标。
+
+本功能依赖地图组件。App和Web需在manifest.json中正确配置地图模块以及相关的key信息。
+
+不同平台支持的地图不同，具体见[map组件](../component/map.md)。
+
+国内图商的坐标系都是gcj02坐标，国外图商是wgs84坐标。
+
+地图是商业服务，授权较贵，如需购买，请点击[获取优惠](https://ask.dcloud.net.cn/explore/map/)。
+
+
+<!-- UTSAPIJSON.chooseLocation.compatibility -->
+
+<!-- UTSAPIJSON.chooseLocation.param -->
+
+<!-- UTSAPIJSON.chooseLocation.returnValue -->
+
+<!-- UTSAPIJSON.chooseLocation.example -->
+
+## 三方地图SDK
+
+uni.chooseLocation 依赖三方地图SDK，点击[查看详情](../component/map.md#mapsdk)
+
+## App平台依赖uniCloud@unicloud
+> HBuilderX 4.33+
+
+uni.chooseLocation 中有个功能是传入位置返回周围的POI信息。在腾讯地图中该功能不是客户端API，而是一个webservice接口。因为涉及收费，该接口需要传入key。
+
+在App中，从客户端带着key直接发起请求腾讯地图的webservice接口是不安全的。key泄露后会导致其他人调用腾讯相关能力但费用由key的所属人缴纳。
+
+web端可以使用在腾讯地图web控制台配置域名白名单的方式，但App无法采用这种方式。
+
+App上安全的方式是由客户端不带key请求开发者的服务器，由开发者的服务器判断客户端的身份，然后服务器带着key请求腾讯地图的服务器，成功后返回POI列表给客户端。
+
+DCloud的所有服务器API，都是基于uniCloud的。并且uniCloud早已经有 [uni-map-common](https://doc.dcloud.net.cn/uniCloud/uni-map-common.html)
+
+所以在腾讯地图的 uni.chooseLocation 中，需要依赖 uniCloud 的 uni-map-common 插件。开发者在该插件的配置文件中配置好key，无需自己编写代码，即可使用本API。
+
+开发者首先需要开通 [uniCloud](https://unicloud.dcloud.net.cn)，选择一个服务商（可自由选择，不是必须使用腾讯云），创建一个服务空间。
+
+在HBuilderX对项目点右键，关联服务空间。如果你的项目没有创建过 uniCloud 环境，则先右键项目名，创建uniCloud云开发环境，uniCloud 的 web控制台地址：[https://unicloud.dcloud.net.cn](https://unicloud.dcloud.net.cn)
+
+![](https://web-ext-storage.dcloud.net.cn/uni-app-x/API/chooseLocation/aa35d5a6-9b13-4fea-8a0c-1b3534584659.png)
+
+关联服务空间后，将 uni-map-common 插件导入项目，插件地址：[https://ext.dcloud.net.cn/plugin?id=13872](https://ext.dcloud.net.cn/plugin?id=13872)
+
+安装完 uni-map-common 插件后，需要将你的地图key配置在 `/uni_modules/uni-config-center/uniCloud/cloudfunctions/common/uni-config-center/uni-map/config.js` 如果你的项目没有此配置文件，则直接根据目录创建对应的目录和 `config.js` 文件，文件内容如下：
+
+```js
+module.exports = {
+	"default": "qqmap", // 当前使用哪个平台
+	"key": {
+		"qqmap": "", // 腾讯地图key
+		"amap": "", // 高德地图key
+	}
+}
+```
+
+请务必注意地图的key，是有权限的可以访问周围POI信息的，且有足够的额度。这涉及付费采购。点此联系DCloud咨询[获取优惠](https://ask.dcloud.net.cn/explore/map/)
+
+配置完毕后，本地运行即可使用。正式发布时，记得对uniCloud目录点右键，将相关云函数和模块提交发布到正式服务器上。具体操作如下图所示
+
+![](https://web-ext-storage.dcloud.net.cn/uni-app-x/API/chooseLocation/6ce6b6f3-2334-40d5-bd06-69efb5174305.png)
+
+如果需要在uniCloud服务器更安全的验证客户端的身份，你可以在云函数中校验客户的token，避免其他人伪造请求访问你的云函数。
+
+### uni-map-common错误码
+
+uni.chooseLocation 获取POI列表的功能依赖uniCloud中的 [uni-map-common](https://doc.dcloud.net.cn/uniCloud/uni-map-common.html) 插件，该插件在请求地图服务器失败时会抛出错误信息，点击查看[uni-map-common错误码](https://doc.dcloud.net.cn/uniCloud/uni-map-common.html#errorcode)
+
+
+### 透传鉴权参数payload@payload
+> HBuilderX 4.35+
+
+uni.chooseLocation 自HBuilderX 4.35+ 起，新增了一个参数payload，为 UTSJSONObject 类型，此参数会透传给uni-map-co，开发者可在请求地图服务器之前对参数进行鉴权，比如只有登录用户才能调用POI查询接口等等。
+
+**示例代码**
+
+```js
+uni.chooseLocation({
+  payload: {
+    token: "xxx",
+  },
+  success: (res) => {
+    console.log('res: ', res);
+  }
+});
+```
+
+#### 鉴权payload参数
+> HBuilderX 4.35+
+
+开发者可以在 uni-map-co 的 `_before` 方法内进行鉴权，鉴权代码可以写在 `_before` 函数已有代码的下面。
+
+#### 情况一: 自身业务在uniCloud，且使用了uni-id-common@payload1
+
+1. 右键 uni-map-co 云对象，管理公共模块或扩展库依赖，打勾 uni-id-common 依赖
+2. 在 `_before` 函数已有代码的下面新增以下代码
+```js
+const uniIdCommon = require('uni-id-common')
+const uniID = uniIdCommon.createInstance({
+	clientInfo: this.getClientInfo()
+});
+// 获取uniIdToken
+const uniIdToken = this.getUniIdToken()
+// 校验uniIdToken
+const checkTokenRes = await uniIDIns.checkToken(uniIdToken)
+if (checkTokenRes.code) {
+	// token校验不通过
+	throw {
+		errCode: checkTokenRes.errCode || checkTokenRes.code,
+		errMsg: checkTokenRes.errMsg || checkTokenRes.msg
+	}
+}
+// 获取payload参数
+let {
+	payload, // payload参数为前端传递的参数，可以在前端调用uni.chooseLocation时传递
+} = this.getParams()[0] || {};
+// 可继续校验payload参数
+// ...
+
+```
+
+以上就已经完成了用户是否登录的判断，不登录不能调用，当然你还能继续优化代码以适应不同的业务需求。
+
+#### 情况二: 自身业务在uniCloud，未使用uni-id-common@payload2
+
+推荐使用uni-id-common，[下载地址](https://ext.dcloud.net.cn/plugin?id=8576)
+
+当然你也可以直接在 `_before` 函数已有代码的下面新增自己的鉴权代码
+
+```js
+// 获取payload参数
+let {
+	payload, // payload参数为前端传递的参数，可以在前端调用uni.chooseLocation时传递
+} = this.getParams()[0] || {};
+if (!payload) {
+	throw {
+		errCode: -1,
+		errMsg: "payload参数不能为空"
+	}
+}
+// 继续校验payload参数
+// ...
+```
+
+#### 情况三: 自身业务不在uniCloud@payload3
+
+如果业务不在uniCloud，你可以在uni-map-co中通过http请求你的后端服务器。
+
+1. 打开文件 `/uni_modules/uni-map-common/uniCloud/cloudfunctions/uni-map-co/index.obj.js`
+2. 在 `_before` 函数已有代码的下面新增以下代码
+
+```js
+// 获取payload参数
+let {
+	payload, // payload参数为前端传递的参数，可以在前端调用uni.chooseLocation时传递
+} = this.getParams()[0] || {};
+if (!payload) {
+	throw {
+		errCode: -1,
+		errMsg: "payload参数不能为空"
+	}
+}
+// 请求后端服务接口
+const requestRes = await uniCloud.request({
+	method: 'POST',
+	url: '你自己的接口地址',
+	data: payload,
+});
+// 与后端约定errCode不为0代表校验失败，errMsg为失败原因
+if (requestRes.data.errCode !== 0) {
+	throw {
+		errCode: requestRes.data.errCode,
+		errMsg: requestRes.data.errMsg
+	}
+}
+```
+
+
+### 未依赖uniCloud时向下兼容说明
+
+当项目未使用uniCloud时，uni.chooseLocation 功能将调整为全屏地图选点模式。在该模式下，POI列表信息将不再显示，用户无法通过POI进行选点，只能直接在地图上进行位置选择。同时返回值只有latitude和longitude是有值的，name和address为空字符串，如下所示：
+
+```json
+{
+	"name": "",
+	"address": "",
+	"latitude": 39.951028,
+	"longitude": 116.354662
+}
+```
+
+## 自定义样式@custom
+> HBuilderX 4.33+
+
+uni.chooseLocation 虽然是一个框架内置的页面。但提供了丰富的自定义能力。
+
+该页面自动适配了暗黑、横屏、国际化（内置中文繁简和英文）。页面上的图片元素均使用字体图标，可以覆盖class。
+
+可通过App.vue中写入全局css样式进行覆盖修改。
+
+- 以 .uni-choose-location-light 开头的为light模式下的样式
+- 以 .uni-choose-location-dark 开头的为dark模式下的样式
+
+样式必须以 `!important;` 结尾才能生效，以下是 CSS class 名称，写入同名 class 即可覆盖。
+
+文本样式除了下方列出的 color 和 background-color 外，你还可以替换 font-family 等任何 text 标签支持的样式。
+
+地图中心点的icon
+
+```css
+.uni-choose-location-light .uni-choose-location-map-target-icon {
+	color: red !important;
+}
+.uni-choose-location-dark .uni-choose-location-map-target-icon {
+	color: red !important;
+}
+```
+
+右上方"确认"按钮
+
+```css
+.uni-choose-location-light .uni-choose-location-nav-confirm-text {
+	background-color: red !important;
+	color: #fff !important;
+}
+.uni-choose-location-dark .uni-choose-location-nav-confirm-text {
+	background-color: red !important;
+	color: #fff !important;
+}
+```
+
+左上方"取消"按钮
+
+```css
+.uni-choose-location-light .uni-choose-location-nav-back-text {
+	color: red !important;
+}
+.uni-choose-location-dark .uni-choose-location-nav-back-text {
+	color: red !important;
+}
+```
+
+搜索框右侧的"取消"文字
+
+```css
+.uni-choose-location-light .uni-choose-location-poi-search-cancel {
+	color: red !important;
+}
+.uni-choose-location-dark .uni-choose-location-poi-search-cancel {
+	color: red !important;
+}
+```
+
+已选中的POI右侧的对钩icon
+
+```css
+.uni-choose-location-light .uni-choose-location-poi-item-selected-icon {
+	color: red !important;
+}
+.uni-choose-location-dark .uni-choose-location-poi-item-selected-icon {
+	color: red !important;
+}
+```
+
+POI标题
+
+```css
+.uni-choose-location-light .uni-choose-location-poi-item-title-text {
+  color: red !important;
+}
+.uni-choose-location-dark .uni-choose-location-poi-item-title-text {
+  color: red !important;
+}
+```
+
+POI地址
+
+```css
+.uni-choose-location-light .uni-choose-location-poi-item-detail-text {
+  color: red !important;
+}
+.uni-choose-location-dark .uni-choose-location-poi-item-detail-text {
+  color: red !important;
+}
+```
+
+## 历史问题
+uni-app x 4.24以前，Web平台本API调用了腾讯地图的免费gcj02坐标转换接口，该接口从2024年7月18日起被腾讯逐步下线，导致老版本中本API无法使用。请升级到4.24+。
+
+升级后注意：
+1. manifest中配置好自己的地图厂商key
+2. 确保在地图厂商那里配额足够
+3. 确保在地图厂商那里有周边服务的权限。否则无法获取周围地址
+4. 确保自己的域名在地图厂商那里正确配置了域名白名单
+
+<!-- UTSAPIJSON.chooseLocation.tutorial -->

package/data/uni-app-x-docs/api/choose-media.md

@@ -0,0 +1,29 @@
+<!-- ## uni.chooseMedia(options) @choosemedia -->
+
+<!-- UTSAPIJSON.chooseMedia.name -->
+
+<!-- UTSAPIJSON.chooseMedia.description -->
+
+<!-- UTSAPIJSON.chooseMedia.compatibility -->
+
+<!-- UTSAPIJSON.chooseMedia.param -->
+
+<!-- UTSAPIJSON.chooseMedia.returnValue -->
+
+Android端返回的路径是content协议。
+
+<!-- UTSAPIJSON.chooseMedia.tutorial -->
+
+<!-- UTSAPIJSON.chooseMedia.example -->
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->
+
+
+## Tips
+- chooseMedia的相册选择在App平台是系统UI，其风格不同rom可能有差异。多选时有的是长按、有的是checkbox。系统UI的暗黑模式、国际化跟随系统，而不跟随App。
+- android端由于系统或ROM的限制，拍照的`maxDuration`和`camera`属性在部分手机上不生效。
+- 从HBuilderX4.61版起，ChooseMediaSuccess中的duration、size精度统一调整为小数点后3位数
+- iOS端拍照和相册选择会在应用沙盒目录的cache目录产生临时文件，位置[详见](file-system-spec.md#cache)。如需主动删除临时文件，使用[uni.getFileSystemManager](get-file-system-manager.md)。
+- App平台通过chooseMedia选择媒体文件后，默认没有压缩，需自行调用 [uni.compressImage](./compress-image.md) 或 [uni.compressVideo](./compress-video.md) 来压缩。

package/data/uni-app-x-docs/api/choose-video.md

@@ -0,0 +1,31 @@
+<!-- ## uni.chooseVideo(options) @choosevideo -->
+
+<!-- UTSAPIJSON.chooseVideo.name -->
+
+<!-- UTSAPIJSON.chooseVideo.description -->
+
+<!-- UTSAPIJSON.chooseVideo.compatibility -->
+
+<!-- UTSAPIJSON.chooseVideo.param -->
+
+<!-- UTSAPIJSON.chooseVideo.returnValue -->
+
+<!-- UTSAPIJSON.chooseVideo.tutorial -->
+
+<!-- UTSAPIJSON.chooseVideo.example -->
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->
+
+
+## Tips
+* 视频选择的相册，在入参option中，推荐设置albumMode为system，即选择系统相册来选择视频。这样可以避免权限问题，并且google play上架也有要求。[google play 照片和视频权限政策](https://support.google.com/googleplay/android-developer/answer/14115180)。后续会废弃custom方式。
+* 当设置`albumMode`为`system`时，可以正常上架google play。同时需要注意在manifest.json中将`<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />`和`<uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />`权限移除。配置方式参考[移除Android权限](https://uniapp.dcloud.net.cn/tutorial/app-nativeresource-android.html#removepermissions).
+* 系统相册选择界面的主题和国际化，跟随手机rom，而不是跟随app。
+* 不推荐使用本API的压缩参数，大视频选择时，会卡在视频选择页面很久。应该在选择完毕视频后，自行择机（比如上传视频时）调用uni.compressVideo来压缩视频。
+* 本API会自动申请摄像头，如需手动获取app是否拥有摄像头，参考 [uni.getAppAuthorizeSetting](get-app-authorize-setting.md)。（如使用system方式的相册选择，则不需要权限）
+* app端拍摄会在应用沙盒目录的cache目录产生临时文件，位置[详见](file-system-spec.md#cache)。如需主动删除临时文件，使用[uni.getFileSystemManager](get-file-system-manager.md)。
+* android端由于系统或ROM的限制，拍照的`maxDuration`和`camera`属性在部分手机上不生效。
+* 从HBuilderX4.41版起，uni.chooseVideo在`sourceType`为`['album']`、`albumMode`为`system`、`compressed`为`true`时，支持返回Uri地址。
+* 系统视频选择器的`sizeType`仅支持设置`['original']`或`['compressed']`。在Android 11及以上的系统中，设置`system`调用的是系统的视频选择器，低于android 11的系统中会调用系统的文件选择器。

package/data/uni-app-x-docs/api/clipboard.md

@@ -0,0 +1,44 @@
+<!-- ## uni.getClipboardData(options) @getclipboarddata -->
+
+<!-- UTSAPIJSON.getClipboardData.name -->
+
+<!-- UTSAPIJSON.getClipboardData.description -->
+
+<!-- UTSAPIJSON.getClipboardData.compatibility -->
+
+<!-- UTSAPIJSON.getClipboardData.param -->
+
+<!-- UTSAPIJSON.getClipboardData.returnValue -->
+
+<!-- UTSAPIJSON.getClipboardData.example -->
+
+**注意**
+
+- 读取剪贴板，在一些新的Android设备上，被列为单独的权限，如没有相关权限，则无法读取剪贴板。
+- 在鸿蒙上，读取剪贴板是一个高敏感权限，较难申请，参考[鸿蒙文档](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/get-pastedata-permission-guidelines?ha_source=Dcloud&ha_sourceId=89000448)
+
+<md-hperm permissions="ohos.permission.READ_PASTEBOARD" />
+
+<!-- UTSAPIJSON.getClipboardData.tutorial -->
+
+<!-- ## uni.setClipboardData(options) @setclipboarddata -->
+
+<!-- UTSAPIJSON.setClipboardData.name -->
+
+<!-- UTSAPIJSON.setClipboardData.description -->
+
+<!-- UTSAPIJSON.setClipboardData.compatibility -->
+
+<!-- UTSAPIJSON.setClipboardData.param -->
+
+<!-- UTSAPIJSON.setClipboardData.returnValue -->
+
+<!-- UTSAPIJSON.setClipboardData.example -->
+
+<!-- UTSAPIJSON.setClipboardData.tutorial -->
+
+<!-- UTSAPIJSON.clipboard.example -->
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->

package/data/uni-app-x-docs/api/compass.md

@@ -0,0 +1,53 @@
+## uni.onCompassChange(callback) @oncompasschange
+
+<!-- UTSAPIJSON.onCompassChange.description -->
+
+<!-- UTSAPIJSON.onCompassChange.compatibility -->
+
+<!-- UTSAPIJSON.onCompassChange.param -->
+
+<!-- UTSAPIJSON.onCompassChange.returnValue -->
+
+<!-- UTSAPIJSON.onCompassChange.tutorial -->
+
+## uni.offCompassChange(callback) @offcompasschange
+
+<!-- UTSAPIJSON.offCompassChange.description -->
+
+<!-- UTSAPIJSON.offCompassChange.compatibility -->
+
+<!-- UTSAPIJSON.offCompassChange.param -->
+
+<!-- UTSAPIJSON.offCompassChange.returnValue -->
+
+<!-- UTSAPIJSON.offCompassChange.tutorial -->
+
+## uni.startCompass(options?) @startcompass
+
+<!-- UTSAPIJSON.startCompass.description -->
+
+<!-- UTSAPIJSON.startCompass.compatibility -->
+
+<!-- UTSAPIJSON.startCompass.param -->
+
+<!-- UTSAPIJSON.startCompass.returnValue -->
+
+<!-- UTSAPIJSON.startCompass.tutorial -->
+
+## uni.stopCompass(options?) @stopcompass
+
+<!-- UTSAPIJSON.stopCompass.description -->
+
+<!-- UTSAPIJSON.stopCompass.compatibility -->
+
+<!-- UTSAPIJSON.stopCompass.param -->
+
+<!-- UTSAPIJSON.stopCompass.returnValue -->
+
+<!-- UTSAPIJSON.stopCompass.tutorial -->
+
+<!-- UTSAPIJSON.compass.example -->
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->

package/data/uni-app-x-docs/api/compress-image.md

@@ -0,0 +1,25 @@
+## uni.compressImage(options) @compressImage
+
+<!-- UTSAPIJSON.compressImage.description -->
+
+<!-- UTSAPIJSON.compressImage.compatibility -->
+
+<!-- UTSAPIJSON.compressImage.param -->
+
+<!-- UTSAPIJSON.compressImage.returnValue -->
+
+<!-- UTSAPIJSON.compressImage.tutorial -->
+
+<!-- UTSAPIJSON.compressImage.example -->
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->
+
+## Tips
+
+- quality属性
+  - Android、iOS平台：仅对JPG格式图片生效，非JPG格式图片quality属性始终为100。
+  - HarmonyOS 平台：对 JPG、HEIF 生效，其他为100。[详情](https://developer.huawei.com/consumer/cn/doc/harmonyos-faqs/faqs-image-4?ha_source=Dcloud&ha_sourceId=89000448)
+- Android平台仅支持对JPG格式图片进行压缩，其他格式会被压缩为JPG格式。如果对带有透明度的png压缩成jpg会丢失透明度变成黑色。iOS平台支持对JPG和PNG格式进行压缩。
+- HarmonyOS 平台支持对 JPG（透明色将变为黑色）、HEIF、PNG（转为 JPG，透明色将变为黑色） 格式进行压缩。

package/data/uni-app-x-docs/api/compress-video.md

@@ -0,0 +1,21 @@
+## uni.compressVideo(options) @compressVideo
+
+<!-- UTSAPIJSON.compressVideo.description -->
+
+<!-- UTSAPIJSON.compressVideo.compatibility -->
+
+<!-- UTSAPIJSON.compressVideo.param -->
+
+<!-- UTSAPIJSON.compressVideo.returnValue -->
+
+<!-- UTSAPIJSON.compressVideo.tutorial -->
+
+<!-- UTSAPIJSON.compressVideo.example -->
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->
+
+
+## Tips
+* 从HBuilderX4.61版起，CompressVideoSuccess中的size精度统一调整为小数点后3位数

package/data/uni-app-x-docs/api/connect-event-source.md

@@ -0,0 +1,34 @@
+<!-- ## uni.connectEventSource(options) @connecteventsource -->
+
+<!-- UTSAPIJSON.connectEventSource.name -->
+
+<!-- UTSAPIJSON.connectEventSource.description -->
+
+SSE，全称是Server-sent Events，一种服务器基于http向客户端推送文本消息的技术。
+
+提供本API（uni.connectEventSource）的主要目的是兼容Web的SSE规范。但如果开发者需要接收AI大语言模型的数据，实际上无法使用SSE。
+
+因为SSE仅支持get，无法post数据。LLM是用户post一个prompt，然后流式获取结果。
+
+所以LLM流式接收数据的场景，应该使用uni.request的Chunk，而不是使用本API（uni.connectEventSource）。[详见](request.md)
+
+<!-- UTSAPIJSON.connectEventSource.compatibility -->
+
+Web端暂未兼容uni.connectEventSource API，请使用标准的Web API。
+
+小程序不支持SSE，替代方案也是使用uni.request的Chunk。
+
+
+<!-- UTSAPIJSON.connectEventSource.param -->
+
+<!-- UTSAPIJSON.connectEventSource.returnValue -->
+
+<!-- UTSAPIJSON.connectEventSource.example -->
+
+<!-- UTSAPIJSON.connectEventSource.tutorial -->
+
+<!-- UTSAPIJSON.connectEventSource.example -->
+
+<!-- UTSAPIJSON.general_type.name -->
+
+<!-- UTSAPIJSON.general_type.param -->