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

ApsaraVideo Media Processing:メディアファイルのトランスコード

最終更新日:Jan 12, 2025

トランスコードとは、オーディオファイルまたはビデオファイルを別の 1 つ以上のオーディオファイルまたはビデオファイルに変換して、さまざまなネットワーク帯域幅、端末デバイス、およびユーザーニーズに適応させることです。 ApsaraVideo Media Processing (MPS) コンソールで作成されたトランスコードジョブとワークフローがビジネス要件を満たせない場合は、SubmitJobs オペレーションを呼び出してトランスコードジョブを送信できます。このトピックでは、MPS SDK for Python V2.0 を使用してトランスコードジョブを送信する例を示します。

サンプルコード

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:
        """
        AccessKey ID と AccessKey シークレットを使用してクライアントを初期化します。
        @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_jobs_request = mts_20140618_models.SubmitJobsRequest(
            # ジョブ入力。
            input='{"Bucket":"exampleBucket","Location":"oss-cn-hangzhou","Object":"example.flv","Referer": "The parameter that you set in the Object Storage Service (OSS) console to enable the hotlink protection feature"}',
            # ジョブ出力構成。
            outputs='[{"OutputObject":"exampleOutput.mp4","TemplateId":"6181666213ab41b9bc21da8ff5ff****","WaterMarks":[{"InputFile":{"Bucket":"exampleBucket","Location":"oss-cn-hangzhou","Object":"image_01.png"},"WaterMarkTemplateId":"9b772ce2740d4d55876d8b542d47****"}],"UserData":"testid-001"}]',
            # 出力ファイルを格納する OSS バケット。
            output_bucket='exampleBucket',
            # OSS バケットが存在するリージョン。
            output_location='oss-cn-hangzhou',
            # MPS キューの ID。
            pipeline_id='dd3dae411e704030b921e52698e5****'
        )
        runtime = util_models.RuntimeOptions()
        try:
            # 必要に応じて、API オペレーションのレスポンスを表示するための独自のコードを記述します。
            client.submit_jobs_with_options(submit_jobs_request, runtime)
        except Exception as error:
            # 実際のビジネスシナリオでは、例外を慎重に処理し、プロジェクトで例外を無視しないでください。この例では、エラーメッセージは参照用にのみ表示されます。
            # エラーメッセージ。
            print(error.message)
            # 対応するエラー診断ページの URL。
            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_jobs_request = mts_20140618_models.SubmitJobsRequest(
            # ジョブ入力。
            input='{"Bucket":"exampleBucket","Location":"oss-cn-hangzhou","Object":"example.flv","Referer": "The parameter that you set in the OSS console to enable the hotlink protection feature"}',
            # ジョブ出力構成。
            outputs='[{"OutputObject":"exampleOutput.mp4","TemplateId":"6181666213ab41b9bc21da8ff5ff****","WaterMarks":[{"InputFile":{"Bucket":"exampleBucket","Location":"oss-cn-hangzhou","Object":"image_01.png"},"WaterMarkTemplateId":"9b772ce2740d4d55876d8b542d47****"}],"UserData":"testid-001"}]',
            # 出力ファイルを格納する OSS バケット。
            output_bucket='exampleBucket',
            # OSS バケットが存在するリージョン。
            output_location='oss-cn-hangzhou',
            # MPS キューの ID。
            pipeline_id='dd3dae411e704030b921e52698e5****'
        )
        runtime = util_models.RuntimeOptions()
        try:
            # 必要に応じて、API オペレーションのレスポンスを表示するための独自のコードを記述します。
            await client.submit_jobs_with_options_async(submit_jobs_request, runtime)
        except Exception as error:
            # 実際のビジネスシナリオでは、例外を慎重に処理し、プロジェクトで例外を無視しないでください。この例では、エラーメッセージは参照用にのみ表示されます。
            # エラーメッセージ。
            print(error.message)
            # 対応するエラー診断ページの URL。
            print(error.data.get("Recommend"))
            UtilClient.assert_as_string(error.message)


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

参照