视频截帧功能可以从视频流中截取指定时刻的单帧画面，并按指定大小缩放成图片。本文介绍如何通过 TOS Go SDK 进行视频截帧。

示例代码

以下代码展示如何截取第 300ms 的视频帧，并将截取后的图片命名为 temp.jpg，并下载到本地。

package main

import (
    "context"
    "fmt"
    "github.com/volcengine/ve-tos-golang-sdk/v2/tos"
)

func checkErr(err error) {
    if err != nil {
       if serverErr, ok := err.(*tos.TosServerError); ok {
          fmt.Println("Error:", serverErr.Error())
          fmt.Println("Request ID:", serverErr.RequestID)
          fmt.Println("Response Status Code:", serverErr.StatusCode)
          fmt.Println("Response Header:", serverErr.Header)
          fmt.Println("Response Err Code:", serverErr.Code)
          fmt.Println("Response Err Msg:", serverErr.Message)
       } else {
          fmt.Println("Error:", err)
       }
       panic(err)
    }
}

func main() {
    var (
       accessKey = os.Getenv("TOS_ACCESS_KEY")
       secretKey = os.Getenv("TOS_SECRET_KEY")
       // Bucket 所在区域对应的 Endpoint，以华北2（北京）为例，则为 https://tos-cn-beijing.volces.com。
       endpoint = "https://tos-cn-beijing.volces.com"
       region   = "cn-beijing"
       // 填写 BucketName
       bucketName = "*** Provide your bucket name ***"

       // 视频名称
       videoKey = "video.mp4"
       ctx      = context.Background()
       // 截取后的图片名称
       fileName = "temp.jpg"
    )
    // 初始化客户端
    client, err := tos.NewClientV2(endpoint, tos.WithRegion(region), tos.WithCredentials(tos.NewStaticCredentials(accessKey, secretKey)))
    checkErr(err)

    // 请求并增加数据处理
    style := "video/snapshot,t_300" /* 视频截帧，截取第 300ms 的视频帧 */
    // 保存截帧图片到指定路径
    _, err = client.GetObjectToFile(ctx, &tos.GetObjectToFileInput{GetObjectV2Input: tos.GetObjectV2Input{Bucket: bucketName, Key: videoKey, Process: style}, FilePath: fileName})
    checkErr(err)

}

相关文档

关于视频截帧的详细介绍，请参见视频截帧。