tencent cloud

PrevNext

masukan

cari berdasarkan kata kunci

Recent Pages

Dokumentasi
Cloud Object Storage
    Dokumentasi
    Download PDF

    Getting Media File Screenshot (CI Domain Name)

    Terakhir diperbarui:2022-05-23 14:27:24
    Unduh PDF

      Feature Description

      This API (GenerateSnapshot) is used to get a screenshot of a media file at some time point. All output screenshots are in JPEG format.

      Request

      Sample request

      POST /snapshot HTTP/1.1
Host: <BucketName-APPID>.ci.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
Content-Length: <length>
Content-type: application/xml
<body>
      Note：

      Authorization: Auth String (for more information, see Request Signature).

      Request headers

      This API only uses common request headers. For more information, see Common Request Headers.

      Request body

      Nodes of the request body for this API are as follows:

      <Request>
<Input>
  <Object></Object>
</Input>
<Time></Time>
<Width></Width>
<Height></Height>
<Mode></Mode>
<Rotate></Rotate>
<Format></Format>
<Output>
  <Region></Region>
  <Bucket></Bucket>
  <Object></Object>
</Output>
</Request>

      The nodes are as described below:

      Node Name (Keyword) Parent Node Description Type Required
      Request None Generate Snapshot request container Container Yes

      Request has the following sub-nodes:

      Node Name (Keyword) Parent Node Description Type Required
      Input Request Media file location information. Container Yes
      Time Request Screenshot time point in seconds. Float Yes
      Output Request Screenshot storage location information. Container Yes
      Width Request Screenshot width. Default value: 0. Int No
      Height Request Screenshot height. Default value: 0.
      If Width and Height are both 0, the width and height of the video are used.
      If one of them is 0, the other value is used to automatically adapt to the aspect ratio of the video.      		 Int No
      Format Request Screenshot format. Valid values: jpg, png. Default value: jpg. String No
      Mode Request Frame capturing method:
    • keyframe: Capture the last keyframe before the specified time point.
    • exactframe: Capture the frame at a specified time point.
      • Default value: exactframe      		 String No
      Rotate Request Image rotation method:
    • auto: Rotate automatically according to the video rotation information.
    • off: Do not rotate.
      Default value: auto
      		•  String No

      Input has the following sub-nodes:

      Node Name (Keyword) Parent Node Description Type Required
      Object Request.Input Filename String Yes

      Output has the following sub-nodes:

      Node Name (Keyword) Parent Node Description Type Required
      Region Request.Output Bucket region String Yes
      Bucket Request.Output File bucket String Yes
      Object Request.Output Filename String Yes

      Response

      Response headers

      This API only returns common response headers. For more information, see Common Response Headers.

      Response body

      The response body returns application/xml data. The following contains all the nodes:

      <Response>
<Output>
  <Region></Region>
  <Bucket></Bucket>
  <Object></Object>
</Output>
</Response>

      The nodes are as described below:

      Node Name (Keyword) Parent Node Description Type
      Response None Response container Container

      Response has the following sub-nodes:

      Node Name (Keyword) Parent Node Description Type
      Output Request Screenshot storage location information Container

      Output has the following sub-nodes:

      Node Name (Keyword) Parent Node Description Type
      Region Response.Output Bucket region String
      Bucket Response.Output File bucket String
      Object Response.Output Filename String

      Error codes

      There are no special error messages for this request. For common error messages, see Error Codes.

      Use Cases

      Request

      POST /snapshot HTTP/1.1
Host: examplebucket-1250000000.ci.ap-beijing.myqcloud.com
Date: Fri, 10 Mar 2016 09:45:46 GMT
Authorization: q-sign-algorithm=sha1&q-ak=AKIDWtTCBYjM5OwLB9CAwA1Qb2ThTSUj****&q-sign-time=1484213027;32557109027&q-key-time=1484213027;32557109027&q-header-list=host&q-url-param-list=acl&q-signature=dcc1eb2022b79cb2a780bf062d3a40e120b4****
Content-Length: 552
Content-Type: application/xml
<Request>
<Input>
  <Object>video-for-test.mp4</Object>
</Input>
<Time>10</Time>
<Output>
  <Region>ap-beijing</Region>
  <Bucket>ci-output-1250000000</Bucket>
  <Object>snapshot/video-for-test-snapshot.jpg</Object>
</Output>
</Request>

      Response

      HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 266
Connection: keep-alive
Date: Fri, 10 Mar 2016 09:45:46 GMT
Server: tencent-ci
x-ci-request-id: NTg3NzRiMjVfYmRjMzVfMTViMl82ZGZm****
<Response>
<Output>
  <Region>ap-beijing</Region>
  <Bucket>ci-output-1250000000</Bucket>
  <Object>snapshot/video-for-test-snapshot.jpg</Object>
</Output>
</Response>
      Hubungi Kami

      Hubungi tim penjualan atau penasihat bisnis kami untuk membantu bisnis Anda.

      Hubungi Kami
      Dukungan Teknis

      Buka tiket jika Anda mencari bantuan lebih lanjut. Tiket kami tersedia 7x24.

      Kirim Tiket
      Dukungan Telepon 7x24
      Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
      Kebijakan PrivasiLegalKebijakan Cookie