tencent cloud

Cloud Streaming Services

スタートガイド
製品紹介
製品概要
サブ製品の説明
基本概念
製品機能
ユースケース
製品の優位性
使用制限
購入ガイド
価格一覧
基本サービス
付加価値サービス
前払いリソースパッケージ
購入の流れ
課金の変更
返金説明
請求書の照会
支払い更新の説明
支払い遅延によるサービス停止の説明
課金についてのよくある質問
標準ライブストリーミング
概要
ユースケース
クイックスタート
SDKへのアクセスの説明
ライブイベントストリーミング(超低遅延ライブストリーミング)
概要
ライブイベントストリーミングと標準ライブストリーミングの違い
ユースケース
クイックスタート
SDKへのアクセスの説明
コンソールガイド
コンソールの説明
概要
Domain Management
ストリーム管理
リソースパッケージ管理
機能設定
プルリレー
従量課金
CAMアクセス制御
機能の実践
Push and Playback
ライブストリーミング機能
Live Streaming Security
海外のCSSサービス
コールバックによるイベントメッセージ通知
一般的なサードパーティ製ツールガイド
SDKの実践
0. SDK導入ガイド
2. 再生
3. 高度な機能
APIドキュメン
History
Introduction
API Category
Making API Requests
Live Pad APIs
Live Stream Mix APIs
Time Shifting APIs
Monitoring Data Query APIs
Billing Data Query APIs
Live Transcoding APIs
Delayed Playback Management APIs
Domain Name Management APIs
Watermark Management APIs
Certificate Management APIs
Stream Pulling APIs
Recording Management APIs
Live Callback APIs
Screencapturing and Porn Detection APIs
Authentication Management APIs
Live Stream Management APIs
Data Types
Error Codes
メンテナンスガイド
ビデオラグの最適化(V2)
プッシュエラーの原因調査
再生エラーの原因調査
ディレイの軽減方法
プルのビデオ画質が鮮明でない時の原因調査
COS Bucketにスクリーンキャプチャ保存するためのライブストリーミング承認
障害処理
ライブミクスストリーミングのエラー報告:InvalidParameter.OtherError
FAQs
基本的なライブブロードキャスト機能
プッシュ再生関連
ライブストリーミングの課金に関する事項
グローバルCSSサービス
CSSレコーディング関連
クラウドストリームミックス
ドメイン名設定
アップル社ATSとの互換性
SLA
CSS Service Level Agreement
CSS ポリシー
プライバシーポリシー
データ処理とセキュリティ契約

クラウドミクスストリーミング

PDF
フォーカスモード
フォントサイズ
最終更新日: 2025-11-14 15:41:20
CSSサービスはライブミクスストリーミング機能を提供します。設定済みのミクスストリーミングレイアウトに基づき、各入力ソースの複数のストリームを統合して同期時に新しいストリームとみなし、ライブストリーミングのインタラクティブ効果を実現します。また、CSSライブミクスストリーミング機能はAPI 3.0が接続されています。具体的には、ライブミクスストリーミングインターフェースをご参照ください。このテキストでは、例を挙げて、各種シナリオでライブストリーミングのミクスストリーミングを実現する方法を説明します。

注意事項

クラウドミクスストリーミング機能を使用すると、標準トランスコード料金が発生します。料金に関する説明については、トランスコード料金をご参照ください。
ミクスストリーミングのクリッピング機能を使用する場合は、クリッピングパラメータの値をソースストリームのパラメータより大きくすることはできません。

機能サポート

最大16のストリームのミクスストリーミングを同時にサポートします。
5種類の入力ソースタイプ(オーディオおよびビデオ、純粋なオーディオ、純粋なビデオ、画像、キャンバス)のミキシングをサポートします。
ミキシング後のストリームを新ストリームとして出力することをサポートします。
クリッピング、ウォーターマーク機能をサポートします。
テンプレートの設定をサポートします。
ミクスストリーミングのレコーディングをサポートします。
自動ミクスストリーミングをサポートします。
リアルタイムでミクスストリーミングの種類と位置の切り替えをサポートします。
ミクスストリーミングの開始とキャンセルの切り替えをシームレスに実行できます。

一般的なレイアウトテンプレート

一般的なテンプレートには、10、30、40、310、390、410、510および610があります。これら8つのテンプレートを使用する場合、入力ストリームに位置および長さと幅のパラメータを入力する必要はなく、オリジナル画面と同等比率のスケーリングになります。ただし、テンプレートIDが必要です。
一般的なレイアウトテンプレート:
テンプレート10
テンプレート30






テンプレート40
テンプレート310






テンプレート390
テンプレート410






テンプレート510
テンプレート610







ミクスストリーミングの作成

パラメータの説明

より詳細な説明をご覧になる場合は、 ライブミクスストリーミングをご参照ください。

シナリオ1:ミクスストリーミングの申請-20テンプレートの使用

ミクスストリーミングを使用して、テンプレートミクスストリーミングをプリセットします。

入力例

https://live.tencentcloudapi.com/?Action=CreateCommonMixStream
&MixStreamSessionId=test_room
&MixStreamTemplateId=20
&OutputParams.OutputStreamName=test_stream1
&InputStreamList.0.InputStreamName=test_stream1
&InputStreamList.0.LayoutParams.ImageLayer=1
&InputStreamList.1.InputStreamName=test_stream2
&InputStreamList.1.LayoutParams.ImageLayer=2
&<パブリックリクエストパラメータ>

出力例

{
"Response": {
"RequestId": "e8fa8015-0892-40d5-95c4-12a4bc06ed31"
}
}

キャスターのマイク接続のミクスストリーミング効果


img



シナリオ2:ミクスストリーミングの申請-390テンプレートの使用

ミクスストリーミングを使用して、テンプレートミクスストリーミングをプリセットします。

入力例

https://live.tencentcloudapi.com/?Action=CreateCommonMixStream
&MixStreamSessionId=test_room
&MixStreamTemplateId=390
&OutputParams.OutputStreamName=test_stream2
&InputStreamList.0.InputStreamName=test_stream1
&InputStreamList.0.LayoutParams.ImageLayer=1
&InputStreamList.0.LayoutParams.InputType=3
&InputStreamList.0.LayoutParams.ImageWidth=1920 (キャンバスの幅)
&InputStreamList.0.LayoutParams.ImageHeight=1080 (キャンバスの高さ)
&InputStreamList.0.LayoutParams.Color=0x000000
&InputStreamList.1.InputStreamName=test_stream2
&InputStreamList.1.LayoutParams.ImageLayer=2
&InputStreamList.2.InputStreamName=test_stream3
&InputStreamList.2.LayoutParams.ImageLayer=3
&<パブリックリクエストパラメータ>

出力例

{
"Response": {
"RequestId": "9d8d5837-2273-4936-8661-781aeab9bc9c"
}
}

キャスターPKのミクスストリーミング効果


img



シナリオ3:カスタマイズされたミクスストリーミングの例

カスタマイズされたレイアウトを使用します。そのうち、位置パラメータLocationXとLocationYは画面左上隅に対応する背景画面左上隅の絶対ピクセル距離です。




入力例

https://live.tencentcloudapi.com/?Action=CreateCommonMixStream
&MixStreamSessionId=test_room
&OutputParams.OutputStreamName=test_stream2
&InputStreamList.0.InputStreamName=test_stream1
&InputStreamList.0.LayoutParams.ImageLayer=1
&InputStreamList.0.LayoutParams.InputType=3
&InputStreamList.0.LayoutParams.ImageWidth = 1920
&InputStreamList.0.LayoutParams.ImageHeight= 1080
&InputStreamList.0.LayoutParams.Color=0x000000
&InputStreamList.1.InputStreamName=test_stream2
&InputStreamList.1.LayoutParams.ImageLayer=2
&InputStreamList.1.LayoutParams.ImageWidth = 640
&InputStreamList.1.LayoutParams.ImageHeight= 360
&InputStreamList.1.LayoutParams.LocationX= 50
&InputStreamList.1.LayoutParams.LocationY= 720
&InputStreamList.2.InputStreamName=test_stream3
&InputStreamList.2.LayoutParams.ImageLayer=3
&InputStreamList.2.LayoutParams.ImageWidth = 640
&InputStreamList.2.LayoutParams.ImageHeight= 360
&InputStreamList.2.LayoutParams.LocationX= 740
&InputStreamList.2.LayoutParams.LocationY= 720
&<パブリックリクエストパラメータ>

出力例

{
"Response": {
"RequestId": "8c443359-ba07-4b81-add8-a6ff54f9bf54"
}
}

カスタマイズされたミクスストリーミングの効果





ミクスストリーミングのキャンセル

パラメータの説明

具体的には、一般的なミクスストリーミングのキャンセルをご参照ください。

シナリオの例

session idに基づき、ミクスストリーミングをキャンセルします。

入力例

https://live.tencentcloudapi.com/?Action=CancelCommonMixStream
&MixStreamSessionId=test_room

出力例

{
"Response": {
"RequestId": "3c140219-cfe9-470e-b241-907877d6fb03"
}
}
ご注意:
ミクスストリーミングを申請後、5秒以上経ってから、ミクスストリーミングをキャンセルしてください。
ミクスストリーミングをキャンセルした後、30秒経たなければ、同一のsession idでミクスストリーミングを申請することができません。

エラーコード

クラウドミクスストリーミングAPI3.0は大部分の一般的なエラーコードを API3.0 エラーコード のスタイルに変換されていますが、一部のエラーコードをカバーしきれていない可能性があります。これらエラーコードはInvalidParameterでエラー表示され、 Message中にerr_code [ $code ],msg [ $message ]の形式で提示されます。具体的なcodeに対応する原因は次のとおりです。
エラーコード
原因
原因調査の推奨
-1
入力解析パラメータエラー
リクエストボディbody json形式が正しいかどうかをチェックします。
InputStreamListが空かどうかをチェックします。
-2
入力パラメータエラー
画面パラメータがオーバーフローしていないかチェックします。
-3
ストリーム数のエラー
入力ストリーム数が[1,16]の範囲内にあるかをチェックします。
-4
ストリームパラメータエラー
入力出力の長さと幅が(0,3000)の範囲内にあるかどうかをチェックします。
入力ストリーム数が(0、16]の範囲内にあるかどうかをチェックします。
入力ストリームがLayoutParamsを伴っているかどうかをチェックします。
InputTypeが(有効数値:0,2,3,4,5)をサポートしているかどうかをチェックします。
ストリームIDの長さが(1,80)を満たしているかどうかをチェックします。
-11
レイヤーエラー
レイヤー数と入力ストリーム数が一致しているかどうかをチェックします。
レイヤーIDが重複していないかをチェックします。
レイヤーIDが(0,16]の間にあるかどうかをチェックします。
-20
入力パラメータとインターフェースがマッチしません
入力ストリーム数がテンプレートIDとマッチしているかどうかをチェックします。
カラーパラメータが正しいかどうかをチェックします。
-21
ミクスストリーミング入力ストリーム数のエラー
入力ストリームの本数が2本以上であるかどうかをチェックします。
-28
背景の長さと幅の取得に失敗しました
キャンバスを設定する場合は、キャンバスの長さと幅が設定されているかどうかをチェックします。
バックグラウンドストリームが存在しているかどうかをチェックします(プッシュ後、5秒経ってから、再びミクスストリーミングする必要があります)。
-29
クリッピングパラメータのエラー
クリッピング位置がストリームの長さと幅を超過していないかチェックします。
-33
ウォーターマーク画像IDエラー
入力画像IDが設定さているかどうかをチェックします。
-34
ウォーターマーク画像URLの取得に失敗しました
画像が正常にアップロードされているかどうか、URLが生成済みかどうかをチェックします。
-111
OutputStreamName パラメータと OutputStreamType がマッチしません
OutputStreamTypeが0である場合、OutputStreamNameはInputStreamListに表示される必要があります。
OutputStreamTypeが1である場合、OutputStreamNameはInputStreamListに含まないでおく必要があります。
-300
出力ストリームIDがすでに使用されています
現在の出力ストリームが別のミクスストリーミングの出力ストリームとなっていないかどうかをチェックします。
-505
入力ストリームがuploadで見つかりません
プッシュの成功から5秒後に、ミクスストリーミングを開始します。 再生できるかどうかをチェックします。
-507
ストリームの長さと幅パラメータのクエリーに失敗
キャンバスの幅、高さが設定されているかどうかをチェックします。
プッシュが正常に実施されたかどうかをチェックし、プッシュから5秒後にミクスストリーミングを再開することを推奨します。
-508
出力ストリームIDエラー
同様のMixStreamSessionIdに異なる出力ストリームIDを使用する状況が存在するかどうかをチェックします。
-10031
ミクスストリーミングの起動に失敗
プッシュから5秒後に再びミクスストリーミングすることを推奨します。
-30300-31001-31002
ミクスストリーミングキャンセル時のsessionidが存在しません
MixStreamSessionIdが存在するかどうかをチェックします。
-31003
出力ストリームIDとsessionの出力ストリームID がマッチしません
ミクスストリーミングキャンセル時に入力した出力ストリームIDをチェックします。
-31004
出力ストリームのビットレートが不正です
出力ストリームのビットレートが[1,50000]の間であるかどうかをチェックします。
その他
その他エラーについては、 でカスタマーサービス に連絡し、テクニカルサポートを要請してください
-

よくあるご質問

説明:
クラウドミクスストリーミングに関連するその他の質問については、 クラウドミクスストリーミング関連をご参照ください。

ヘルプとサポート

この記事はお役に立ちましたか?

フィードバック