全部產品
Search
文件中心

ApsaraVideo Media Processing:截圖

更新時間:Oct 25, 2024

視頻截圖是指對視頻截取指定時間、指定尺寸的圖片,用於生產視頻封面、雪碧圖、播放器進度條縮圖等情境,截圖作業支援指定時間點、時間間隔、截圖數量、類型以及是否拼圖等。您可以通過ApsaraVideo for Media Processing控制台、API或SDK提交截圖作業。本文提供Python SDK V2.0使用截圖相關功能的API調用樣本。

完整代碼

import os
import sys

from typing import List

from alibabacloud_mts20140618.client import Client as Mts20140618Client
from alibabacloud_tea_openapi import models as open_api_models
from alibabacloud_mts20140618 import models as mts_20140618_models
from alibabacloud_tea_util import models as util_models
from alibabacloud_tea_util.client import Client as UtilClient


class Sample:
    def __init__(self):
        pass

    @staticmethod
    def create_client() -> Mts20140618Client:
        """
        使用AK&SK初始化帳號Client
        @return: Client
        @throws Exception
        """
        config = open_api_models.Config(
            # 必填,請確保代碼運行環境設定了環境變數 ALIBABA_CLOUD_ACCESS_KEY_ID。,
            access_key_id=os.environ['ALIBABA_CLOUD_ACCESS_KEY_ID'],
            # 必填,請確保代碼運行環境設定了環境變數 ALIBABA_CLOUD_ACCESS_KEY_SECRET。,
            access_key_secret=os.environ['ALIBABA_CLOUD_ACCESS_KEY_SECRET']
        )
        config.endpoint = f'mts.cn-hangzhou.aliyuncs.com'
        return Mts20140618Client(config)

    @staticmethod
    def main(
        args: List[str],
    ) -> None:
        client = Sample.create_client()
        submit_snapshot_job_request = mts_20140618_models.SubmitSnapshotJobRequest(
            #作業輸入
            input='{"Bucket":"example-bucket","Location":"example-location","Object":"example%2Ftest.flv"}',
            #截圖配置
            snapshot_config='{"OutputFile":{"Bucket":"example-001","Location":"example-location","Object":"{Count}.jpg"},"Time":"5","Num":"10","Interval":"20"}',
            #使用者自訂資料
            user_data='testid-001',
            #管道ID
            pipeline_id='dd3dae411e704030b921e52698e5****'
        )
        runtime = util_models.RuntimeOptions()
        try:
            # 複製代碼運行請自行列印 API 的傳回值
            client.submit_snapshot_job_with_options(submit_snapshot_job_request, runtime)
        except Exception as error:
            # 此處僅做列印展示,請謹慎對待異常處理,在工程專案中切勿直接忽略異常。
            # 錯誤 message
            print(error.message)
            # 診斷地址
            print(error.data.get("Recommend"))
            UtilClient.assert_as_string(error.message)

    @staticmethod
    async def main_async(
        args: List[str],
    ) -> None:
        client = Sample.create_client()
        submit_snapshot_job_request = mts_20140618_models.SubmitSnapshotJobRequest(
            #作業輸入
            input='{"Bucket":"example-bucket","Location":"example-location","Object":"example%2Ftest.flv"}',
            #截圖配置
            snapshot_config='{"OutputFile":{"Bucket":"example-001","Location":"example-location","Object":"{Count}.jpg"},"Time":"5","Num":"10","Interval":"20"}',
            #使用者自訂資料
            user_data='testid-001',
            #管道ID
            pipeline_id='dd3dae411e704030b921e52698e5****'
        )
        runtime = util_models.RuntimeOptions()
        try:
            # 複製代碼運行請自行列印 API 的傳回值
            await client.submit_snapshot_job_with_options_async(submit_snapshot_job_request, runtime)
        except Exception as error:
            # 此處僅做列印展示,請謹慎對待異常處理,在工程專案中切勿直接忽略異常。
            # 錯誤 message
            print(error.message)
            # 診斷地址
            print(error.data.get("Recommend"))
            UtilClient.assert_as_string(error.message)


if __name__ == '__main__':
    Sample.main(sys.argv[1:])

相關文檔