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

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

*All Resource

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
ProjectId	string	必須	オンライン編集プロジェクトの ID。	***b2101cb318c***
MaterialMaps	string	必須	マテリアル ID。複数のマテリアル ID はコンマ (,) で区切ります。各タイプは最大 10 個のマテリアル ID をサポートします。次のマテリアルタイプがサポートされています： 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	メディアアセットが作成された時間。	2020-12-23T03:32:59Z
ModifiedTime	string	メディアアセットが最後に変更された時間。	2020-12-23T03:32:59Z
DeletedTime	string	メディアアセットが削除された時間。	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	ファイルの Object Storage Service (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

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

変更履歴

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