更新记录

1.0.0（2026-08-26）

百搜速推短视频拍摄组件 · 发布表单参数 ══════════════════════════════════════ 【一、基础信息】

显示名称：百搜速推短视频拍摄组件 因各手机厂商兼容性能不一样，遇到问题联系百搜客服处理。

────────────────────────────────────── 【二、简介】（表单「简介」框） ──────────────────────────────────────

百搜速推短视频拍摄组件是面向 uni-app 的页内原生拍摄 UTS 插件，提供 CameraX/AVFoundation 级预览、录像、拍照与镜头控制能力，适合短视频拍摄、直播前置采集、社交内容创作等场景。

核心能力：页内组件 sutui-short-video-camera；视频录制（时长 3～300 秒、720p～4k、横竖屏、防抖、麦克风开关）；拍照；前后摄切换、闪光灯、变焦、曝光；自研相册媒体扫描与缩略图预取；完整生命周期 API。

采用 UTS 插件格式上架（可付费加密）。购买后绑定 AppID 与包名，云打包即可使用。实时美颜请另购「百搜速推美颜引擎」插件。Android arm64 正式能力；iOS API 对齐。

────────────────────────────────────── 【三、更新日志】 ──────────────────────────────────────

首发百搜速推短视频拍摄 UTS 插件（sutuyun-ShortVideoCam）。

以官方 UTS 格式上架，支持普通授权付费与云打包加密。 新增页内原生相机组件 sutui-short-video-camera（Android CameraX / iOS AVFoundation）。 新增视频录制：最长 3～300 秒，支持 720p / 1080p / 2k / 4k 成片档位。 新增横竖屏拍摄模式、画面防抖、麦克风开关。 新增拍照、前后摄切换、闪光灯、双指变焦、曝光补偿。 新增相册媒体扫描 listAlbumMedia 与缩略图预取 ensureAlbumThumbs。 新增 restartSession、releaseHost 等生命周期接口。 业务侧通过 import from '@/uni_modules/sutuyun-ShortVideoCam' 调用模块 API。 提供 readme 与示例工程。美颜能力请另购 sutuyun-BeautyEngin。

适用：短视频拍摄、直播开播采集、社交 App 内容创作。

────────────────────────────────────── 【四、关键词】 ──────────────────────────────────────

拍摄, 相机, 录像, 短视频, CameraX, 拍照, 相册

────────────────────────────────────── 【五、平台兼容（勾选参考）】 ──────────────────────────────────────

App-vue：支持 App-nvue：支持（推荐，组件页内挂载） App-鸿蒙：不支持 H5：不支持 小程序：不支持 Android ABI：仅 arm64-v8a iOS：arm64，iOS 12.0+

────────────────────────────────────── 【六、系统权限】 ──────────────────────────────────────

Android： android.permission.CAMERA android.permission.RECORD_AUDIO android.permission.WRITE_EXTERNAL_STORAGE android.permission.READ_EXTERNAL_STORAGE android.permission.READ_MEDIA_IMAGES android.permission.READ_MEDIA_VIDEO

iOS： NSCameraUsageDescription（相机，用于拍摄照片与视频） NSMicrophoneUsageDescription（麦克风，用于视频录制收音）

说明：相机、麦克风、相册/媒体读写权限由宿主 App 按拍摄、选素材、导出场景申请。

类型：UTS 插件（含原生组件 sutui-short-video-camera）

能力概览

详见 上传材料/06-拍摄功能清单-完整版.txt。

不含：美颜（另购 sutuyun-BeautyEngin）、滤镜 UI、贴纸 UI、配乐、发布上传。

快速接入

1. 挂载组件（nvue 推荐）

<sutui-short-video-camera
  device-position="front"
  flash="off"
  :max-duration="60"
  @ready="onReady"
  @recordstart="onRecordStart"
  @recordstop="onRecordStop"
  @photo="onPhoto"
  @error="onError"
/>

2. 模块 API

import {
  startRecord,
  stopRecord,
  takePhoto,
  setFacing,
  setCaptureQuality,
  setVideoStabilization,
  listAlbumMedia
} from '@/uni_modules/sutuyun-ShortVideoCam'

3. 与美颜叠加

先购买并导入 sutuyun-BeautyEngin，在拍摄页初始化美颜引擎；本相机负责采集，美颜负责画面处理。

平台

• Android arm64-v8a（正式）
• iOS arm64（API 对齐）
• 不支持 H5 / 小程序

授权

普通授权版，云打包绑定 AppID + 包名。

平台兼容性

uni-app(3.8.2)

上架上传清单（UTS 插件 · 短视频拍摄）

核对

• 插件 ID：sutuyun-ShortVideoCam
• zip 根目录：package.json + utssdk/（正斜杠，无外层文件夹）
• ABI：仅 arm64-v8a
• 示例 manifest：appid 为空

发版前

1. 编译 AAR/Framework 放入 utssdk/.../libs
2. scripts/build-plugin-zip.ps1
3. 检查 zip 含 utssdk/app-android/libs/*.aar