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

ApsaraVideo Live:AddRtsLiveStreamTranscode

最終更新日:Dec 17, 2025

リアルタイムストリーミング (RTS) が有効になっているストリーミングドメインに、カスタムトランスコーディング設定を追加します。

操作説明

注意事項

この操作を呼び出して、カスタムのリアルタイムストリーミング (RTS) トランスコーディング設定を追加できます。この操作は、h264、h264-nbhd、h264-origin、audio のカスタムトランスコーディングテンプレートのみをサポートします。

QPS 制限

この操作の 1 秒あたりのクエリ数 (QPS) 制限は、ユーザーあたり 10 回/秒です。制限を超えると、API 呼び出しがスロットリングされます。これはビジネスに影響を与える可能性があります。それに応じて呼び出しを計画してください。詳細については、「QPS 制限」をご参照ください。

今すぐお試しください

この 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 ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

live:AddRtsLiveStreamTranscode

create

*Domain

acs:cdn:*:{#accountId}:domain/{#DomainName}

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

RegionId

string

任意

リージョン ID。

cn-shanghai

Domain

string

必須

ストリーミングドメイン。

example.com

App

string

必須

ライブストリームの AppName。要件は次のとおりです:

  • 英字、数字、アンダースコア (_)、ハイフン (-) をサポートします。

  • 英字または数字で始まる必要があります。3 文字以上の名前を推奨します。

aliyun-test

Template

string

必須

カスタムトランスコーディングテンプレートの名前。要件は次のとおりです:

  • 英字、数字、アンダースコア (_)、ハイフン (-) をサポートします。

  • 英字または数字で始まる必要があります。3 文字以上の名前を推奨します。

説明

名前は標準トランスコーディングテンプレートの名前と同じにすることはできません。

ld

TemplateType

string

必須

カスタムトランスコーディングテンプレートのタイプ。有効な値は次のとおりです:

  • h264:カスタム H.264 標準トランスコーディング。

  • h264-nbhd:カスタム H.264 狭帯域 HD™ トランスコーディング。

  • h264-origin:オリジナル品質の H.264 標準トランスコーディング。ソースビデオのパラメーターを可能な限り保持します。

  • audio:音声のみのトランスコーディング。出力ファイルには音声のみが含まれます。このパラメーターを audio に設定する場合は、AudioBitrate を設定する必要があります。

説明

ビデオタイプの場合、Height、Width、FPS、VideoBitrate、DeleteBframe が必須です。

h264

Height

integer

任意

出力ビデオの高さ (ピクセル単位)。

重要

TemplateType を h264、h264-nbhd、または h264-origin に設定した場合は必須です。

要件は次のとおりです:

  • Height ≥ 100

  • max(Height, Width) ≤ 2560

  • min(Height, Width) ≤ 1440

たとえば、1560 × 1560 (正方形ビデオ) の解像度は無効です。

説明

h264-origin テンプレートの場合、ソースストリームの情報を保持するために解像度は最大 4K まで可能です。

1280

Width

integer

任意

出力ビデオの幅 (ピクセル単位)。

重要

TemplateType を h264、h264-nbhd、または h264-origin に設定した場合は必須です。

要件は次のとおりです:

  • Width ≥ 100

  • max(Height, Width) ≤ 2560

  • min(Height, Width) ≤ 1440

たとえば、1560 × 1560 (正方形ビデオ) の解像度は無効です。

説明

h264-origin テンプレートの場合、ソースストリームの情報を保持するために解像度は最大 4K まで可能です。

720

FPS

integer

任意

出力ビデオのフレームレート。単位:フレーム/秒 (FPS)。有効な値:1~60

重要

TemplateType を h264、h264-nbhd、または h264-origin に設定した場合は必須です。

30

VideoBitrate

integer

任意

出力ビデオのビットレート。単位:kbps。有効な値:1~6000

重要

TemplateType を h264、h264-nbhd、または h264-origin に設定した場合は必須です。

説明

システムは指定されたビットレートでビデオをトランスコードしようとしますが、特に指定された値が高すぎるか低すぎる場合、実際のビットレートは指定された値と同じにならないことがあります。

2000

AudioBitrate

integer

任意

出力オーディオのビットレート。単位:kbps。有効な値:1~1000

重要

TemplateType を audio に設定した場合は必須です。

128

Gop

string

任意

キーフレーム間隔を指定する Group of Pictures (GOP) サイズ。単位:秒。有効な値:13

2

DeleteBframes

boolean

任意

トランスコードされた出力ビデオから B フレームを削除するかどうかを制御します。有効な値は次のとおりです:

重要

TemplateType を h264、h264-nbhd、または h264-origin に設定した場合は必須です。

  • true:トランスコードされたビデオに B フレームはありません。

  • false:トランスコードされたビデオに B フレームが含まれます。これがデフォルト値です。

false

Opus

boolean

任意

オーディオのトランスコーディングに Opus コーデックを使用するかどうかを指定します。これは主にネイティブ WebRTC との互換性のためのものです。有効な値は次のとおりです:

  • true:オーディオを Opus フォーマットにトランスコードします。

  • false:トランスコーディングに Opus フォーマットを使用しません。これがデフォルト値です。

true

Profile

integer

任意

ビデオコーデックプロファイル。値が大きいほど、ビデオ品質は向上しますが、エンコーディングとデコーディングのリソース消費量も高くなります。有効な値は次のとおりです:

  • 1:baseline (モバイルデバイス用)。

  • 2:main (SD デバイス用)。

  • 3:high (HD デバイス用)。

2

AudioProfile

string

任意

オーディオコーデックプロファイル。有効な値は次のとおりです:

  • aac_low

  • aac_he

  • aac_he_v2

  • aac_ld

aac_low

AudioCodec

string

任意

オーディオコーデック。有効な値は次のとおりです:

  • aac

  • mp3

説明

Opus コーデックを使用するには、Opus パラメーターを true に設定します。

aac

AudioRate

integer

任意

オーディオサンプルレート。有効な値:2205096000。推奨:44100。単位:Hz。

説明

AudioProfile が aac_ld に設定されている場合、サンプルレートは 44100 を超えることはできません。

44100

AudioChannelNum

integer

任意

オーディオチャンネル数。有効な値は次のとおりです:

  • 1:モノラル。

  • 2:ステレオ。

2

Lazy

string

任意

オンデマンドトランスコーディングを有効にするかどうかを指定します。有効な値は次のとおりです:

  • yes:最初の視聴者がこのトランスコードされたストリームをリクエストしたときにのみ、トランスコーディングが開始されます。

  • no:ストリームが公開された直後にトランスコーディングが開始されます。

no

レスポンスフィールド

フィールド

説明

object

RequestId

string

リクエスト ID。

16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

成功レスポンス

JSONJSON

{
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 InvalidParameters %s Please check and try again later.
400 ConfigAlreadyExists %s Please check and try again later.
400 TemplateLimit %s Please check and try again later.

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

変更履歴

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