简介
本文档提供获取媒体文件某个时间的截图的代码示例。
注意
API | 操作名 | 操作描述 |
查询截图 | 用于查询媒体文件在某个时间的截图 |
查询截图
功能说明
用于查询媒体文件在某个时间的截图。
使用示例
<?phprequire 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,'schema' => '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)