自動ストリームインジェストとストリームプル機能の実装 - ApsaraVideo Live

Alibaba Real-Time Communication (ARTC) SDK は、ユーザーがチャンネルに参加、ロールを切り替え、またはチャンネルから退出する際に、オーディオストリームとビデオストリームを自動的にストリームインジェストし、ストリームプルします。この機能はデフォルトで有効です。このトピックでは、機能の仕組みを説明し、無効化するためのサンプルコードを提供します。

仕組み

説明

音声のみのシナリオでは、オーディオストリームのみがストリームインジェストおよびストリームプルされます。
音声とビデオのシナリオでは、設定されているすべてのオーディオストリームとビデオストリームがストリームインジェストおよびストリームプルされます。

サンプルコード

自動ストリームインジェストとストリームプルを無効化する API

自動ストリームインジェストとストリームプルは個別に無効化できるため、それぞれの動作を独立して制御できます。

自動オーディオストリームとビデオストリームのストリームインジェストの無効化

Android

/* パラメーターを false に設定すると、ユーザーがチャンネルに参加した後にビデオストリームはパブリッシュされません。ビデオストリームをパブリッシュするには、この API を呼び出す必要があります。 */
/* パラメーターを true に設定すると、ユーザーがチャンネルに参加した直後にビデオストリームがパブリッシュされます。デフォルト値は true です。 */
mAliRtcEngine.publishLocalVideoStream(false);
/* パラメーターを false に設定すると、ユーザーがチャンネルに参加した後にオーディオストリームはパブリッシュされません。オーディオストリームをパブリッシュするには、この API を呼び出す必要があります。 */
/* パラメーターを true に設定すると、ユーザーがチャンネルに参加した直後にオーディオストリームがパブリッシュされます。デフォルト値は true です。 */
mAliRtcEngine.publishLocalAudioStream(false);

iOS

/* パラメーターを NO に設定すると、ユーザーがチャンネルに参加した後にビデオストリームはパブリッシュされません。ビデオストリームをパブリッシュするには、この API を呼び出す必要があります。 */
/* パラメーターを YES に設定すると、ユーザーがチャンネルに参加した直後にビデオストリームがパブリッシュされます。デフォルト値は YES です。 */
[self.engine publishLocalVideoStream:NO];
/* パラメーターを NO に設定すると、ユーザーがチャンネルに参加した後にオーディオストリームはパブリッシュされません。オーディオストリームをパブリッシュするには、この API を呼び出す必要があります。 */
/* パラメーターを YES に設定すると、ユーザーがチャンネルに参加した直後にオーディオストリームがパブリッシュされます。デフォルト値は YES です。 */
[self.engine publishLocalAudioStream:NO];

Windows

/* パラメーターを false に設定すると、ユーザーがチャンネルに参加した後にビデオストリームはパブリッシュされません。ビデオストリームをパブリッシュするには、この API を呼び出す必要があります。 */
/* パラメーターを true に設定すると、ユーザーがチャンネルに参加した直後にビデオストリームがパブリッシュされます。デフォルト値は true です。 */
mAliRtcEngine->PublishLocalVideoStream(false);
/* パラメーターを false に設定すると、ユーザーがチャンネルに参加した後にオーディオストリームはパブリッシュされません。オーディオストリームをパブリッシュするには、この API を呼び出す必要があります。 */
/* パラメーターを true に設定すると、ユーザーがチャンネルに参加した直後にオーディオストリームがパブリッシュされます。デフォルト値は true です。 */
mAliRtcEngine->PublishLocalAudioStream(false);

自動オーディオストリームとビデオストリームのストリームプルの無効化

Android

/* パラメーターを false に設定すると、ユーザーがチャンネルに参加した後にビデオストリームはサブスクライブされません。ビデオストリームをサブスクライブするには、subscribeRemoteMediaStream または subscribeRemoteVideoStream メソッドを呼び出す必要があります。 */
/* パラメーターを true に設定すると、ユーザーがチャンネルに参加した直後にビデオストリームがサブスクライブされます。デフォルト値は true です。 */
mAliRtcEngine.setDefaultSubscribeAllRemoteVideoStreams(false);
/* パラメーターを false に設定すると、ユーザーがチャンネルに参加した後にオーディオストリームはサブスクライブされません。オーディオストリームをサブスクライブするには、subscribeRemoteMediaStream または subscribeRemoteAudioStream メソッドを呼び出す必要があります。 */
/* パラメーターを true に設定すると、ユーザーがチャンネルに参加した直後にオーディオストリームがサブスクライブされます。デフォルト値は true です。 */
mAliRtcEngine.setDefaultSubscribeAllRemoteAudioStreams(false);

iOS

/* パラメーターを NO に設定すると、ユーザーがチャンネルに参加した後にビデオストリームはサブスクライブされません。ビデオストリームをサブスクライブするには、subscribeRemoteMediaStream または subscribeRemoteVideoStream メソッドを呼び出す必要があります。 */
/* パラメーターを YES に設定すると、ユーザーがチャンネルに参加した直後にビデオストリームがサブスクライブされます。デフォルト値は YES です。 */
[self.engine setDefaultSubscribeAllRemoteVideoStreams:NO];
/* パラメーターを NO に設定すると、ユーザーがチャンネルに参加した後にオーディオストリームはサブスクライブされません。オーディオストリームをサブスクライブするには、subscribeRemoteMediaStream または subscribeRemoteAudioStream メソッドを呼び出す必要があります。 */
/* パラメーターを YES に設定すると、ユーザーがチャンネルに参加した直後にオーディオストリームがサブスクライブされます。デフォルト値は YES です。 */
[self.engine setDefaultSubscribeAllRemoteAudioStreams:NO];

Windows

/* パラメーターを false に設定すると、ユーザーがチャンネルに参加した後にビデオストリームはサブスクライブされません。ビデオストリームをサブスクライブするには、SubscribeRemoteMediaStream または SubscribeRemoteVideoStream メソッドを呼び出す必要があります。 */
/* パラメーターを true に設定すると、ユーザーがチャンネルに参加した直後にビデオストリームがサブスクライブされます。デフォルト値は true です。 */
mAliRtcEngine.SetDefaultSubscribeAllRemoteVideoStreams(false);
/* パラメーターを false に設定すると、ユーザーがチャンネルに参加した後にオーディオストリームはサブスクライブされません。オーディオストリームをサブスクライブするには、SubscribeRemoteMediaStream または SubscribeRemoteAudioStream メソッドを呼び出す必要があります。 */
/* パラメーターを true に設定すると、ユーザーがチャンネルに参加した直後にオーディオストリームがサブスクライブされます。デフォルト値は true です。 */
mAliRtcEngine.SetDefaultSubscribeAllRemoteAudioStreams(false);