如何利用智能媒体管理中的媒体转码接口来实现将视频截帧保存为静态图片

本文介绍了如何利用智能媒体管理（IMM）中的媒体转码接口来实现将视频截帧保存为静态图片的功能。

功能简介

视频截帧是指从视频中提取特定帧图像的过程，其目的是将视频中某一特定时刻的画面保存为静态图片。

使用场景

快照：将视频中的特定时刻保存为静态图像，以此制作海报。
分析：提取关键帧以便进行后续分析，例如人脸识别、物体检测等。
封面制作：为视频创建缩略图或封面图。
播放总结：从视频中筛选多个关键时刻，以生成简洁的总结或预览。
截图分享与记录：用户在观看视频时，如果遇到喜欢的画面希望进行保存或分享，可以通过截取该时刻的视频帧来实现。

支持音视频格式列表

分类	格式

分类	格式
音频	AAC、MP3、WAV、FLAC、WMA、AC3、OPUS等所有主流格式。
视频	MP4、MPEG-TS、MKV、MOV、AVI、FLV、M3U8、WebM、WMV、RM、VOB等所有主流格式。

如何使用

前提条件

已创建并获取AccessKey。具体操作，请参见创建AccessKey。
已开通OSS服务、创建存储空间。具体操作，请参见创建存储空间。
已开通智能媒体管理服务。具体操作，请参见开通产品。
已通过智能媒体管理控制台创建项目。具体操作，请参见创建项目。
说明
- 您也可以调用API接口创建项目。具体操作，请参见CreateProject - 创建项目。
- 您可以调用ListProjects - 列出所有项目信息的列表接口列出指定地域下已创建的所有项目信息。

步骤一：上传文件

请使用OSS管理控制台将媒体文件上传至IMM项目所在地域的Bucket。

步骤二：使用IMM视频截帧

调用CreateMediaConvertTask - 创建媒体转码任务接口创建视频截帧任务。

参数说明

以下示例使用IMM项目的test-project，针对视频文件oss://test-bucket/video-demo/酿酒.mov进行视频截帧处理。更多有关媒体处理各功能介绍和使用，请参见概述。

说明

您可以通过OpenAPI 门户使用媒体转码接口对视频文件进行处理，具体可参考SDK代码。
视频截帧请勿设置Target.URI和Target.Container参数。
Targets中URI文件名建议使用变量设置为snapshot-{index}.{autoext}格式，截帧保存后将生成snapshot-1.png、snapshot-2.png这种文件名，相关变量请参见TargetURI模板。

截取一帧用于视频封面

截取一帧以作为视频封面，确保该图片的分辨率与视频保持一致。

截帧图片格式：jpg
截帧起始时间：5秒
截帧数量：1
截帧图片保存路径：oss://test-bucket/video-demo/cover.jpg
截帧完成消息通知：发送MNS消息到MNS主题“test-mns-topic”

SDK示例请参见OpenAPI门户，已为您自动填充示例参数，请根据实际需求进行修改后再进行调试。

请求参数代码示例如下：

{
  "ProjectName": "test-project",
  "Notification": {  
    "MNS": {    
      "TopicName": "test-mns-topic" 
    }
  },
  "Sources": [
    {
      "URI": "oss://test-bucket/video-demo/酿酒.mov"
    }
  ],
  "Targets": [
    {
      "Image": {
        "Snapshots": [
          {
            "Format": "jpg",
            "StartTime": 5,
            "Number": 1,
            "URI": "oss://test-bucket/video-demo/cover.jpg"
          }
        ]
      }
    }
  ]
}

每10秒截1帧图片用于AI模型训练或推理

每10秒截取一帧图像，用于AI模型的训练或推理，输出图像的分辨率限制为512x512。

截帧图片格式：jpg
截帧间隔：10秒
缩放方式：缩放并裁剪，缩放方式说明请参见缩放方式。
输出图片宽度：512px
输出图片高度：512px
截帧图片保存路径：oss://test-bucket/video-demo/snapshot-%d.png
截帧完成消息通知：发送MNS消息到MNS主题“test-mns-topic”

SDK示例请参见OpenAPI门户，已为您自动填充示例参数，请根据实际需求进行修改后再进行调试。

请求参数代码示例如下：

{
  "ProjectName": "test-project",
  "Notification": {  
    "MNS": {    
      "TopicName": "test-mns-topic"  
    }
  },
  "Sources": [
    {
      "URI": "oss://test-bucket/video-demo/酿酒.mov"
    }
  ],
  "Targets": [
    {
      "Image": {
        "Snapshots": [
          {
            "Format": "jpg",
            "Interval": 10,
            "ScaleType": "crop",
            "URI": "oss://test-bucket/video-demo/snapshot-{index}.{autoext}",
            "Width": 512,
            "Height": 512
          }
        ]
      }
    }
  ]
}

每隔4秒截1帧，共截5帧用于分析视频片段

从第11秒开始，每隔4秒截取1帧，共截取5帧用于分析视频片段。输出的图片宽高为视频分辨率的1/2，并保存为PNG格式图片。

截帧图片格式：png
截帧起始时间：第11秒
截帧间隔：4秒
截帧数量：5
缩放方式：缩放并裁剪，缩放方式说明请参见缩放方式
输出图片宽度：原视频分辨率宽度的1/2
输出图片高度：原视频分辨率高度的1/2
截帧图片保存路径：oss://test-bucket/video-demo/snapshot-%d.png
截帧完成消息通知：发送MNS消息到MNS主题“test-mns-topic”

SDK示例请参见OpenAPI门户，已为您自动填充示例参数，请根据实际需求进行修改后再进行调试。

请求参数代码示例如下：

{
  "ProjectName": "test-project",
  "Notification": {  
    "MNS": {    
      "TopicName": "test-mns-topic"
    }
  },
  "Sources": [
    {
      "URI": "oss://test-bucket/video-demo/酿酒.mov"
    }
  ],
  "Targets": [
    {
      "Image": {
        "Snapshots": [
          {
            "Format": "png",
            "StartTime": 11,
            "Interval": 4,
            "Number": 5,
            "ScaleType": "crop",
            "URI": "oss://test-bucket/video-demo/snapshot-{index}.{autoext}",
            "Width": 0.5,
            "Height": 0.5
          }
        ]
      }
    }
  ]
}

截取音频封面

输出图片格式：jpg
截帧数量：1
输出图片保存路径：oss://test-bucket/video-demo/cover.jpg
截帧完成消息通知：发送MNS消息到MNS主题“test-mns-topic”

SDK示例请参见OpenAPI门户，已为您自动填充示例参数，请根据实际需求进行修改后再进行调试。

请求参数代码示例如下：

{
  "ProjectName": "test-project",
  "Notification": {  
    "MNS": {    
      "TopicName": "test-mns-topic"  
    }
  },
  "Sources": [
    {
      "URI": "oss://test-bucket/video-demo/test.mp3"
    }
  ],
  "Targets": [
    {
      "Image": {
        "Snapshots": [
          {
            "Format": "jpg",
            "Number": 1,
            "URI": "oss://test-bucket/video-demo/cover.jpg"
          }
        ]
      }
    }
  ]
}