tencent cloud

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"
 }
}

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

シナリオ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のミクスストリーミング効果

シナリオ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]の間であるかどうかをチェックします。
その他	その他エラーについては、 でカスタマーサービス に連絡し、テクニカルサポートを要請してください	-

よくあるご質問

• ミクスストリーミング中に入力ストリームの自動ズームを維持し、かつ黒枠がない状態にするにはどうすればよいですか。
• プッシュ後にミクスストリーミングした場合に、-505エラーコードが返されるのはなぜですか。
• ミクスストリーミングの申請後、ミクスストリーミングをキャンセルしない状態を継続した場合、どうなりますか。
• ミクスストリーミングのアシスタントキャスター画面が予想される位置とは異なることがあるのはなぜですか。

説明：

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