AddEditingProjectMaterials を使用したオンライン編集プロジェクトへのマテリアルの追加 - IMS - Alibaba Cloud - Intelligent Media Services

編集プロジェクトに 1 つ以上の素材を追加します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

ice:AddEditingProjectMaterials

*すべてのリソース。

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
ProjectId	string	必須	クラウド編集プロジェクトの ID。	***b2101cb318c***
MaterialMaps	string	必須	素材の ID。複数の ID はコンマ (,) で区切ります。タイプごとの素材 ID の最大値は 10 です。有効な値: "video": 動画 "audio": 音声 "image": イメージ "liveStream": ライブストリーム "editingProject": 編集プロジェクト	{"video":"***2e057304fcd9b145c5cafc*", "image":"8021a8d493da643c8acd98*,*cb6307a4edea614d8b3f3c*", "liveStream": "[{\"appName\":\"testrecord\",\"domainName\":\"test.alivecdn.com\",\"liveUrl\":\"rtmp://test.alivecdn.com/testrecord/teststream\",\"streamName\":\"teststream\"}]", "editingProject": "*9b145c5cafc2e057304fcd***"}

レスポンスフィールド

フィールド	型	説明	例
	object	応答のスキーマ。
RequestId	string	リクエスト ID。	***ACB-44F2-5F2D-88D7-1283E70***
ProjectId	string	クラウド編集プロジェクトの ID。	***67ae06542b9b93e0d1c387***
MediaInfos	array<object>	条件を満たすメディアアセットのコレクション。
	array<object>
MediaId	string	メディアアセットの ID。	***5cb2e35433198daae94a72***
MediaBasicInfo	object	メディアアセットの基本情報。
MediaId	string	メディアアセットの ID。	***5cb2e35433198daae94a72***
InputURL	string	対応するシステムに登録するメディアアセットの URL。	http://bucket.oss-cn-shanghai.aliyuncs.com/file.mp4
MediaType	string	メディアアセットのメディアタイプ。	Video
BusinessType	string	メディアアセットのビジネスタイプ。	general
Source	string	ソース。	oss
Title	string	タイトル。	default_title_2020-12-23T03:32:59Z
Description	string	説明。	sample_description
Category	string	カテゴリ。	audio
MediaTags	string	タグ。	sample_tag
CoverURL	string	カバーイメージの URL。	http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires=&OSSAccessKeyId=&Signature=&security-token=
UserData	string	ユーザーデータ。	userData
Snapshots	string	スナップショット。	null
Status	string	メディアアセットのステータス。有効な値: Init: 初期化済み Preparing: 準備中 PrepareFail: 準備に失敗した Normal: 法線	Normal
TranscodeStatus	string	トランスコード中のステータス。	Init
CreateTime	string	メディアアセットが作成された時間。時間は、ISO 8601 フォーマットの協定世界時 (UTC) (末尾が Z) で表示されます。	2020-12-23T03:32:59Z
ModifiedTime	string	メディアアセットが変更済みとなった時間。時間は、ISO 8601 フォーマットの協定世界時 (UTC) (末尾が Z) で表示されます。	2020-12-23T03:32:59Z
DeletedTime	string	メディアアセットが削除された時間。時間は、ISO 8601 フォーマットの協定世界時 (UTC) (末尾が Z) で表示されます。	2020-12-23T03:32:59Z
SpriteImages	string	スプライトイメージ。	http://outin-example.oss-cn-shanghai.aliyuncs.com/test.png?Expires=&OSSAccessKeyId=&Signature=&security-token=
FileInfoList	array<object>	ファイル情報。
	array<object>
FileBasicInfo	object	持続時間とサイズを含むファイルの基本情報。
FileName	string	ファイル名。	example.mp4
FileStatus	string	ファイルのステータス。有効な値: Uploading: アップロード中 Normal: 法線 UploadFail: アップロードに失敗した Disable: 無効 Deleted: 削除済み	Normal
FileType	string	ファイルのタイプ。	source_file
FileSize	string	バイト単位のファイルのサイズ。	30611502
FileUrl	string	ファイルの OSS URL。	http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4?Expires=&OSSAccessKeyId=&Signature=&security-token=
Region	string	ファイルのストレージリージョン。	cn-shanghai
FormatName	string	カプセル化フォーマット。	mov,mp4,m4a,3gp,3g2,mj2
Duration	string	持続時間。	216.206667
Bitrate	string	ビットレート。	1132.68
Width	string	幅。	960
Height	string	高さ。	540
LiveMaterials	array<object>	ライブストリームに関連付けられたマテリアル。
	object
AppName	string	ライブストリームアプリケーションの名前。	testrecord
StreamName	string	ライブストリームの名前。	teststream
DomainName	string	ライブストリームのドメイン名。	test.alivecdn.com
LiveUrl	string	ライブストリームの URL。	rtmp://test.alivecdn.com/testrecord/teststream
ProjectMaterials	array	編集プロジェクトに関連付けられたマテリアル。ライブ編集プロジェクトは、ライブストリームの終了後に共通の編集プロジェクトに関連付けられます。	***9b145c5cafc2e057304fcd***
	string	ライブ編集プロジェクトに関連付けられた共通の編集プロジェクトの ID。	***c38767ae06542b9b93e0d1***

例

成功レスポンス

JSONJSON

{
  "RequestId": "*****ACB-44F2-5F2D-88D7-1283E70*****",
  "ProjectId": "*****67ae06542b9b93e0d1c387*****",
  "MediaInfos": [
    {
      "MediaId": "*****5cb2e35433198daae94a72*****",
      "MediaBasicInfo": {
        "MediaId": "*****5cb2e35433198daae94a72*****",
        "InputURL": "http://bucket.oss-cn-shanghai.aliyuncs.com/file.mp4",
        "MediaType": "Video",
        "BusinessType": "general",
        "Source": "oss",
        "Title": "default_title_2020-12-23T03:32:59Z",
        "Description": "sample_description",
        "Category": "audio",
        "MediaTags": "sample_tag",
        "CoverURL": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires=&OSSAccessKeyId=&Signature=&security-token=",
        "UserData": "userData",
        "Snapshots": "null",
        "Status": "Normal",
        "TranscodeStatus": "Init",
        "CreateTime": "2020-12-23T03:32:59Z",
        "ModifiedTime": "2020-12-23T03:32:59Z",
        "DeletedTime": "2020-12-23T03:32:59Z",
        "SpriteImages": "http://outin-example.oss-cn-shanghai.aliyuncs.com/test.png?Expires=&OSSAccessKeyId=&Signature=&security-token="
      },
      "FileInfoList": [
        {
          "FileBasicInfo": {
            "FileName": "example.mp4",
            "FileStatus": "Normal",
            "FileType": "source_file",
            "FileSize": "30611502",
            "FileUrl": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4?Expires=&OSSAccessKeyId=&Signature=&security-token=",
            "Region": "cn-shanghai",
            "FormatName": "mov,mp4,m4a,3gp,3g2,mj2",
            "Duration": "216.206667",
            "Bitrate": "1132.68",
            "Width": "960",
            "Height": "540"
          }
        }
      ]
    }
  ],
  "LiveMaterials": [
    {
      "AppName": "testrecord",
      "StreamName": "teststream",
      "DomainName": "test.alivecdn.com",
      "LiveUrl": "rtmp://test.alivecdn.com/testrecord/teststream"
    }
  ],
  "ProjectMaterials": [
    "*****c38767ae06542b9b93e0d1*****"
  ]
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ	説明
400	InvalidParameter	The specified parameter \ is not valid.
404	ProjectNotFound	The specified project not found

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。