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

ApsaraVideo Media Processing:メディアアセットの基本情報の照会と更新

最終更新日:Jan 12, 2025

このトピックでは、メディアアセットの基本情報の照会および更新方法について説明します。

メディアアセットの基本情報の照会と更新

ApsaraVideo Media Processing (MPS) では、MPS SDK を使用するか、API オペレーションを呼び出すことで、メディアアセットの基本情報を照会および更新できます。さまざまなプログラミング言語の MPS SDK のインストール方法の詳細については、Alibaba Cloud SDK for Java のインストールAlibaba Cloud SDK for Python のインストール、および Alibaba Cloud SDK for PHP のインストール をご参照ください。サンプルコードの詳細については、以下のテキストをご参照ください。 API オペレーションの呼び出し方法の詳細については、このトピックの API オペレーションを直接呼び出してメディアアセットの基本情報を照会および更新する セクションをご参照ください。

説明

次の例では、MPS SDK for PHP を使用しています。

SDK を使用して API オペレーションを呼び出し、メディアアセットの基本情報を照会および更新する

  • メディアアセットの基本情報を照会する

    MPS では、メディアアセットのメディア ID または Object Storage Service (OSS) URL を使用して、メディアアセットの基本情報を照会できます。

    • メディア ID を使用してメディアアセットの基本情報を照会する

      説明

      パラメーターの詳細については、QueryMediaList をご参照ください。

      <?php
      namespace AlibabaCloud\SDK\Sample;
      
      use AlibabaCloud\SDK\Mts\V20140618\Mts;
      use AlibabaCloud\Darabonba\Env\Env;
      use AlibabaCloud\Tea\Tea;
      use AlibabaCloud\Tea\Utils\Utils;
      use AlibabaCloud\Tea\Console\Console;
      
      use Darabonba\OpenApi\Models\Config;
      use AlibabaCloud\SDK\Mts\V20140618\Models\QueryMediaListRequest;
      
      
      class Sample {
      
          /**
           * @param string $accessKeyId
           * @param string $accessKeySecret
           * @param string $regionId
           * @return Mts
           * 本番環境では、protocol パラメーターを HTTPS に設定することをお勧めします。 // We recommend that you set the protocol parameter to HTTPS in a production environment.
           */
          public static function createClient($accessKeyId, $accessKeySecret, $regionId){
              $config = new Config([]);
              $config->accessKeyId = $accessKeyId;
              $config->accessKeySecret = $accessKeySecret;
              $config->regionId = $regionId;
              $config->protocol = "HTTP";
              return new Mts($config);
          }
      
          /**
           * @return void
           */
          public static function main(){
              $client = self::createClient(Env::getEnv("ALIBABA_CLOUD_ACCESS_KEY_ID"), Env::getEnv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"), 'cn-shanghai');
              $request = new QueryMediaListRequest([
                  "mediaIds" => "90accf1a2ccb5c5fbc99****"
              ]);
              $response = $client->queryMediaList($request);
              Console::log(Utils::toJSONString(Tea::merge($response->body)));
          }
      
      }
      $path = __DIR__ . \DIRECTORY_SEPARATOR . '..' . \DIRECTORY_SEPARATOR . 'vendor' . \DIRECTORY_SEPARATOR . 'autoload.php';
      if (file_exists($path)) {
          require_once $path;
      }
      Sample::main();
      
    • OSS URL を使用してメディアアセットの基本情報を照会する

      説明

      OSS URL とは、OSS バケット内のメディアファイルの URL を指します。例: http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/test/1****.mp4。パラメーターの詳細については、QueryMediaListByURL をご参照ください。

      <?php
      namespace AlibabaCloud\SDK\Sample;
      
      use AlibabaCloud\SDK\Mts\V20140618\Mts;
      use AlibabaCloud\Darabonba\Env\Env;
      use AlibabaCloud\Tea\Tea;
      use AlibabaCloud\Tea\Utils\Utils;
      use AlibabaCloud\Tea\Console\Console;
      
      use Darabonba\OpenApi\Models\Config;
      use AlibabaCloud\SDK\Mts\V20140618\Models\QueryMediaListByURLRequest;
      
      
      class Sample {
      
          /**
           * @param string $accessKeyId
           * @param string $accessKeySecret
           * @param string $regionId
           * @return Mts
           * 本番環境では、protocol パラメーターを HTTPS に設定することをお勧めします。 // We recommend that you set the protocol parameter to HTTPS in a production environment.
           */
          public static function createClient($accessKeyId, $accessKeySecret, $regionId){
              $config = new Config([]);
              $config->accessKeyId = $accessKeyId;
              $config->accessKeySecret = $accessKeySecret;
              $config->regionId = $regionId;
              $config->protocol = "HTTP";
              return new Mts($config);
          }
      
          /**
           * @return void
           */
          public static function main(){
              $client = self::createClient(Env::getEnv("ALIBABA_CLOUD_ACCESS_KEY_ID"), Env::getEnv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"), 'cn-shanghai');
              $request = new QueryMediaListByURLRequest([
                  "fileURLs" => "http://<bucket name>.oss-cn-shanghai.aliyuncs.com/mps_input/video.mp4"
              ]);
              $response = $client->queryMediaListByURL($request);
              Console::log(Utils::toJSONString(Tea::merge($response->body)));
          }
      
      }
      $path = __DIR__ . \DIRECTORY_SEPARATOR . '..' . \DIRECTORY_SEPARATOR . 'vendor' . \DIRECTORY_SEPARATOR . 'autoload.php';
      if (file_exists($path)) {
          require_once $path;
      }
      Sample::main();
      
  • メディアアセットのパラメーターを更新する

    <?php
    namespace AlibabaCloud\SDK\Sample;
    
    use AlibabaCloud\SDK\Mts\V20140618\Mts;
    use AlibabaCloud\Darabonba\Env\Env;
    use AlibabaCloud\Tea\Tea;
    use AlibabaCloud\Tea\Utils\Utils;
    use AlibabaCloud\Tea\Console\Console;
    
    use Darabonba\OpenApi\Models\Config;
    use AlibabaCloud\SDK\Mts\V20140618\Models\UpdateMediaRequest;
    
    
    class Sample {
    
        /**
         * @param string $accessKeyId
         * @param string $accessKeySecret
         * @param string $regionId
         * @return Mts
         * 本番環境では、protocol パラメーターを HTTPS に設定することをお勧めします。 // We recommend that you set the protocol parameter to HTTPS in a production environment.
         */
        public static function createClient($accessKeyId, $accessKeySecret, $regionId){
            $config = new Config([]);
            $config->accessKeyId = $accessKeyId;
            $config->accessKeySecret = $accessKeySecret;
            $config->regionId = $regionId;
            $config->protocol = "HTTP";
            return new Mts($config);
        }
    
        /**
         * @return void
         */
        public static function main(){
            $client = self::createClient(Env::getEnv("ALIBABA_CLOUD_ACCESS_KEY_ID"), Env::getEnv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"), 'cn-shanghai');
            $request = new UpdateMediaRequest([
                "mediaId" => "7ce3a1c225ef0670bc2****",
                "title" => "Update a media asset for test" // テスト用にメディアアセットを更新する
            ]);
            $response = $client->updateMedia($request);
            Console::log(Utils::toJSONString(Tea::merge($response->body)));
        }
    
    }
    $path = __DIR__ . \DIRECTORY_SEPARATOR . '..' . \DIRECTORY_SEPARATOR . 'vendor' . \DIRECTORY_SEPARATOR . 'autoload.php';
    if (file_exists($path)) {
        require_once $path;
    }
    Sample::main();
    

API オペレーションを直接呼び出してメディアアセットの基本情報を照会および更新する

説明

OpenAPI Explorer で API オペレーションを直接呼び出して、メディアアセットの基本情報を照会または更新できます。

次の表に、メディアアセットの基本情報を照会および更新するために使用される API オペレーションを示します。

機能

オペレーション

メディア ID に基づいてメディアアセットの基本情報を照会する

QueryMediaList

OSS URL に基づいてメディアアセットの基本情報を照会する

QueryMediaListByURL

説明

OSS URL とは、OSS バケット内のメディアファイルの URL を指します。例: http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/test/1****.mp4

メディアアセットのすべてのパラメーターを更新する

UpdateMedia

メディアアセットの単一のパラメーターを更新する