tmui-cli 2.0.3 → 2.0.4

package/data/uniappx/api/choose-location.md

@@ -0,0 +1,412 @@
+::: sourceCode
+## uni.chooseLocation(options) @chooselocation
+
+> GitCode: https://gitcode.com/dcloud/uni-api/tree/alpha/uni_modules/uni-chooseLocation
+
+> GitHub: https://github.com/dcloudio/uni-api/tree/alpha/uni_modules/uni-chooseLocation
+
+打开地图选择位置
+
+调用本API会打开一个新窗体，在地图中选择一个位置，在success回调中返回选择的位置名称和坐标。
+
+本功能依赖地图组件。App和Web需在manifest.json中正确配置地图模块以及相关的key信息。
+
+不同平台支持的地图不同，具体见[map组件](../component/map.md)。
+
+国内图商的坐标系都是gcj02坐标，国外图商是wgs84坐标。
+
+地图是商业服务，授权较贵，如需购买，请点击[获取优惠](https://ask.dcloud.net.cn/explore/map/)。
+
+### chooseLocation 兼容性  
+| Web | 微信小程序 | Android | iOS | HarmonyOS |
+| :- | :- | :- | :- | :- |
+| 4.0 | 4.41 | 4.33 | 4.33 | 4.61 |
+
+### 参数 
+
+| 名称 | 类型 | 必填 | 描述 |
+| :- | :- | :- | :- |
+| options | **ChooseLocationOptions** | 是 | uni.chooseLocation函数参数定义 |
+| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+| :- | :- | :- |  :-: | :- |
+| latitude | number | 否 | Web 4.0 / 微信小程序 4.41 / Android 4.33 / iOS 4.33 / HarmonyOS 4.61 | 指示位置的经度 |
+| longitude | number | 否 | Web 4.0 / 微信小程序 4.41 / Android 4.33 / iOS 4.33 / HarmonyOS 4.61 | 指示位置的纬度 |
+| keyword | string | 否 | Web 4.0 / Android 4.33 / iOS 4.33 / HarmonyOS 4.61（部分支持，见上） | 指示位置的名称 |
+| payload | UTSJSONObject | 否 | Web 4.35 / Android 4.35 / iOS 4.35 / HarmonyOS 4.61（部分支持，见上） | 用户自定义参数 |
+| success | (result: [ChooseLocationSuccess](#chooselocationsuccess-values)) => void | 否 | Web 4.0 / 微信小程序 4.41 / Android 4.33 / iOS 4.33 / HarmonyOS 4.61 | 接口调用成功的回调函数 |
+| fail | (result: [ChooseLocationFail](#chooselocationfail-values)) => void | 否 | Web 4.0 / 微信小程序 4.41 / Android 4.33 / iOS 4.33 / HarmonyOS 4.61 | 接口调用失败的回调函数 |
+| complete | (result: any) => void | 否 | Web 4.0 / 微信小程序 4.41 / Android 4.33 / iOS 4.33 / HarmonyOS 4.61 | 接口调用结束的回调函数（调用成功、失败都会执行） | 
+
+#### ChooseLocationSuccess 的属性值 @chooselocationsuccess-values 
+
+| 名称 | 类型 | 必备 |
+| :- | :- | :- |
+| errMsg | string | 是 |
+| name | string | 是 |
+| address | string | 是 |
+| latitude | number | 是 |
+| longitude | number | 是 |
+
+#### ChooseLocationFail 的属性值 @chooselocationfail-values 
+
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| errCode | number | 是 | 错误码 |
+| 合法值 | 兼容性 | 描述 |
+| :- |  :-: | :- |
+| 1 | Web 4.34 / Android 4.34 / iOS 4.34 / HarmonyOS 4.61（部分支持，见上） | 取消 |
+| 4 | Web 4.34 / Android 4.34 / iOS 4.34 / HarmonyOS 4.61（部分支持，见上） | 框架内部错误 |
+| errSubject | string | 是 | 统一错误主题（模块）名称 |
+| data | any | 否 | 错误信息中包含的数据 |
+| cause | Error | 否 | 源错误信息，可以包含多个错误，详见SourceError |
+| errMsg | string | 是 |  |
+
+### 示例
+
+示例为[hello uni-app x alpha分支](https://gitcode.com/dcloud/hello-uni-app-x/blob/prod_alpha/pages/API/choose-location/choose-location.uvue)，与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例[另见](https://gitcode.com/dcloud/hello-uni-app-x/blob/master//pages/API/choose-location/choose-location.uvue) 
+::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/API/choose-location/choose-location
+
+> appRedirect https://hellouniappx.dcloud.net.cn/appredirect.html?path=pages/API/choose-location/choose-location
+
+>示例
+```vue
+<template>
+  <view>
+    <page-head :title="data.title"></page-head>
+    <view class="uni-padding-wrap">
+      <view class="uni-column uni-container align-center">
+        <text class="uni-hello-text">位置信息</text>
+        <text v-if="!data.hasLocation" class="uni-title-text uni-common-mt">未选择位置</text>
+        <view v-if="data.hasLocation" class="align-center">
+          <text class="uni-common-mt">{{data.locationName}}</text>
+          <text class="uni-common-mt">{{data.locationAddress}}</text>
+          <view class="uni-common-mt" v-if="data.location.latitude.length>1">
+            <text>E: {{data.location.longitude[0]}}°{{data.location.longitude[1]}}′</text>
+            <text>\nN: {{data.location.latitude[0]}}°{{data.location.latitude[1]}}′</text>
+          </view>
+        </view>
+      </view>
+      <view class="uni-btn-v">
+        <text class="tips">注意：\n1. Web和App需要正确配置地图服务商的Key并且保证Key的权限和余额足够，才能正常选择位置\n2. 若没有关联uniCloud空间，则只能全屏地图选点，不能根据POI选择位置\n3. payload参数会原样透传给uni-map-co，可用于用户鉴权</text>
+        <boolean-data :defaultValue="false" title="是否指定位置为天安门" @change="changeLocationBoolean"></boolean-data>
+        <boolean-data :defaultValue="false" title="是否携带keyword参数" @change="changeKeywordBoolean"></boolean-data>
+        
+        <boolean-data :defaultValue="false" title="是否携带payload参数" @change="changePayloadBoolean"></boolean-data>
+        
+        <button class="uni-btn" type="primary" @tap="chooseLocation">选择位置</button>
+        <button class="uni-btn" @tap="clear">清空</button>
+        
+        <button class="uni-btn" type="primary" @tap="chooseLocationByPlugin">通过 uts 插件调用 chooseLocation</button>
+        
+      </view>
+    </view>
+  </view>
+</template>
+
+<style>
+  .page-body-info {
+    padding-bottom: 0;
+    height: 220px;
+  }
+  .align-center{
+    align-items: center;
+  }
+  .tips {
+    font-size: 12px;
+    margin: 15px 0;
+    opacity: .8;
+  }
+</style>
+
+```
+
+## 三方地图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. 确保自己的域名在地图厂商那里正确配置了域名白名单
+
+### 参见
+- [相关 Bug](https://issues.dcloud.net.cn/?mid=api.location.chooseLocation)
+- [参见uni-app相关文档](https://uniapp.dcloud.net.cn/api/location/location.html#chooselocation)
+- [微信小程序文档](https://developers.weixin.qq.com/miniprogram/dev/api/location/wx.chooseLocation.html)
+- [支付宝小程序文档](https://open.alipay.com/portal/zhichi/search?keyword=chooseLocation&pageIndex=1&pageSize=10&source=doc_top&type=all)
+- [百度小程序文档](https://smartprogram.baidu.com/forum/search?query=chooseLocation&scope=devdocs&source=docs)
+- [抖音小程序文档](https://developer.open-douyin.com/search-page?keyword=chooseLocation&secondType=all&type=1)
+- [飞书小程序文档](https://open.feishu.cn/search?from=header&page=1&pageSize=10&q=chooseLocation&topicFilter=)
+- [钉钉小程序文档](https://open.dingtalk.com/search?keyword=chooseLocation)
+- [QQ小程序文档](https://q.qq.com/wiki/develop/miniprogram/frame/)
+- [快手小程序文档](https://developers.kuaishou.com/page?keyword=chooseLocation&from=docs)
+- [京东小程序文档](https://mp-docs.jd.com/doc/dev/framework/-1)
+- [华为快应用文档](https://developer.huawei.com/consumer/cn/doc/quickApp-References/webview-frame-overview-0000001124793625)
+- [360小程序文档](https://mp.360.cn/doc/miniprogram/dev/#/b770a184ff1f06c6b3393a0fd1132380)

package/data/uniappx/api/choose-media.md

@@ -0,0 +1,272 @@
+::: sourceCode
+## uni.chooseMedia(options) @choosemedia
+
+> GitCode: https://gitcode.com/dcloud/uni-api/tree/alpha/uni_modules/uni-chooseMedia
+
+> GitHub: https://github.com/dcloudio/uni-api/tree/alpha/uni_modules/uni-chooseMedia
+
+拍摄或从手机相册中选择图片或视频。
+
+### chooseMedia 兼容性  
+| Web | 微信小程序 | Android | iOS | HarmonyOS |
+| :- | :- | :- | :- | :- |
+| <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.41 | 4.51 | 4.51 | 4.61 |
+
+### 参数 
+
+| 名称 | 类型 | 必填 | 兼容性 |
+| :- | :- | :- |  :-: |
+| options | **ChooseMediaOptions** | 是 | Web x（部分支持，见上） |
+| 名称 | 类型 | 必备 | 默认值 | 兼容性 | 描述 |
+| :- | :- | :- | :- |  :-: | :- |
+| pageOrientation | string | 否 |  | Web x / 微信小程序 4.41 / Android 4.51 / iOS x / HarmonyOS 4.61（部分支持，见上） | 屏幕方向。默认为pages.json中的pageOrientation。 |
+@@| 合法值 | 兼容性 | 描述 |
+@@| :- |  :-: | :- |
+@@| "auto" | Web x（部分支持，见上） | 自动 |
+@@| portrait | Web x（部分支持，见上） | 竖屏显示 |
+@@| landscape | Web x（部分支持，见上） | 横屏显示 |
+| count | number | 否 | 9 | Web x / 微信小程序 4.41 / Android 4.51 / iOS 4.51 / HarmonyOS 4.61（部分支持，见上） | 最多可以选择的文件个数 |
+| mediaType | Array&lt;string&gt; | 否 | \['image', 'video'\] | Web x / 微信小程序 4.41 / Android 4.51 / iOS 4.51 / HarmonyOS 4.61（部分支持，见上） | image 只能拍摄图片或从相册选择图片，video 只能拍摄视频或从相册选择视频，mix 可同时选择图片和视频，合法值：'image'、'video'、'mix' |
+| sourceType | Array&lt;string&gt; | 否 | \['album', 'camera'\] | Web x / 微信小程序 4.41 / Android 4.51 / iOS 4.51 / HarmonyOS 4.61（部分支持，见上） | album 从相册选择，camera 使用相机拍摄 |
+| maxDuration | number | 否 | 10 | Web x / 微信小程序 4.41 / Android 4.51 / iOS 4.51 / HarmonyOS 4.61（部分支持，见上） | 拍摄视频最长拍摄时间，单位秒。时间范围为 3s 至 30s 之间 |
+| camera | string | 否 |  | Web x / 微信小程序 4.41 / Android 4.51 / iOS 4.51 / HarmonyOS 4.61（部分支持，见上） | 仅在 sourceType 为 camera 时生效，使用前置或后置摄像头<br/> |
+@@| 合法值 | 兼容性 | 描述 |
+@@| :- |  :-: | :- |
+@@| front | Web x（部分支持，见上） | 前置摄像头 |
+@@| back | Web x（部分支持，见上） | 后置摄像头 |
+| success | (callback: [ChooseMediaSuccess](#choosemediasuccess-values)) => void | 否 |  | Web x（部分支持，见上） | 接口调用成功，返回视频文件的临时文件路径，详见返回参数说明 |
+| fail | (callback: [ChooseMediaFail](#choosemediafail-values)) => void | 否 |  | Web x（部分支持，见上） | 接口调用失败的回调函数 |
+| complete | (callback: any) => void | 否 |  | Web x（部分支持，见上） | 接口调用结束的回调函数（调用成功、失败都会执行） |
+| sizeType | Array&lt;string&gt; | 否 |  | Web x / 微信小程序 4.41（部分支持，见上） | 是否压缩所选文件，基础库2.25.0前仅对 mediaType 为 image 时有效，2.25.0及以后对全量 mediaType 有效<br/> | 
+
+#### ChooseMediaSuccess 的属性值 @choosemediasuccess-values 
+
+| 名称 | 类型 | 必备 | 兼容性 |
+| :- | :- | :- |  :-: |
+| tempFiles | Array&lt;**ChooseMediaTempFile**&gt; | 是 | Web x（部分支持，见上） |
+| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+| :- | :- | :- |  :-: | :- |
+| tempFilePath | string | 是 | Web x（部分支持，见上） | 选定视频的临时文件路径 |
+| fileType | string | 是 | Web x（部分支持，见上） | 文件类型 |
+@@| 合法值 | 兼容性 |
+@@| :- |  :-: |
+@@| 'image' | Web x（部分支持，见上） |
+@@| video | Web x（部分支持，见上） |
+| size | number | 是 | Web x（部分支持，见上） | 选定视频的数据量大小，单位 kB |
+| byteSize | number | 否 | Web x / Android 4.61 / iOS 4.61 / HarmonyOS 4.61（部分支持，见上） | 视频文件的字节大小，单位 B |
+| duration | number | 否 | Web x（部分支持，见上） | 选定视频的时间长度 |
+| height | number | 否 | Web x（部分支持，见上） | 返回选定视频的长 |
+| width | number | 否 | Web x（部分支持，见上） | 返回选定视频的宽 |
+| thumbTempFilePath | string | 否 | Web x（部分支持，见上） | 视频缩略图临时文件路径 |
+| type | string | 是 | Web x（部分支持，见上） |
+| 合法值 | 兼容性 |
+| :- |  :-: |
+| image | Web x（部分支持，见上） |
+| video | Web x（部分支持，见上） |
+| mix | Web x（部分支持，见上） |
+
+#### ChooseMediaFail 的属性值 @choosemediafail-values 
+
+| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+| :- | :- | :- |  :-: | :- |
+| errCode | number | 是 | Web x（部分支持，见上） | 错误码 |
+| 合法值 | 兼容性 | 描述 |
+| :- |  :-: | :- |
+| 1101001 | Web x（部分支持，见上） | 用户取消 |
+| 1101005 | Web x（部分支持，见上） | 未获取权限 |
+| 1101006 | Web x（部分支持，见上） | 图片或视频保存失败 |
+| 1101008 | Web x（部分支持，见上） | 拍照或录像失败 |
+| 1101010 | Web x（部分支持，见上） | 其他错误 |
+| errSubject | string | 是 | Web x（部分支持，见上） | 统一错误主题（模块）名称 |
+| data | any | 否 | Web x（部分支持，见上） | 错误信息中包含的数据 |
+| cause | Error | 否 |   | 源错误信息，可以包含多个错误，详见SourceError |
+| errMsg | string | 是 | Web x（部分支持，见上） |  |
+
+Android端返回的路径是content协议。
+
+### 参见
+- [相关 Bug](https://issues.dcloud.net.cn/?mid=api.media.chooseMedia)
+- [参见uni-app相关文档](https://uniapp.dcloud.net.cn/api/media/video.html#choosemedia)
+- [微信小程序文档](https://developers.weixin.qq.com/miniprogram/dev/api/media/video/wx.chooseMedia.html)
+- [支付宝小程序文档](https://open.alipay.com/portal/zhichi/search?keyword=chooseMedia&pageIndex=1&pageSize=10&source=doc_top&type=all)
+- [百度小程序文档](https://smartprogram.baidu.com/forum/search?query=chooseMedia&scope=devdocs&source=docs)
+- [抖音小程序文档](https://developer.open-douyin.com/search-page?keyword=chooseMedia&secondType=all&type=1)
+- [飞书小程序文档](https://open.feishu.cn/search?from=header&page=1&pageSize=10&q=chooseMedia&topicFilter=)
+- [钉钉小程序文档](https://open.dingtalk.com/search?keyword=chooseMedia)
+- [QQ小程序文档](https://q.qq.com/wiki/develop/miniprogram/frame/)
+- [快手小程序文档](https://developers.kuaishou.com/page?keyword=chooseMedia&from=docs)
+- [京东小程序文档](https://mp-docs.jd.com/doc/dev/framework/-1)
+- [华为快应用文档](https://developer.huawei.com/consumer/cn/doc/quickApp-References/webview-frame-overview-0000001124793625)
+- [360小程序文档](https://mp.360.cn/doc/miniprogram/dev/#/b770a184ff1f06c6b3393a0fd1132380)
+
+### 示例
+
+示例为[hello uni-app x alpha分支](https://gitcode.com/dcloud/hello-uni-app-x/blob/prod_alpha/pages/API/choose-media/choose-media.uvue)，与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例[另见](https://gitcode.com/dcloud/hello-uni-app-x/blob/master//pages/API/choose-media/choose-media.uvue) 
+>
+> 该 API 不支持 Web，请运行 hello uni-app x 到 App 平台体验 
+
+::: preview
+> appRedirect https://hellouniappx.dcloud.net.cn/appredirect.html?path=pages/API/choose-media/choose-media
+```uvue
+<template>
+  
+  <scroll-view class="page-scroll-view uni-theme-root">
+  
+    <view class="uni-theme-root">
+      <page-head :title="title"></page-head>
+      <view class="uni-common-mt">
+        <view class="uni-list">
+
+          <view class="uni-list-cell cell-pd">
+            <view class="uni-list-cell-left uni-label">
+              <text class="media-label">来源</text>
+            </view>
+            <view class="uni-list-cell-right" @click="chooseMediaSource">
+              <text class="click-t">{{sourceTypes[sourceTypeIndex].title}}</text>
+            </view>
+          </view>
+
+          <view class="uni-list-cell cell-pd">
+            <view class="uni-list-cell-left uni-label">
+              <text class="media-label">方式</text>
+            </view>
+            <view class="uni-list-cell-right" @click="chooseMediaType">
+              <text class="click-t">{{(mediaTypes[mediaTypeIndex] as ChooseSource).title}}</text>
+            </view>
+          </view>
+
+          <view class="uni-list-cell cell-pd">
+            <view class="uni-list-cell-left uni-label">
+              <text class="media-label">数量限制</text>
+            </view>
+            <view class="uni-list-cell-right">
+              <input class="click-t" ref="refCountInput" :value="count" type="number" :maxlength="1" @blur="chooseMediaCount"/>
+            </view>
+          </view>
+
+          
+          <view class="uni-list-cell cell-pd">
+            <view class="uni-list-cell-left uni-label">
+              <text class="media-label">屏幕方向</text>
+            </view>
+            <view class="uni-list-cell-right" @click="chooseOrientationType">
+              <text class="click-t">{{orientationTypes[orientationTypeIndex].title}}</text>
+            </view>
+          </view>
+          
+
+          <view class="uni-list-cell cell-pd">
+            <view class="uni-list-cell-left uni-label">
+              <text class="media-label">摄像头</text>
+            </view>
+            <view class="uni-list-cell-right" @click="chooseCameraType">
+              <text class="click-t">{{cameraTypes[cameraTypeIndex].title}}</text>
+            </view>
+          </view>
+        </view>
+        
+        <input-data title="最长拍摄时间，单位秒" defaultValue="10" type="number" @confirm="onMaxDurationConfirm"></input-data>
+        
+        <view class="uni-list list-pd" style="padding: 15px;">
+          <view class="uni-row" style="margin-bottom: 10px;">
+            <view class="uni-list-cell-left">
+              <text class="media-label">点击预览</text>
+            </view>
+            <view style="margin-left: auto;">
+              <text class="click-t">{{mediaList.length}}/{{count}}</text>
+            </view>
+          </view>
+          <view class="uni-row" style="flex-wrap: wrap;">
+            <view v-for="(file,index) in mediaList" :key="index" class="uni-uploader__input-box" style="border: 0;">
+              <image style="width: 104px; height: 104px;" :src="file.imagePath" @tap="previewMedia(index)">
+              </image>
+              <image src="/static/plus.png" class="image-remove" @click="removeMedia(index)"></image>
+            </view>
+            <image class="uni-uploader__input-box" @tap="chooseMedia" src="/static/plus.png"></image>
+          </view>
+        </view>
+      </view>
+    </view>
+  
+  </scroll-view>
+  
+</template>
+
+
+
+<style>
+  .cell-pd {
+    padding: 11px 15px;
+  }
+
+  .click-t {
+    color: darkgray;
+  }
+
+  .media-label {
+    color: var(--text-color, #333333);
+  }
+
+  .list-pd {
+    margin-top: 25px;
+  }
+
+  .uni-uploader__input-box {
+    margin: 5px;
+    width: 104px;
+    height: 104px;
+    border: 1px solid #D9D9D9;
+  }
+
+  @media (prefers-color-scheme: dark) {
+    .click-t {
+      color: #b8b8b8;
+    }
+
+    .uni-uploader__input-box {
+      border-color: var(--border-color, rgba(255, 255, 255, 0.1));
+    }
+  }
+
+  .uni-uploader__input {
+    position: absolute;
+    z-index: 1;
+    top: 0;
+    left: 0;
+    width: 100%;
+    height: 100%;
+    opacity: 0;
+  }
+
+  .image-remove {
+    transform: rotate(45deg);
+    width: 25px;
+    height: 25px;
+    position: absolute;
+    top: 0;
+    right: 0;
+    border-radius: 13px;
+    background-color: rgba(200, 200, 200, 0.8);
+  }
+
+  .item_width {
+    width: 130px;
+  }
+</style>
+
+```
+
+## 通用类型
+
+### GeneralCallbackResult @generalcallbackresult-values 
+
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| errMsg | string | 是 | 错误信息 |
+
+## 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) 来压缩。