直播云 > API 文档 > 服务端 API >保存直播截图

保存直播截图

最近更新时间：2018-12-19 11:04:25

把指定时间点的直播截图保存到bucket里

规格

请求包:

POST /v2/hubs/<Hub>/streams/<EncodedStreamTitle>/snapshot
Host: pili.qiniuapi.com
Authorization: <QiniuToken>
Content-Type: application/json

{
    "fname": "<Fname>",
    "time": <Time>,
    "format": "<Format>",
    "deleteAfterDays": <DeleteAfterDays>
}

参数名称	必填	说明
Hub	是	直播空间名
EncodedStreamTitle	是	对流名做URL 安全的 Base64 编码后得到的字符串
fname	否	保存到存储空间的文件名，不指定系统会随机生成
time	否	整数，Unix 时间戳，要保存截图的时间点，不指定则为当前时间
format	否	保存的文件格式，默认为jpg
deleteAfterDays	否	表示截图文件生命周期，0表示永久保存，时间单位是天

返回包:

200 {
    "fname": "<Fname>"
}

fname: 字符串，表示保存后在存储空间里的文件名。使用存储空间的下载域名可以访问这文件，形如: http://<DownloadDomainOfStorageBucket>/<Fname>

示例

请求包:

POST /v2/hubs/PiliSDKTest/streams/dGVzdDE=/snapshot HTTP/1.1
Host: pili.qiniuapi.com
User-Agent: pili-sdk-go/v2 go1.7.1 darwin/amd64
Content-Length: 21
Authorization: Qiniu Ge_kRfuV_4JW0hOCOnRq5_kD1sX53bKVht8FNdd3:GKGr2LYh1154QGQD9gyi0wtUPkw=
Content-Type: application/json
Accept-Encoding: gzip

{"fname":"test1.jpg"}

返回包:

HTTP/1.1 200 OK
Content-Length: 21
Content-Type: application/json
Date: Mon, 27 Feb 2017 06:29:49 GMT
X-Reqid: HBTICsCeXcezWNYs

{"fname":"test1.jpg"}

以上内容是否对您有帮助？