スクリーンショットとは、ビデオの中の特定の時点における映像を画像ファイルとして保存する処理のことをいいます。

タイプ

  • キーフレーム

    ビデオのキーフレームは独立してエンコードされているため、画質がよく、また、すばやくキャプチャすることができます。 キーフレームはビデオの中に一定の間隔で現れますが、時間を指定してキャプチャすることはできません。 システムは、指定した時間に近いキーフレームを検索できます。

  • ノーマルフレーム

    キーフレームに比べると画質は劣り、キャプチャに時間がかかります。 しかし、正確に指定した時点でのキャプチャを取ることができます。

  1. </section>
  2. <section class="section" id="section-gf1-pyl-x2b">
  3. <h2 class="title sectiontitle" id="title-ikx-15m-6re">パラメーターの説明</h2>
  4. <p class="p" id="p-1cj-kx9-s48">ファイルを入力する際は、次のパラメーターに注意が必要です。</p>
  5. <p class="p" id="p-agp-6i1-snm"><a title="" href="https://jp.alibabacloud.com/help/doc-detail/29253.htm">Input</a></p>
  6. <div class="p" id="p-2sp-yac-kvd">スクリーンショットを撮りたいビデオの OSS (Alibaba Cloud Object Storage Service) 入力ファイルを指定します。
  7. <div class="note note note-note" id="note-hjn-4jy-2bt">
  8. <div class="note-icon-wrapper"><i class="icon-note note"></i></div>
  9. <div class="note-content"><strong></strong> OSS の場所は、MPS のリージョンと対応している必要があります。 例えば、OSS の場所 "oss-cn-hangzhou" は MPS のリージョン "cn-hangzhou"
  10. に対応しています。
  11. </div>
  12. </div>
  13. </div>
  14. <p class="p" id="p-hiv-rvr-81g"><a title="" href="https://jp.alibabacloud.com/help/doc-detail/29253.htm">スナップショットの設定</a>では、次のパラメーターに注意が必要です。
  15. </p>
  16. <ul class="ul" id="ul-af3-qyl-x2b">
  17. <li class="li" id="li-u1a-p2t-0ql">
  18. <p class="p" id="p-vf1-xzg-22m"><a title="" href="https://jp.alibabacloud.com/help/doc-detail/29253.htm">OutputFile</a></p>
  19. <p class="p" id="p-4hx-yha-suz">スクリーンショットの OSS 出力ファイルを指定します。 OSS オブジェクトのファイル名を固定で指定することも、カスタマイズして指定することもできます。 命名規則については、<a title="" href="https://jp.alibabacloud.com/help/doc-detail/29253.htm">「スクリーンショットの OutputFile」</a>をご参照ください。
  20. </p>
  21. </li>
  22. <li class="li" id="li-qh7-d7j-v6v">
  23. <p class="p" id="p-b9a-7g4-zvj">Time</p>
  24. <p class="p" id="p-7ph-o87-xmb">単一のスクリーンショットの時間、または複数のスクリーンショットの場合は開始時間です。 Integer 型のミリ秒で指定します。</p>
  25. </li>
  26. <li class="li" id="li-eas-9dk-xz3">
  27. <p class="p" id="p-hfd-jdp-ftv"> Interval と Num</p>
  28. <p class="p" id="p-dwu-omn-mrq">2 つのフレームの間隔 (単位 : 秒) と、キャプチャするフレームの数を指定します。 値によって次のようになります。</p>
  29. <ul class="ul" id="ul-cf3-qyl-x2b">
  30. <li class="li" id="li-lur-79i-it3">
  31. <p class="p" id="p-w0f-zqx-ako">Num が指定されていない場合、指定した間隔で動画の最後までスクリーンショットが撮られます。</p>
  32. </li>
  33. <li class="li" id="li-zd5-n12-gwi">
  34. <p class="p" id="p-6vj-rqj-tkm">Num の値が 1 より大きい場合は、指定した間隔で、スクリーンショットの数が指定数に達するまでキャプチャされます。</p>
  35. </li>
  36. <li class="li" id="li-wox-cmn-1vy">
  37. <p class="p" id="p-aen-yv9-k58">Num の値が 1 の場合は、1 枚のスクリーンショットが非同期的に撮られます。</p>
  38. </li>
  39. </ul>
  40. </li>
  41. <li class="li" id="li-9y5-5ip-i4s">
  42. <p class="p" id="p-y6a-kp6-jnx">Width と Height</p>
  43. <p class="p" id="p-zbf-nyg-l1t">出力されるスクリーンショット画像の幅と高さ (ピクセル) を指定します。</p>
  44. <p class="p" id="p-t5m-if1-0cm">幅と高さは入力となるビデオに基づきます。</p>
  45. <ul class="ul" id="ul-df3-qyl-x2b">
  46. <li class="li" id="li-cbw-bib-0eh">
  47. <p class="p" id="p-lb5-ajg-bgt">Width と Height のどちらも指定されていない場合、出力画像のサイズはビデオのサイズと同じになります。</p>
  48. </li>
  49. <li class="li" id="li-lo0-85f-58f">
  50. <p class="p" id="p-1rt-7ij-lbb">Width と Height のどちらか一方が指定されている場合、指定されていない方はビデオの縦横比に基づいて算出されます。 こうすることで、画像のゆがみを回避します。</p>
  51. </li>
  52. </ul>
  53. <div class="note note note-note" id="note-tzs-dp4-09n">
  54. <div class="note-icon-wrapper"><i class="icon-note note"></i></div>
  55. <div class="note-content"><strong></strong> 画像のゆがみを防ぐため、Width と Height 両方に適当な値を指定しないことを推奨します。
  56. <ul class="ul" id="ul-hrm-5yl-x2b">
  57. <li class="li" id="li-h51-0os-d56">
  58. <p class="p" id="p-af2-mzz-ic4">縦向きモードの MP4 ビデオに回転識別子がある場合、スクリーンショットは横向きになります。</p>
  59. </li>
  60. <li class="li" id="li-szi-mh2-3e8">
  61. <p class="p" id="p-v8x-9n8-j9d">縦向きモードの MP4 ビデオで回転識別子がない場合は、スクリーンショットも縦向きのままになります。</p>
  62. </li>
  63. </ul>
  64. </div>
  65. </div>
  66. </li>
  67. <li class="li" id="li-dzc-u7l-5tv">FrameType
  68. <p class="p" id="p-jqt-lj5-tyy">スクリーンショットのタイプを指定します。キーフレーム ("Key Frame") またはノーマルフレーム ("Normal Frame") です。 デフォルト値は
  69. "Key Frame" です。
  70. </p>
  71. </li>
  72. <li class="li" id="li-f8p-83r-ep6"> TileOutputFile と TileOut
  73. <p class="p" id="p-bwc-yef-u92">スプライト画像の OSS 出力ファイルと <a title="" href="https://jp.alibabacloud.com/help/doc-detail/29253.htm">TileOut</a> を指定します。
  74. </p>
  75. </li>
  76. <li class="li" id="li-1j1-nfj-uww"> SubOut and Format
  77. <ul class="ul" id="ul-iyg-1zl-x2b">
  78. <li class="li" id="li-0o3-cxl-ddq">WebVTT サムネイルを使用したい場合は、Format を "vtt" に設定します。</li>
  79. <li class="li" id="li-le1-1lr-p45">WebVTT サムネイルをスプライト画像として出力したい場合は、Format と SubOut を同時に設定します。</li>
  80. </ul>
  81. </li>
  82. </ul>
  83. </section>
  84. <section class="section" id="section-rnd-czl-x2b">
  85. <h2 class="title sectiontitle" id="title-oki-o70-3z3">シナリオ</h2>
  86. <ul class="ul" id="ul-pwm-czl-x2b">
  87. <li class="li" id="li-fzn-x0c-sm4">単一のスクリーンショット
  88. <p class="p" id="p-otb-exe-cza">時間を指定すると、ビデオのその時点でのスクリーンショットを撮ることができます。</p>
  89. </li>
  90. <li class="li" id="li-2kb-t4s-80z">複数のスクリーンショット
  91. <p class="p" id="p-zzt-ev4-peg">時間間隔を指定すると、ビデオから等間隔で複数のスクリーンショットを撮ることができます。 各スクリーンショットは画像ファイルです。 この操作は、バッチスクリーンショットまたは順序スクリーンショットとも呼ばれます。</p>
  92. </li>
  93. <li class="li" id="li-aq6-nbz-adc">スプライト画像
  94. <p class="p" id="p-fxl-nmg-3ne">複数のスクリーンショット画像を一つの大きな画像スプライトにまとめることができます。 複数のスクリーンショットを一度にリクエストできるため、画像のリクエスト回数を減らし、クライアントのパフォーマンス向上につながります。</p>
  95. </li>
  96. <li class="li" id="li-m92-v45-mk0">WebVTT サムネイル
  97. <p class="p" id="p-f9p-jp2-mbv">HTML5 における標準のサブタイトルのフォーマットであり、複数の H5 プレイヤーのサムネイルプレビューのフォーマットでもあります。 『<a title="" href="https://support.jwplayer.com/articles/how-to-add-preview-thumbnails">JWPlayer Documents</a>』をご参照ください。
  98. </p>
  99. <p class="p" id="p-7kp-q4o-qlx">WebVTT はファイル形式です。 サムネイルは、複数の画像、または一つの大きなスプライト画像のどちらでも使用できます。</p>
  100. </li>
  101. </ul>
  102. </section>
  103. <section class="section" id="section-sqh-dzl-x2b">
  104. <h2 class="title sectiontitle" id="title-6sy-3qo-k5q">実行方法</h2>
  105. <p class="p" id="p-x6z-7pc-7zx"><a title="ここでは、開発者が MPS をより理解したうえでご使用いただけるように、MPS のいくつかの基本概念と関連性について説明します。" href="~~64682#concept-e2n-j4j-z2b~~">「タスクと MPS キュー」</a><code class="ph codeph" id="codeph-d7o-196-kaj">Task execution and completion</code> をご参照ください。
  106. </p>
  107. <ul class="ul" id="ul-hlv-dzl-x2b">
  108. <li class="li" id="li-r1i-14o-90n">同期処理
  109. <p class="p" id="p-ew8-q4g-1qp">API が呼び出されると、スクリーンショットジョブの ID と結果が同期的に返されます。</p>
  110. <p class="p" id="p-ayz-mj5-y4i">単一のスクリーンショットのみ同期可能です。</p>
  111. </li>
  112. <li class="li" id="li-ru7-s5c-6qy">非同期処理
  113. <p class="p" id="p-d0g-awt-vzy">API が呼び出されると、スクリーンショットジョブの ID のみが返されます。 スクリーンショットの結果を確認するには、スクリーンショットジョブの ID や Nortification
  114. サービスを使用します。
  115. </p>
  116. <p class="p" id="p-vsd-bzg-2lp">単一のスクリーンショット、複数スクリーンショット、スプライト画像、WebVTT サムネイルは全て非同期的に取得できます。</p>
  117. </li>
  118. </ul>
  119. </section>
  120. <section class="section" id="section-zcm-1vl-x2b">
  121. <h2 class="title sectiontitle" id="title-mwk-1gb-5bp">コード例</h2>
  122. <p class="p" id="p-thw-6rt-a3z"><code class="ph codeph" id="codeph-ej9-y07-hhz">720P (1280 x 720)</code> で10 秒の長さの動画があります。 スクリーンショットの高さを 360 ピクセル、開始時間を 2 秒、間隔を 1 秒、スクリーンショット数を 3 に指定します。
  123. 2、3、4 秒時点における 3 つの画像がそれぞれキャプチャされます。 画像ファイルには 00001、00002、00003 というように連番が付けられます。
  124. </p>
  125. <p class="p" id="p-qnw-blv-usq"><a title="" href="~~56333#concept-xjn-rdx-y2b~~">スクリーンショット (Java SDK)</a></p>
  126. <p class="p" id="p-3f5-vj2-ylm"><a title="" href="~~56338#concept-x5l-vfc-z2b~~">スクリーンショット (Python SDK)</a></p>
  127. <p class="p" id="p-bzm-50c-720"><a title="" href="~~56337#concept-a4h-xg2-z2b~~">スクリーンショット (PHP SDK)</a></p>
  128. </section>
  129. </div>
  130. </article>
  131. </main>