对象存储
有奖捉虫：办公协同&微信生态&物联网文档专题 HOT
文档中心 > 对象存储 > SDK 文档 > PHP SDK > 媒体处理 > 媒体截图接口

媒体截图接口

最近更新时间：2023-11-23 19:42:35

我的收藏

本页目录：

简介

本文档提供获取媒体文件某个时间的截图的代码示例。
注意
需要 COS PHP SDK v2.3.2 及以上版本。旧版本可能存在 bug，使用时建议升级到 最新版本。
API
操作名
操作描述
查询截图
用于查询媒体文件在某个时间的截图

查询截图

功能说明

用于查询媒体文件在某个时间的截图。

使用示例

<?php

require dirname(__FILE__) . '/../vendor/autoload.php';

$secretId = "SECRETID"; //替换为用户的 secretId，请登录访问管理控制台进行查看和管理，https://console.cloud.tencent.com/cam/capi
$secretKey = "SECRETKEY"; //替换为用户的 secretKey，请登录访问管理控制台进行查看和管理，https://console.cloud.tencent.com/cam/capi
$region = "ap-beijing"; //替换为用户的 region，已创建桶归属的region可以在控制台查看，https://console.cloud.tencent.com/cos5/bucket
$cosClient = new Qcloud\\Cos\\Client(
    array(
        'region' => $region,
        'scheme' => 'https', //协议头部，默认为http
        'credentials'=> array(
            'secretId'  => $secretId ,
            'secretKey' => $secretKey)));

$time = 3.14; //视频截帧时间点
try {
    $result = $cosClient->getSnapshot(
        array(
            'Bucket' => 'examplebucket-1250000000', //存储桶名称，由BucketName-Appid 组成，可以在COS控制台查看 https://console.cloud.tencent.com/cos5/bucket
            'Key' => 'exampleobject', //媒体文件对象路径,如folder/movie.mp4
            'ci-process' => 'snapshot', //操作类型，固定使用 snapshot
            'Time' => $time, //视频截帧时间点
            'SaveAs' => '/data/test.jpg', //截图保存到本地的路径
        )
    );
    // 请求成功
    echo($result);
} catch (\\Exception $e) {
    // 请求失败
    echo($e);
}

参数说明

参数名
参数描述
类型
是否必填
Bucket
存储桶的名称，命名规则为 BucketName-APPID，此处填写的存储桶名称必须为此格式
String
是
Key
对象键（Object 的名称），这里的形式为媒体文件。对象在存储桶中的唯一标识，详情请参见 对象概述
String
是
ci-process
操作类型，固定使用 snapshot
String
是
Time
视频截帧时间点
float
是
SaveAs
截图保存到本地的路径
String
是

返回结果示例

GuzzleHttp\\Command\\Result Object
(
    [Body] => GuzzleHttp\\Psr7\\Stream Object
        (
            [stream:GuzzleHttp\\Psr7\\Stream:private] => Resource id #91
            [size:GuzzleHttp\\Psr7\\Stream:private] => 
            [seekable:GuzzleHttp\\Psr7\\Stream:private] => 1
            [readable:GuzzleHttp\\Psr7\\Stream:private] => 1
            [writable:GuzzleHttp\\Psr7\\Stream:private] => 1
            [uri:GuzzleHttp\\Psr7\\Stream:private] => php://temp
            [customMetadata:GuzzleHttp\\Psr7\\Stream:private] => Array
                (
                )

        )

    [ContentLength] => 153613
    [ContentType] => image/jpeg
    [RequestId] => NjE0NThmNGNfNWIyZjJjMGJfNTE1MV84YmJlODI=
    [Key] => exampleobject
    [Bucket] => examplebucket-1250000000
    [Location] => examplebucket-1250000000.cos.ap-guangzhou.myqcloud.com/exampleobject
)

中国站