すべてのプロダクト
Search

このプロダクト

    ApsaraVideo Live:StartRtcCloudTranscode

    ドキュメントセンター

    ApsaraVideo Live:StartRtcCloudTranscode

    最終更新日:Jan 27, 2026

    クラウドトランスコーディングジョブを作成します。

    操作説明

    エンドポイント

    この操作で利用可能なエンドポイントは次のとおりです。

    リージョンリージョン IDパブリックエンドポイント
    シンガポールap-southeast-1live.ap-southeast-1.aliyuncs.com

    今すぐお試しください

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

    テスト

    RAM 認証

    この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

    リクエスト構文

    POST  HTTP/1.1

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    AppId

    string

    必須

    チャンネルが属するアプリケーションの ID。ID には、大文字、小文字、数字、アンダースコア (_)、ハイフン (-) を使用できます。最大長は 64 文字です。

    ********-7074-****-9ef5-85c19a4*****
    ChannelId

    string

    必須

    トランスコーディング対象のユーザーが属するチャンネルの ID。ID には、大文字、小文字、数字、アンダースコア (_)、ハイフン (-) を使用できます。最大長は 64 文字です。

    myChannel
    InputParam

    object

    必須

    入力ストリームのサブスクリプションに関するパラメーターです。

    SingleSubUserParam

    object

    必須

    シングルストリームサブスクリプションの入力パラメーターです。

    UserId

    string

    必須

    サブスクライブしたいストリームのユーザー ID です。

    userA
    StreamType

    integer

    任意

    サブスクライブするストリームのメディアタイプ。有効な値は次のとおりです：

    • 0 (デフォルト)：オリジナルストリーム。音声ストリームと映像ストリームの両方を含みます。

    • 1：音声のみのストリーム。(この値はサポートされていません。設定は無効です。)

    • 2：映像のみのストリーム。(この値はサポートされていません。設定は無効です。)

    0
    SourceType

    integer

    任意

    映像入力ストリームのタイプ。このパラメーターは、サブスクライブするメディアタイプに映像ストリームが含まれている場合にのみ有効です。有効な値は次のとおりです：

    • 0 (デフォルト)：カメラストリーム。

    • 1：画面共有ストリーム。(この値はサポートされていません。設定は無効です。)

    0
    OutputParams

    array<object>

    必須

    トランスコーディング出力のパラメーターです。

    object

    任意

    トランスコーディング出力ストリームのパラメーターです。

    ChannelId

    string

    必須

    トランスコーディングされたストリームがプッシュされるチャンネルの ID。ID には、大文字、小文字、数字、アンダースコア (_)、ハイフン (-) を使用できます。最大長は 64 文字です。(異なるチャンネルへのストリームのプッシュはサポートされていません。この設定は無効です。)

    myChannel
    UserId

    string

    必須

    宛先チャンネルにおけるトランスコーディングされたストリームのユーザー ID。この ID はチャンネル内で一意である必要があります。

    userA_360p
    UserToken

    string

    必須

    トランスコーディングされたストリームをチャンネルにプッシュするために必要なトークン。詳細については、「トークンベースの認証」をご参照ください。

    eyJhcHBpZCI********
    TranscodeTemplate

    string

    必須

    トランスコーディングテンプレートの名前。有効な値は次のとおりです：

    • alimcopy

    • lld

    • lsd

    • lhd

    • lud

    lhd
    MaxIdleTime

    integer

    任意

    アイドルタイムアウト期間 (秒)。タスクが指定されたストリーマーのストリームをサブスクライブできず、この期間を超えてアイドル状態が続くと、タスクは自動的に停止します。値は 10 から 14,400 までの整数である必要があります。デフォルト値は 300 です。

    600

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    応答。

    RequestId

    string

    リクエスト ID。

    ******3B-0E1A-586A-AC29-742247******
    TaskId

    string

    クラウドトランスコーディングジョブの ID。

    ******73-8501-****-8ac1-72295a******

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "******3B-0E1A-586A-AC29-742247******",
  "TaskId": "******73-8501-****-8ac1-72295a******"
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 InvalidParameter%s %s.
    400 MissingParameter%s %s.
    400 TooManyRequests %s.
    500 InternalError %s.
    403 Forbidden %s.
    404 NotFound%s %s.

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

    変更履歴

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