[feat]微信小程序视频压缩功能

[xy3xy3]

https://developers.weixin.qq.com/miniprogram/dev/api/media/video/wx.compressVideo.html
官方是支持视频压缩的
但是mpxjs文档似乎只有图片压缩，没有视频压缩
https://mpxjs.cn/api-proxy/media/image/compressImage.html#%E5%8F%82%E6%95%B0

[xy3xy3]

deepwiki回复说可以通过下面方法实现：

答案
在 Mpx 中直接调用原生 wx.compressVideo 并自行做基础库兼容判断，可按以下步骤实现。

1. 判断基础库版本

使用 mpx.getSystemInfo 或 wx.getSystemInfo 获取 SDKVersion，并与目标版本比较 1 。

function compareVersion(v1, v2) {
  v1 = v1.split('.').map(Number)
  v2 = v2.split('.').map(Number)
  for (let i = 0; i < Math.max(v1.length, v2.length); i++) {
    const a = v1[i] || 0
    const b = v2[i] || 0
    if (a > b) return 1
    if (a < b) return -1
  }
  return 0
}

function isSDKVersionAtLeast(target) {
  try {
    const { SDKVersion } = wx.getSystemInfoSync()
    return compareVersion(SDKVersion, target) >= 0
  } catch {
    return false
  }
}

2. 判断接口存在

直接检查 wx.compressVideo 是否为函数。

const isCompressVideoSupported = typeof wx.compressVideo === 'function'

3. 调用示例（Promise 风格）

async function compressVideo(src, options = {}) {
  if (!isCompressVideoSupported || !isSDKVersionAtLeast('2.11.0')) {
    throw new Error('wx.compressVideo 不可用，请升级基础库至 2.11.0+')
  }
  return new Promise((resolve, reject) => {
    wx.compressVideo({
      src,
      quality: options.quality, // 低、中、高
      bitrate: options.bitrate,
      fps: options.fps,
      resolution: options.resolution,
      success: resolve,
      fail: reject,
      complete: options.complete
    })
  })
}

// 使用
try {
  const res = await compressVideo('/tmp/video.mp4', { quality: 'medium' })
  console.log('压缩后路径：', res.tempFilePath)
} catch (e) {
  console.warn('视频压缩失败：', e)
  // 降级：提示用户或跳过压缩
}

4. 降级兼容

在不支持的环境，可：

• 提示用户升级微信或基础库。
• 直接使用原视频。
• 尝试服务端压缩。

Notes

• Mpx 的 mpx 对象混入了 WechatMiniprogram.Wx 的方法，因此 wx 与 mpx 均可访问原生接口 2 。
• wx.compressVideo 从基础库 2.11.0 开始支持，Promise 风格调用受基础库支持，无需额外封装。
• 若希望跨平台统一，可参考 compressImage 在 @mpxjs/api-proxy 中的实现方式为 compressVideo 添加代理 3 。

Wiki pages you might want to explore:

• Overview (didi/mpx)

Citations

File: docs-vitepress/api-proxy/base/system/getSystemInfo.md (L1-90)

## mpx.getSystemInfo(Object object)
<font color="#fa5151" style="font-weight:bold;" size="2">微信小程序从基础库 <font style="color: #576b95;">2.20.1</font> 开始，该接口停止维护</font>

获取系统信息。

支持情况： 微信、支付宝、web、RN

[参考文档](https://developers.weixin.qq.com/miniprogram/dev/api/base/system/wx.getSystemInfo.html)

### 参数

**Object object**

属性	类型	默认值	必填	说明
| 属性    | 类型     | 默认值 | 必填 | 说明                 |
| ------- | -------- | ------ | ---- | -------------------- |
| success | function |        | 否   | 接口调用成功的回调函数 |
| fail    | function |        | 否   | 接口调用失败的回调函数 |
| complete| function |        | 否   | 接口调用结束的回调函数（调用成功、失败都会执行） |

**object.success 回调函数**

**参数**

**Object res**

<table>
  <thead>
    <tr>
      <th>属性</th>
      <th>类型</th>
      <th>说明</th>
      <th>最低版本</th>
      <th>支付宝</th>
      <th>RN</th>
      <th>web</th>
    </tr>
  </thead>
  <tbody>
    <tr><td>brand</td><td>string</td><td>设备品牌</td><td>1.5.0</td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: green; font-weight: bold;">✓</span></td><td><span style="color: green; font-weight: bold;">✓</span></td></tr>
    <tr><td>model</td><td>string</td><td>设备型号。新机型刚推出一段时间会显示unknown，微信会尽快进行适配。</td><td></td><td><span style="color: green; font-weight: bold;">✓</span></td><td><span style="color: green; font-weight: bold;">✓</span></td><td><span style="color: green; font-weight: bold;">✓</span></td></tr>
    <tr><td>pixelRatio</td><td>number</td><td>设备像素比</td><td></td><td><span style="color: green; font-weight: bold;">✓</span></td><td><span style="color: green; font-weight: bold;">✓</span></td><td><span style="color: green; font-weight: bold;">✓</span></td></tr>
    <tr><td>screenWidth</td><td>number</td><td>屏幕宽度，单位px</td><td>1.1.0</td><td><span style="color: green; font-weight: bold;">✓</span></td><td><span style="color: green; font-weight: bold;">✓</span></td><td><span style="color: green; font-weight: bold;">✓</span></td></tr>
    <tr><td>screenHeight</td><td>number</td><td>屏幕高度，单位px</td><td>1.1.0</td><td><span style="color: green; font-weight: bold;">✓</span></td><td><span style="color: green; font-weight: bold;">✓</span></td><td><span style="color: green; font-weight: bold;">✓</span></td></tr>
    <tr><td>windowWidth</td><td>number</td><td>可使用窗口宽度，单位px</td><td></td><td><span style="color: green; font-weight: bold;">✓</span></td><td><span style="color: green; font-weight: bold;">✓</span></td><td><span style="color: green; font-weight: bold;">✓</span></td></tr>
    <tr><td>windowHeight</td><td>number</td><td>可使用窗口高度，单位px</td><td></td><td><span style="color: green; font-weight: bold;">✓</span></td><td><span style="color: green; font-weight: bold;">✓</span></td><td><span style="color: green; font-weight: bold;">✓</span></td></tr>
    <tr><td>statusBarHeight</td><td>number</td><td>状态栏的高度，单位px</td><td>1.9.0</td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: green; font-weight: bold;">✓</span></td><td><span style="color: green; font-weight: bold;">✓</span></td></tr>
    <tr><td>language</td><td>string</td><td>微信设置的语言</td><td></td><td><span style="color: green; font-weight: bold;">✓</span></td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: red; font-weight: bold;">✗</span></td></tr>
    <tr><td>version</td><td>string</td><td>微信版本号</td><td></td><td><span style="color: green; font-weight: bold;">✓</span></td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: red; font-weight: bold;">✗</span></td></tr>
    <tr><td>system</td><td>string</td><td>操作系统及版本</td><td></td><td><span style="color: green; font-weight: bold;">✓</span></td><td><span style="color: green; font-weight: bold;">✓</span></td><td><span style="color: green; font-weight: bold;">✓</span></td></tr>
    <tr><td>platform</td><td>string</td><td>客户端平台</td><td></td><td><span style="color: green; font-weight: bold;">✓</span></td><td><span style="color: green; font-weight: bold;">✓</span></td><td><span style="color: green; font-weight: bold;">✓</span></td></tr>
    <tr>
      <td colspan="7">
        <table>
          <thead>
            <tr>
              <th>合法值</th>
              <th>说明</th>
              <th>支付宝</th>
              <th>RN</th>
              <th>web</th>
            </tr>
          </thead>
          <tbody>
            <tr><td>ios</td><td>iOS微信（包含 iPhone、iPad）</td><td><span style="color: green; font-weight: bold;">✓</span></td><td><span style="color: green; font-weight: bold;">✓</span></td><td><span style="color: green; font-weight: bold;">✓</span></td></tr>
            <tr><td>android</td><td>Android微信</td><td><span style="color: green; font-weight: bold;">✓</span></td><td><span style="color: green; font-weight: bold;">✓</span></td><td><span style="color: green; font-weight: bold;">✓</span></td></tr>
            <tr><td>ohos</td><td>HarmonyOS微信</td><td><span style="color: green; font-weight: bold;">✓</span></td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: red; font-weight: bold;">✗</span></td></tr>
            <tr><td>windows</td><td>Windows微信</td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: red; font-weight: bold;">✗</span></td></tr>
            <tr><td>mac</td><td>macOS微信</td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: red; font-weight: bold;">✗</span></td></tr>
            <tr><td>devtools</td><td>微信开发者工具</td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: red; font-weight: bold;">✗</span></td></tr>
          </tbody>
        </table>
      </td>
    </tr>
    <tr><td>fontSizeSetting</td><td>number</td><td>用户字体大小（单位px）。以微信客户端「我-设置-通用-字体大小」中的设置为准</td><td>1.5.0</td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: red; font-weight: bold;">✗</span></td></tr>
    <tr><td>SDKVersion</td><td>string</td><td>客户端基础库版本</td><td>1.1.0</td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: red; font-weight: bold;">✗</span></td></tr>
    <tr><td>benchmarkLevel</td><td>number</td><td>设备性能等级（仅 Android）。取值为：-2 或 0（该设备无法运行小游戏），-1（性能未知），>=1（设备性能值，该值越高，设备性能越好）<br>注意：性能等级当前仅反馈真机机型，暂不支持 IDE 模拟器机型</td><td>1.8.0</td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: red; font-weight: bold;">✗</span></td></tr>
    <tr><td>albumAuthorized</td><td>boolean</td><td>允许微信使用相册的开关（仅 iOS 有效）</td><td>2.6.0</td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: red; font-weight: bold;">✗</span></td></tr>
    <tr><td>cameraAuthorized</td><td>boolean</td><td>允许微信使用摄像头的开关</td><td>2.6.0</td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: red; font-weight: bold;">✗</span></td></tr>
    <tr><td>locationAuthorized</td><td>boolean</td><td>允许微信使用定位的开关</td><td>2.6.0</td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: red; font-weight: bold;">✗</span></td></tr>
    <tr><td>microphoneAuthorized</td><td>boolean</td><td>允许微信使用麦克风的开关</td><td>2.6.0</td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: red; font-weight: bold;">✗</span></td></tr>
    <tr><td>notificationAuthorized</td><td>boolean</td><td>允许微信通知的开关</td><td>2.6.0</td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: red; font-weight: bold;">✗</span></td></tr>
    <tr><td>notificationAlertAuthorized</td><td>boolean</td><td>允许微信通知带有提醒的开关（仅 iOS 有效）</td><td>2.6.0</td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: red; font-weight: bold;">✗</span></td></tr>
    <tr><td>notificationBadgeAuthorized</td><td>boolean</td><td>允许微信通知带有标记的开关（仅 iOS 有效）</td><td>2.6.0</td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: red; font-weight: bold;">✗</span></td></tr>
    <tr><td>notificationSoundAuthorized</td><td>boolean</td><td>允许微信通知带有声音的开关（仅 iOS 有效）</td><td>2.6.0</td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: red; font-weight: bold;">✗</span></td></tr>
    <tr><td>phoneCalendarAuthorized</td><td>boolean</td><td>允许微信使用日历的开关</td><td>2.19.3</td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: red; font-weight: bold;">✗</span></td></tr>
    <tr><td>bluetoothEnabled</td><td>boolean</td><td>蓝牙的系统开关</td><td>2.6.0</td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: red; font-weight: bold;">✗</span></td></tr>
    <tr><td>locationEnabled</td><td>boolean</td><td>地理位置的系统开关</td><td>2.6.0</td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: red; font-weight: bold;">✗</span></td></tr>
    <tr><td>wifiEnabled</td><td>boolean</td><td>Wi-Fi 的系统开关</td><td>2.6.0</td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: red; font-weight: bold;">✗</span></td></tr>
    <tr><td>safeArea</td><td>Object</td><td>在竖屏正方向下的安全区域。部分机型没有安全区域概念，也不会返回 safeArea 字段，开发者需自行兼容。</td><td>2.7.0</td><td><span style="color: red; font-weight: bold;">✗</span></td><td><span style="color: green; font-weight: bold;">✓</span></td><td><span style="color: red; font-weight: bold;">✗</span></td></tr>

File: packages/api-proxy/@types/index.d.ts (L26-31)

declare module '@mpxjs/core' {
  interface Mpx extends AddPromise<WechatMiniprogram.Wx> {
    getLocation: AddParam<GetLocationInterface, PickApiValue<'getLocation'>>
    requestPayment: AddParam<RequestPaymentInterface, PickApiValue<'requestPayment'>>
  }
}

File: docs-vitepress/api-proxy/media/image/compressImage.md (L1-7)

## mpx.compressImage(Object object)

压缩图片接口，可选压缩质量。iOS 仅支持压缩 JPG 格式图片。

支持情况： 微信、支付宝

[参考文档](https://developers.weixin.qq.com/miniprogram/dev/api/media/image/wx.compressImage.html)