Object Storage Service:ビデオスナップショット

使用上の注意

• ビデオからスナップショットをキャプチャすると、キャプチャされたスナップショットの数に基づいて課金されます。 詳細については、「データ処理料金」をご参照ください。

• OSSは、H.264およびH.265形式のビデオからのみスナップショットをキャプチャできます。

• デフォルトでは、キャプチャしたスナップショットは自動的に保存されません。 キャプチャしたスナップショットをローカルストレージデバイスに手動でダウンロードする必要があります。

パラメーター

カテゴリ: ビデオ

処置: snapshot

例

このセクションでは、中国 (杭州) リージョンのoss-console-img-demo-cn-hangzhouバケットに保存されているビデオからスナップショットをキャプチャする方法の例を示します。 ビデオは次のURLでホストされます。

https://oss-console-img-demo-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/video.mp4

• 高速モードを使用して、ビデオの7秒目のスナップショットをキャプチャします。 キャプチャしたスナップショットを、幅が800ピクセル、高さが600ピクセルのJPGイメージとしてエクスポートします。

  上記のパラメーターを適用するために使用されるURLは https://oss-console-img-demo-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/video.mp4?x-oss-process=video/snapshot,t_7000,f_jpg,w_800,h_600,m_fast です。

  

• ビデオの17秒目にスナップショットをキャプチャします。 キャプチャしたスナップショットを、幅が800ピクセル、高さが600ピクセルのJPGイメージとしてエクスポートします。

  上記のパラメーターを適用するために使用されるURLは https://oss-console-img-demo-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/video.mp4?x-oss-process=video/snapshot,t_17000,f_jpg,w_800,h_600 です。

  

署名付きURLを生成してビデオスナップショットをキャプチャする

OSS SDKを使用して署名付きURLを生成し、ビデオスナップショットをキャプチャできます。 次のサンプルコードは、OSS SDK for Javaを使用して署名付きURLを生成し、ビデオスナップショットをキャプチャする方法の例を示しています。

// In this example, the endpoint of the China (Hangzhou) region is used. Specify your actual endpoint. 
String endpoint = "http://oss-cn-hangzhou.aliyuncs.com";
// We recommend that you do not save access credentials in the project code. Otherwise, access credentials may be leaked. As a result, the security of all resources in your account is compromised. In this example, access credentials are obtained from environment variables. Before you run the sample code, make sure that the environment variables are configured. 
EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
// Specify the name of the bucket in which the video object is stored. Example: examplebucket. 
String bucketName = "examplebucket";
// Specify the full path of the video object. If the video object is not stored in the root directory of the bucket, you must provide the full path of the object. Example: examplefolder/videotest.mp4. 
String objectName = "examplefolder/videotest.mp4";
// Create an OSSClient instance. 
OSS ossClient = new OSSClientBuilder().build(endpoint, credentialsProvider);
// Capture the snapshot right at the 17th second of the video. Export the captured snapshot as a JPG image whose width is 800 pixels and height is 600 pixels. 
String style = "video/snapshot,t_17000,f_jpg,w_800,h_600";
// Set the validity period of the URL to 10 minutes. 
Date expiration = new Date(new Date().getTime() + 1000 * 60 * 10 );
GeneratePresignedUrlRequest req = new GeneratePresignedUrlRequest(bucketName, objectName, HttpMethod.GET);
req.setExpiration(expiration);
req.setProcess(style);
URL signedUrl = ossClient.generatePresignedUrl(req);
System.out.println(signedUrl);
// Shut down the OSSClient instance. 
ossClient.shutdown();

ビデオスナップショットをキャプチャするために署名付きURLを生成するために使用される方法は、Image Processing (IMG) を使用して画像を処理するために署名付きURLを生成するために使用される方法と同様です。 次のOSS SDKを使用して署名付きURLを生成し、ビデオスナップショットをキャプチャするには、コード内のIMG操作をスナップショット操作に置き換えます。

• Python SDK

• PHP SDK

• Go SDK

• C SDK

• C ++ SDK

• . NET SDK

• Android SDK

• iOS SDK

• Node.js SDK

• browser.js SDK

よくある質問

オブジェクトのURLにパラメータを直接追加して、ACLがプライベートなビデオオブジェクトを処理できますか?

いいえ、できません。 処理するビデオオブジェクトのACLが非公開の場合、OSS SDKを使用して、オブジェクトの署名付きURLにビデオ処理操作を追加できます。 オブジェクトのURLにパラメーターを直接追加して、ACLが非公開のビデオオブジェクトを処理することはできません。

OSSに保存されているビデオオブジェクトの幅と高さを確認するにはどうすればよいですか?

ビデオ情報抽出機能を使用して、ビデオの幅と高さを取得できます。

キャプチャされたビデオスナップショットが歪んでいるのはなぜですか?

スナップショットをキャプチャするビデオは、BT.2020色域を使用します。 ビデオスナップショット機能は、BT.2020色域を使用するビデオをサポートしていません。