すべてのプロダクト
Search
ドキュメントセンター

ApsaraVideo Media Processing:スナップショットのキャプチャ

最終更新日:Jan 12, 2025

動画スナップショット機能を使用すると、動画の特定の時点における特定のサイズのスナップショットをキャプチャできます。スナップショットは、動画のサムネイル、スプライト、プログレスバーのサムネイルなどのシナリオで使用されます。スナップショットをキャプチャする時点、連続する 2 つのスナップショットの間隔、キャプチャするスナップショットの数、キャプチャするスナップショットの種類、複数のスナップショットを 1 つの画像スプライトに合成するかどうかを指定できます。このトピックでは、PHP V2.0 用 ApsaraVideo Media Processing(MPS)SDK を使用してスナップショットをキャプチャする方法の例を示します。

サンプルコード

<?php

namespace AlibabaCloud\SDK\Sample;

use AlibabaCloud\SDK\Mts\V20140618\Mts;
use \Exception;
use AlibabaCloud\Tea\Exception\TeaError;
use AlibabaCloud\Tea\Utils\Utils;

use Darabonba\OpenApi\Models\Config;
use AlibabaCloud\SDK\Mts\V20140618\Models\SubmitSnapshotJobRequest;
use AlibabaCloud\Tea\Utils\Utils\RuntimeOptions;

class Sample {

    /**
     * AccessKey ID と AccessKey シークレットを使用してクライアントを初期化します。
     * @return Mts Client
     */
    public static function createClient(){

        $config = new Config([
                // 必須。ALIBABA_CLOUD_ACCESS_KEY_ID 環境変数が設定されていることを確認します。
                "accessKeyId" => getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"),
                // 必須。ALIBABA_CLOUD_ACCESS_KEY_SECRET 環境変数が設定されていることを確認します。
                "accessKeySecret" => getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")
        ]);
        $config->endpoint = "mts.cn-hangzhou.aliyuncs.com";
        return new Mts($config);
    }

    /**
     * @param string[] $args
     * @return void
     */
    public static function main($args){
        $client = self::createClient();
        $submitSnapshotJobRequest = new SubmitSnapshotJobRequest([
                // ジョブ入力。
                "input" => "{\"Bucket\":\"example-bucket\",\"Location\":\"example-location\",\"Object\":\"example%2Ftest.flv\"}",
                // スナップショットジョブの構成。
                "snapshotConfig" => "{\"OutputFile\":{\"Bucket\":\"example-001\",\"Location\":\"example-location\",\"Object\":\"{Count}.jpg\"},\"Time\":\"5\",\"Num\":\"10\",\"Interval\":\"20\"}",
                // ユーザー定義データ。
                "userData" => "testid-001",
                // MPS キューの ID。
                "pipelineId" => "dd3dae411e704030b921e52698e5****"
        ]);
        $runtime = new RuntimeOptions([]);
        try {
            // 必要に応じて、API 操作のレスポンスを表示するための独自のコードを記述します。
            $client->submitSnapshotJobWithOptions($submitSnapshotJobRequest, $runtime);
        }
        catch (Exception $error) {
            if (!($error instanceof TeaError)) {
                $error = new TeaError([], $error->getMessage(), $error->getCode(), $error);
            }
            // 実際のビジネスシナリオでは、例外を慎重に処理し、プロジェクトで例外を無視しないでください。この例では、エラーメッセージは参照用にのみ表示されます。
            // エラーメッセージ。
            var_dump($error->message);
            // 対応するエラー診断ページの URL。
            var_dump($error->data["Recommend"]);
            Utils::assertAsString($error->message);
        }
    }
}
$path = __DIR__ . \DIRECTORY_SEPARATOR . '..' . \DIRECTORY_SEPARATOR . 'vendor' . \DIRECTORY_SEPARATOR . 'autoload.php';
        if (file_exists($path)) {
require_once $path;
}
Sample::main(array_slice($argv, 1));

参照