bowong
/
mxivideo
6
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
mxivideo/docs/IMPORT_MATERIAL_GUIDE.md

6.3 KiB
Raw Permalink Blame History

项目素材导入功能使用指南

🎯 功能概述

项目素材导入功能允许用户为特定项目批量导入视频素材，支持选择模特关联、自动标签和自动分镜功能，大大提升素材管理效率。

🚀 功能特点

1. 灵活的文件选择

  • 单文件/多文件选择: 支持选择一个或多个视频文件
  • 文件夹批量导入: 选择整个文件夹进行批量导入
  • 格式支持: 支持 MP4、AVI、MOV、MKV、WMV、FLV、WebM、M4V 等主流视频格式

2. 智能关联功能

  • 项目自动关联: 导入的素材自动关联到当前项目
  • 模特标签关联: 可选择关联的模特，自动添加模特标签
  • 项目标签: 自动添加项目商品名作为标签

3. 自动分镜功能

  • 智能分镜: 自动将长视频分割成多个片段
  • 场景识别: 基于场景变化进行分镜
  • 便于编辑: 分镜后的片段更适合后续编辑使用

4. 标签管理

  • 自定义标签: 可添加自定义标签
  • 自动标签: 系统自动添加项目和模特相关标签
  • 标签预览: 实时预览将要添加的标签

📍 使用位置

在项目详情页面的素材管理区域，点击右上角的"导入素材"按钮即可打开导入功能。

🔧 使用步骤

步骤1: 打开导入功能

  1. 进入项目详情页面
  2. 在素材管理区域找到"导入素材"按钮
  3. 点击按钮打开导入模态框

步骤2: 选择素材文件

有两种选择方式：

方式A: 选择单个或多个文件

  1. 点击"选择文件"按钮
  2. 在文件选择对话框中选择视频文件
  3. 支持按住Ctrl/Cmd键多选文件

方式B: 选择整个文件夹

  1. 点击"选择文件夹"按钮
  2. 选择包含视频文件的文件夹
  3. 系统会自动扫描文件夹中的所有支持格式的视频文件

步骤3: 配置导入选项

关联模特（可选）

  • 勾选要关联的模特
  • 选中的模特标签会自动添加到导入的素材中
  • 有助于后续按模特筛选素材

添加标签（可选）

  • 在标签输入框中输入自定义标签
  • 按回车键或点击"+"按钮添加标签
  • 可添加多个标签，点击标签上的删除按钮可移除

自动分镜设置

  • 默认启用自动分镜功能
  • 取消勾选可禁用自动分镜
  • 启用后长视频会被自动分割成多个片段

步骤4: 开始导入

  1. 确认所有配置无误
  2. 点击"开始导入"按钮
  3. 等待导入完成

📊 导入过程

1. 文件验证

  • 检查文件格式是否支持
  • 验证文件完整性
  • 过滤不支持的文件

2. 素材处理

  • 提取视频元数据（时长、分辨率、帧率等）
  • 生成MD5哈希值防重复
  • 创建缩略图

3. 自动分镜（如果启用）

  • 分析视频场景变化
  • 智能确定分镜点
  • 生成多个视频片段

4. 标签处理

  • 添加项目相关标签
  • 添加模特相关标签
  • 添加用户自定义标签

5. 数据存储

  • 保存素材信息到数据库
  • 建立项目关联关系
  • 更新素材统计

📋 导入结果

导入完成后会显示详细的结果信息：

成功信息

  • 总文件数: 尝试导入的文件总数
  • 成功导入: 成功导入的文件数量
  • 生成片段: 自动分镜生成的片段数量
  • 跳过文件: 因重复或其他原因跳过的文件
  • 失败文件: 导入失败的文件数量

错误信息

如果有文件导入失败，会显示具体的错误信息，包括：

  • 文件名
  • 失败原因
  • 建议解决方案

🎯 最佳实践

1. 文件组织

  • 统一命名: 使用有意义的文件名
  • 分类存放: 按类型或用途组织文件夹
  • 避免特殊字符: 文件名避免使用特殊字符

2. 标签策略

  • 描述性标签: 使用描述性的标签名称
  • 统一规范: 团队内部统一标签命名规范
  • 分层标签: 使用分层的标签体系

推荐标签示例:

类型标签: 产品展示、人物介绍、场景拍摄
风格标签: 商务、休闲、时尚、科技
用途标签: 主视频、背景素材、转场素材

3. 模特关联

  • 准确关联: 确保选择正确的模特
  • 完整关联: 包含该模特的素材都应该关联
  • 及时更新: 新增模特后及时关联相关素材

4. 自动分镜

  • 长视频启用: 对于超过1分钟的视频建议启用
  • 短视频禁用: 对于短视频可以禁用以保持完整性
  • 后期调整: 可在导入后手动调整分镜结果

🔍 故障排除

问题1: 文件选择失败

可能原因:

  • 文件路径包含特殊字符
  • 文件被其他程序占用
  • 权限不足

解决方案:

  1. 检查文件路径，避免特殊字符
  2. 关闭可能占用文件的程序
  3. 确保有足够的文件访问权限

问题2: 导入失败

可能原因:

  • 文件格式不支持
  • 文件损坏
  • 磁盘空间不足
  • 网络连接问题

解决方案:

  1. 确认文件格式在支持列表中
  2. 检查文件完整性
  3. 确保有足够的磁盘空间
  4. 检查网络连接状态

问题3: 自动分镜效果不佳

可能原因:

  • 视频场景变化不明显
  • 视频质量较低
  • 分镜参数不合适

解决方案:

  1. 对于场景单一的视频可禁用自动分镜
  2. 提高视频质量
  3. 手动调整分镜结果

问题4: 标签丢失

可能原因:

  • 导入过程中断
  • 标签格式错误
  • 系统异常

解决方案:

  1. 重新导入素材
  2. 检查标签格式
  3. 手动添加丢失的标签

🚀 高级功能

批量操作

  • 支持同时导入多个文件夹
  • 支持批量设置标签和模特关联
  • 支持批量启用/禁用自动分镜

导入模板

  • 保存常用的导入配置
  • 快速应用预设配置
  • 团队共享导入模板

进度监控

  • 实时显示导入进度
  • 支持暂停和恢复导入
  • 详细的处理日志

📈 性能优化

导入速度优化

  • 小批量导入: 避免一次导入过多文件
  • 网络稳定: 确保网络连接稳定
  • 系统资源: 确保系统有足够的内存和CPU资源

存储优化

  • 定期清理: 定期清理不需要的素材
  • 压缩设置: 合理设置视频压缩参数
  • 分布存储: 大量素材可考虑分布式存储

通过项目素材导入功能，您可以高效地管理项目素材，提升视频制作效率！