:StartLiveMPUTask

デフォルトでは、各アプリケーション ID は最大 200 の単一ストリームのアップストリーミングタスクと 40 の混合ストリームとトランスコードのタスクをサポートします。クォータを増やすには、チケットを送信してください。

混合ストリームタスクのライフサイクル

開始

• ストリーマーが初めてストリーミングを開始するときに、StartLiveMPUTask を呼び出してバイパスタスクを開始できます。

  • チャンネルにユーザーがいない場合、「channel does not exist」というエラーが返されます。

  • バイパスストリームは、ユーザーがアップストリーミングを開始した場合にのみ出力されます。単一ストリームタスクのユーザーがストリームをアップストリームしない場合、バイパスストリームは再生できません。

  • 混合ストリームタスクの場合、バイパスストリームを再生可能にするには、少なくとも 1 人のユーザーがストリームをアップストリームしている必要があります。ストリームをアップストリームしていないユーザーのレイアウトエリアは黒い画面で表示されます。

• ご利用のビジネスサーバーで、バイパスタスクのステータス、タスクタイプ、およびタスクパラメーターを記録できます。

  • タスクステータス：開始、停止。

  • タスクタイプ：単一ストリーム、混合ストリーム。

  • タスクパラメーター：最新の入力パラメーター。たとえば、UpdateLiveMPUTask の呼び出しが成功した後、最新のタスクパラメーターを記録します。

• 共同ストリーミングまたは PK シナリオで、タスクが混合ストリームタスクに更新された後、ストリーマーが予期せずチャンネルから退出してから再参加した場合、ご利用のビジネスサーバーは StartLiveMPUTask を呼び出して、保存されたタスクタイプとパラメーターに基づいて混合ストリームタスクを再開できます。

  • タスクを開始する前にシステムがタスクを自動的にクリアしていない場合、タスクは正常に開始されます。

  • システムがまだタスクをクリアしていない場合、Task already exists エラーコードが返されます。

終了

• ストリーマーがチャンネルから退出するときは、StopLiveMPUTask を呼び出してバイパスタスクを停止します。

• タスク内のすべてのユーザーがチャンネルから退出しても StopLiveMPUTask が呼び出されない場合、システムは 2 分後に自動的にバイパスタスクを停止します。

QPS 制限

この API の単一ユーザーに対する 1 秒あたりのクエリ数 (QPS) の上限は 500 回/秒です。この上限を超えると、API 呼び出しがスロットリングされます。これはビジネスに影響を与える可能性があります。この API は適切に呼び出すことを推奨します。

レイアウトと音量の SEI

共同ストリーミングシナリオの例：

ストリーマーが 1 人しかいない場合、視聴者が受信する SEI 情報の `stream` コレクションには、1 人のメンバーの情報のみが含まれます。ストリーマーが共同ストリーミングまたは PK セッションに参加している場合、`stream` コレクションには複数のメンバーの情報が含まれます。 たとえば、ストリーマー `streamer111` が単独でストリーミングしている場合、視聴者が受信する SEI フレームフォーマットは次のようになります：
{"canvas":{"w":1920,"h":1080,"bgnd":0},"stream":[{"uid":"streamer111","paneid":-1,"zorder":0,"x":0,"y":0,"w":0,"h":0,"type":0,"status":1,"muted":0,"vol":0,"vad":0}],"ver":"1.0.0.20220915","ts":1697696105170} ストリーマー `streamer111` が視聴者 `viewer222` と共同ストリーミングしている場合、視聴者が受信する SEI フレームフォーマットは次のようになります：
{"canvas":{"w":1920,"h":1080,"bgnd":0},"stream":[{"uid":"streamer111","paneid":0,"zorder":1,"x":0,"y":0.25,"w":0.5,"h":0.5,"type":0,"status":1,"muted":0,"vol":1,"vad":119},{"uid":"viewer222","paneid":1,"zorder":1,"x":0.5018382,"y":0.25,"w":0.5,"h":0.5,"type":0,"status":1,"muted":0,"vol":60,"vad":123}],"ver":"1.0.0.20220915","ts":1697696106230} `stream` 配列の要素数を確認することで、ライブレイアウトが変更されたかどうかを判断できます。`stream` 配列に 1 つの要素がある場合、単一のストリーマーがストリームをアップストリームしています。`stream` 配列に複数の要素がある場合、ストリーマーは共同ストリーミングまたは PK セッションに参加しています。各メンバーのレイアウト情報は、混合ストリームレイアウトにおけるそれぞれの特定の位置を示します。

パススルー SEI

• カスタム SEI を使用するには、StartLiveMPUTask コマンドを呼び出して混合ストリームとアップストリーミングタスクを開始し、`PassThrough` パラメーターで `PayloadContent` を指定します。また、UpdateLiveMPUTask コマンドを呼び出してタスクを更新し、`PassThrough` パラメーターで `PayloadContent` を指定することもできます。

• カスタム SEI は定期的に送信できます。期間は `PassThrough` の `Interval` パラメーターを使用して設定できます。単位はミリ秒です。

• カスタム SEI はキーフレームと共に送信することもできます。これは `PassThrough` の `FollowIdr` パラメーターを使用して設定できます。

  • SEI は定期的にもキーフレームと共にも送信できます。たとえば、`Interval:1000` と `FollowIdr: 1` は、カスタム SEI が 1000 ミリ秒ごとに送信され、すべてのキーフレームと共に送信されることを意味します。

  • `Interval` または `FollowIdr` を設定しない場合、カスタム SEI は API が呼び出されたときに一度だけ送信されます。

たとえば、ストリーマー `streamer111` が単独でストリーミングしている場合、UpdateLiveMPUTask コマンドを呼び出して定期的な SEI を送信できます。`PassThrough` パラメーターで、`Interval` を 1000、`FollowIdr` を 0、`PayloadContent` を "hello world" に設定します。すると、カスタム SEI メッセージが 1000 ミリ秒ごとに送信されます。視聴者が受信する SEI フレームフォーマットは次のようになります：
{"canvas":{"w":1920,"h":1080,"bgnd":0},"stream":[{"uid":"streamer111","paneid":-1,"zorder":0,"x":0,"y":0,"w":0,"h":0,"type":0,"status":1,"muted":0,"vol":0,"vad":0}],"ver":"1.0.0.20220915","ts":1697696109876,"udd":"hello world"}

クロスチャンネルの複数ユーザー混合ストリーム

複数のチャンネルにまたがる複数のストリーマーからのストリームを混合し、混合ストリームをライブストリーミングサービスにアップストリームするには、混合ストリームタスクを作成する際に、クロスチャンネルコールを開始したストリーマーの UserID と ChannelID、および他の参加者の UserID を入力パラメーターとして提供する必要があります。次の例をご参照ください： ライブ PK シナリオで、チャンネル `channelA` のストリーマー `userA` が、クライアント API を使用してチャンネル `channelB` のストリーマー `userB` とクロスチャンネル PK を開始します。両方のストリーマーの混合ストリームは、チャンネル `channelA` の視聴者に出力されます。この場合、混合ストリームタスクを作成するためのチャンネルとユーザーのパラメーターは次のように指定されます：

• ChannelID：`channelA` を指定します。

• UserInfos->UserId：それぞれ `userA` と `userB` を指定します。