視頻截圖是指對視頻截取指定時間、指定尺寸的圖片,用於生產視頻封面、雪碧圖、播放器進度條縮圖等情境,截圖作業支援指定時間點、時間間隔、截圖數量、類型以及是否拼圖等。您可以通過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:])