---
title: 视频主体突出方案 - 视频资源导入
summary: 视频主体突出方案的视频资源导入模块，依赖 chooseMedia（实时录制/相册导入）和 clipVideo（预标准化分辨率与角度）两个关键能力。含交互流程时序图及注意事项：isFetchVideoFile 参数兼容性、clipVideo 的 endTime 毫秒单位转换和 level 压缩分辨率等级（建议选用 4 即 1080*1920）。
---

## 视频资源导入

<div style="marginTop: 20px;">
<video controls width="250">
  <source src="https://images.tuyacn.com/rms-static/d290e710-0f99-11f0-9f57-5d628208d2a7-1743581378561.mp4?tyName=input_video.mp4" type="video/mp4">
  您的浏览器不支持视频标签
</video>
</div>

### 功能介绍

视频资源在初始化导入阶段依赖以下两个关键能力：

- 1.用户素材采集

  - [chooseMedia](https://developer.tuya.com/cn/miniapp/develop/ray/api/media/image/chooseMedia#choosemedia) :支持C端用户通过实时录制视频或从手机相册导入的方式，提交原始视频素材。

- 2.视频预标准化处理
  - [clipVideo](/cn/miniapp/develop/ray/api/media/video/clipVideo) :自动统一源视频的分辨率与角度，避免因格式差异导致后续AI视频生成流程出现异常。

### 交互流程

```mermaid
sequenceDiagram
rect rgb(191, 223, 255)
    面板->>App: 1. 请求视频资源（拍摄/相册）
    App->>系统: 2. 调用系统API（相机/相册权限）
    系统-->>App: 返回原始视频资源
    App->>App: 3. 复制视频到沙盒
    App->>App: 4. 预标准化处理（分辨率/角度）
    App-->>面板: 5. 返回处理后视频地址
end

rect rgb(200, 150, 255)
    Note right of 面板: 用户交互层
    Note left of 系统: 系统服务层
end
```

### 注意事项

- 1.在使用 **chooseMedia** API时，为更好的兼容IOS、安卓双端系统，请默认将参数 **isFetchVideoFile** 传入true;

- 2.在使用 **clipVideo** API时

  - （1）参数 **endTime** 的时间单位为毫秒，而 **chooseMedia** API返回的视频时长为妙，请注意单位转换;
  - （2）参数 **level** 表示目标视频的压缩分辨率等级：
    - 1 代表480*854 码率：1572*1000
    - 2 代表540*960 码率：2128*1000
    - 3 代表720*1280 码率：3145*1000
    - 4 代表1080*1920 码率：3500*1000
    - 为确保输出视频的清晰度，此入参建议选用4。