:StartLiveMPUTask

デフォルトでは、1 つのアプリケーションに対して最大 200 のシングルストリームリレータスクと最大 40 の混合ストリームリレータスクを作成できます。クォータを増やすには、チケットを送信してください。

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

開始

• StartLiveMPUTask 操作を呼び出してタスクを作成します。

  • ユーザーがチャネルに参加しない場合、チャネルが存在しないことを示すエラーが返されます。

  • ストリームが取り込まれない場合、ストリームリレーは実行されません。この場合、再生に利用できるリレーされたストリームはありません。

  • タスクが混合ストリームリレーモードの場合、再生用にリレーできるストリームを少なくとも 1 人のユーザーが取り込んでいることを確認してください。ストリームを取り込んでいないユーザーのペインには黒い画面が表示されます。

• ビジネスサーバーでタスクステータス、タスクモード、およびタスクパラメーターを記録することを推奨します。

  • タスクステータス：開始または停止。

  • タスクモード：シングルストリームリレーまたは混合ストリームリレー。

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

• 共同ストリーミングやバトルシナリオでは、タスクは混合ストリームリレーモードになります。ストリーマーが例外によりチャネルから退出して再度チャネルに参加した場合、ビジネスサーバーで StartLiveMPUTask 操作を直接呼び出して、記録されたタスクパラメーターに基づいてストリームリレーを開始できます。

  • タスクがシステムによって自動的にクリアされていない場合、タスクは直接開始されます。

  • タスクがシステムによって自動的にクリアされていない場合、「タスクは既に存在します」というメッセージが返されます。

終了

• ストリーマーがチャネルから退出した後、StopLiveMPUTask 操作を呼び出してタスクを停止する必要があります。

• タスクで指定されたすべてのユーザーがチャネルから退出しても、StopLiveMPUTask 操作を呼び出さない場合、システムは 2 分後にタスクを停止します。

QPS 制限

1 アカウントあたり、毎秒最大 500 回この操作を呼び出すことができます。この制限を超えたリクエストはドロップされ、サービス中断が発生します。この操作を呼び出す際は、この制限に注意することを推奨します。

レイアウトとボリュームの SEI

注 リレーされたストリームのストリーミングデータには SEI が含まれており、カスタム情報を伝達するために使用できます。SEI は、デコード中にビデオフレームデータから抽出できます。SEI 形式については、「リクエストパラメーター」セクションの PassThrough パラメーターの説明をご参照ください。

次の例は、共同ストリーミングシナリオを示しています：

単一のストリーマーがストリーミングしている場合、視聴者が受信する SEI メッセージには 1 人の参加者の情報のみが含まれます。共同ストリーミングまたはバトルが発生した場合、視聴者が受信する SEI メッセージには複数の参加者の情報が含まれます。たとえば、ユーザー ID が 111 のストリーマーがストリーミングしている場合、次の形式の SEI フレームが視聴者側に送信されます：
{"canvas":{"w":1920,"h":1080,"bgnd":0},"stream":[{"uid":"111","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} ユーザー ID が 111 のストリーマーがユーザー ID が 222 の共同ストリーマーと共同ストリーミングしている場合、次の形式の SEI フレームが視聴者側に送信されます：
{"canvas":{"w":1920,"h":1080,"bgnd":0},"stream":[{"uid":"111","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":"222","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} 視聴者は、ストリーム配列の数に基づいてストリーミングレイアウトが変更されたかどうかを判断できます。ストリーム配列が 1 つしか存在しない場合、単一のストリーマーがストリーミングしています。複数のストリーム配列が存在する場合、共同ストリーミングまたはバトルが進行中です。参加者のレイアウト情報は、混合ストリーム内の各参加者の位置を示すことができます。

SEI パススルー

• カスタム SEI を設定するには、StartLiveMPUTask 操作を呼び出して混合ストリームリレータスクを開始し、PassThrough パラメーターの下で PayloadContent パラメーターを指定するか、UpdateLiveMPUTask 操作を呼び出して混合ストリームリレータスクを更新し、PassThrough パラメーターの下で PayloadContent パラメーターを指定します。

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

• カスタム SEI は、PassThrough パラメーターの下の FollowIdr パラメーターを指定することで、キーフレームと共に送信することもできます。

  • カスタム SEI を定期的に送信し、同時にキーフレームと共にカスタム SEI を送信するように設定を構成できます。たとえば、Interval パラメーターを 1000 に、FollowIdr パラメーターを 1 に設定して、カスタム SEI を 1,000 ミリ秒ごとに送信し、キーフレームにカスタム SEI を含めることができます。

  • Interval パラメーターと FollowIdr パラメーターを指定しない場合、カスタム SEI は操作を呼び出したときに 1 回だけ送信されます。

たとえば、ユーザー ID が 111 のストリーマーがストリームを取り込み、UpdateLiveMPUTask 操作を呼び出して定期的な SEI を指定します。この操作では、Interval パラメーターは 1000 に、FollowIdr パラメーターは 0 に、PayloadContent パラメーターは "hello world" に設定されます。この場合、カスタム SEI は 1,000 ミリ秒ごとに送信されます。視聴者側で受信される SEI フレームは次の形式です：
{"canvas":{"w":1920,"h":1080,"bgnd":0},"stream":[{"uid":"111","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"}

チャネル間の混合ストリームリレー

複数のチャネルにまたがる複数のストリーマーからのストリームを混合し、混合ストリームを ApsaraVideo Live にリレーする場合は、チャネル間通話を開始したストリーマーのユーザー ID とチャネル ID、および他のストリーマーのユーザー ID を入力パラメーターとして指定して、混合ストリームリレータスクを作成する必要があります。例：バトルシナリオでは、チャネル A のストリーマー A がクライアントインターフェイスを使用してチャネル B のストリーマー B とのチャネル間バトルを開始し、混合ストリームをチャネル A の視聴者にリレーします。この例では、次のパラメーターが指定されます：

• ChannelID：channelA

• UserInfos の下の UserId：userA および userB

注 チャネル間の混合ストリームリレータスクを作成するには、クライアント側で SDK を使用してチャネル間通話が開始されていることを確認してください。異なるチャネルのユーザーが互いに通話していない場合、チャネル間の混合ストリームリレータスクを作成することはできません。チャネル間通話を開始する方法の詳細については、「チャネル間サブスクリプション」をご参照ください。