ApsaraVideo Live:AliRtcEngine クラス

複数参加者会議のためにチャンネルに参加します。

public abstract int joinChannel(AliRtcAuthInfo authInfo, String userName);

このメソッドはチャンネルに参加します。ARTC はユーザーをチャンネルごとに整理します。ユーザーは音声または映像ストリームをパブリッシュまたはサブスクライブするためにチャンネルに参加する必要があります。このメソッド、joinChannel[1/3]、および joinChannel[3/3] はすべてチャンネルに参加しますが、認証方法と渡されるユーザー情報が異なります：

• joinChannel[1/3] は単一パラメーター認証を使用します。トークンベースの認証によって生成されたトークンを渡します。RTC シナリオでは、この方法を推奨します。

• これは複数パラメーターのメソッドです。トークンベースの認証によって生成された複数パラメーターのトークンと、トークン生成に使用されたユーザー情報を渡します。

• joinChannel[3/3] はリアルタイム対話型 AI 用です。単一パラメーターのトークンを渡し、シナリオに基づいて capabilityProfile を設定します。

制限事項

• チャンネルに参加した後、別のチャンネルに切り替えるには、まず <a baseurl="t2309760_v6_0_0.xdita" data-node="4086566" data-root="16090" data-tag="xref" href="#fef395c4beqdt" id="e2525ba6a0k3s">leaveChannel</a> を呼び出して現在のチャンネルから退出する必要があります。AliRtcEngineEventListener から <a baseurl="t2309760_v6_0_0.xdita" data-node="4086566" data-root="16090" data-tag="xref" href="#8c189be470bsp" id="6aefdfedb0op3">onLeaveChannelResult</a> コールバックを受信した後にのみ、新しいチャンネルに参加できます。

• このメソッドは一度に 1 つのチャンネルにしか参加できません。

• 異なる App ID を使用するアプリは相互運用できません。

関連コールバック

このメソッドを正常に呼び出した後、次のコールバックがトリガーされます：

• ローカルクライアントがチャンネルに参加した結果は、AliRtcEngineEventListener の <a baseurl="t2309760_v6_0_0.xdita" data-node="4086566" data-root="16090" data-tag="xref" href="#89f5ad2d0bnd1" id="fb41cdcfc6acj">onJoinChannelResult</a> コールバックを通じて通知されます。

• チャンネルへの参加に成功すると、リモート側は <a baseurl="t2309760_v6_0_0.xdita" data-node="4086566" data-root="16090" data-tag="xref" href="#7298cad465wnd" id="8e9d69ebe54sr">onRemoteUserOnLineNotify</a> コールバックをトリガーします。

パラメーター

戻り値

0 は成功を示します。0 以外の値は失敗を示します。

チャンネルに参加します (単一パラメーター認証)。

public abstract int joinChannel(String token, AliRTCSdkChannelParam channelParam);

このメソッドはチャンネルに参加します。ARTC はユーザーをチャンネルごとに整理します。ユーザーは音声または映像ストリームをパブリッシュまたはサブスクライブするためにチャンネルに参加する必要があります。このメソッド、joinChannel[1/3]、および joinChannel[2/3] はすべてチャンネルに参加しますが、認証方法と渡されるユーザー情報が異なります：

• joinChannel[1/3] は RTC シナリオ用です。トークンベースの認証による単一パラメーターのトークンを渡します。RTC シナリオでは、この方法を推奨します。

• joinChannel[2/3] は複数パラメーター認証を使用します。トークンベースの認証によって生成された複数パラメーターのトークンと、トークン生成に使用されたユーザー情報を渡します。

• このメソッドはリアルタイム対話型 AI 用です。単一パラメーターのトークンを渡し、capabilityProfile パラメーターを設定します。AI エージェント会話では、AliCapabilityProfileAiHuman を設定してください。

制限事項

• チャンネルへの参加に成功した後、セッション中に別のチャンネルに参加するには、まず <a baseurl="t2309760_v6_0_0.xdita" data-node="4086566" data-root="16090" data-tag="xref" href="#fef395c4beqdt" id="719d580348a95">leaveChannel</a> を呼び出して現在のチャンネルから退出し、<a baseurl="t2309760_v6_0_0.xdita" data-node="4086566" data-root="16090" data-tag="xref" href="#8c189be470bsp" id="d128acfee2fpd">onLeaveChannelResult</a> コールバックを AliRtcEngineEventListener から受信したことを確認する必要があります。その後、再度チャンネルに参加できます。

• このメソッドは一度に 1 つのチャンネルにしか参加できません。

• 異なる App ID を使用するアプリは相互運用できません。

• 参加に失敗した後の再試行時にこのメソッドを呼び出さないでください。

関連コールバック

このメソッドを正常に呼び出した後、次のコールバックがトリガーされます：

• ローカルクライアントがチャンネルに参加した結果は、AliRtcEngineEventListener の <a baseurl="t2309760_v6_0_0.xdita" data-node="4086566" data-root="16090" data-tag="xref" href="#89f5ad2d0bnd1" id="879ae2fa04zjd">onJoinChannelResult</a> コールバックを通じて返されます。

• ユーザーがチャンネルに正常に参加すると、リモートクライアントは <a baseurl="t2309760_v6_0_0.xdita" data-node="4086566" data-root="16090" data-tag="xref" href="#7298cad465wnd" id="9b5662c5a0nvf">onRemoteUserOnLineNotify</a> コールバックをトリガーします。

パラメーター

戻り値の説明

0 は成功を示します。0 以外の値は失敗を示します。

チャンネルから退出します。このメソッドを呼び出した後、SDK はリアルタイム通信を終了し、現在のチャンネルから退出します。

public abstract int leaveChannel();

呼び出しのタイミング

• チャンネルに参加した後に退出が必要な場合、これを呼び出します。

• すでにチャンネルに参加しており、別のチャンネルに参加する必要がある場合は、まずこれを呼び出します。

関連コールバック

• ローカルクライアント：このメソッドを呼び出した後、<a baseurl="t2309760_v6_0_0.xdita" data-node="4086566" data-root="16090" data-tag="xref" href="#8c189be470bsp" id="80f5e30245vfn">onLeaveChannelResult</a> コールバックがトリガーされ、チャンネルからの退出結果が通知されます。

• リモート側：この操作を正常に呼び出した後、リモートユーザーは <a baseurl="t2309760_v6_0_0.xdita" data-node="4086566" data-root="16090" data-tag="xref" href="#75c700a2376c1" id="69bf5ff199oda">onRemoteUserOffLineNotify</a> コールバックを通じて通知を受け取ります。

戻り値の説明

0 は成功を示します。0 以外の値は失敗を示します。

現在チャンネルに参加しているかどうかを確認します。

public abstract boolean isInCall();

戻り値

true：チャンネルに参加中。false：チャンネルに参加していません。

ユーザーのロールを設定します。

public abstract int setClientRole(AliRTCSdkClientRole clientRole);

このメソッドは、ユーザーのロールをストリーマーまたは視聴者として設定します。

インタラクティブモードでは、チャンネルに参加する前に：

• ロールをストリーマーに設定：SDK はデフォルトでローカル音声または映像をパブリッシュし、他のストリーマーの音声または映像を受信します。

• ロールを視聴者に設定：SDK はローカル音声または映像をパブリッシュせず、他のストリーマーの音声または映像のみを受信します。

呼び出しのタイミング

チャンネルに参加する前または後に呼び出すことができます。参加前にロールを設定するか、参加後にロールを切り替えることができます。

制限事項

このメソッドはインタラクティブモード (つまり、setChannelProfile を AliRTCSdkInteractiveLive で呼び出した後) のみで動作します。

インタラクティブモードでは、参加前にロールを明示的に設定することを推奨します。

パラメーター

ユーザーのロールをクエリします。

public abstract AliRTCSdkClientRole getCurrentClientRole();

戻り値の説明

現在のユーザーのロールを返します。

認証情報を更新します。

public abstract int refreshAuthInfo(AliRtcAuthInfo authInfo);

このメソッドは認証情報を更新します。トークンは一定期間経過後に期限切れとなり、サーバーへの接続ができなくなります。

呼び出しのタイミング

以下の条件で：

• <a baseurl="t2309760_v6_0_0.xdita" data-node="4086566" data-root="16090" data-tag="xref" href="#e9acb46a25uym" id="7e1510bec7s3s">onAuthInfoWillExpire</a> コールバックで認証情報の有効期限がまもなく切れるという報告を受け取った場合、サーバー側で新しいトークンを再生成し、このメソッドを呼び出して新しいトークンを渡すことを推奨します。

• トークンを適時に更新しない場合、<a baseurl="t2309760_v6_0_0.xdita" data-node="4086566" data-root="16090" data-tag="xref" href="#8fa7e60f9f5qq" id="97664f9e46fhp">onAuthInfoExpired</a> コールバックがトリガーされ、認証が期限切れであることが通知されます。この場合、トークンを再生成し、joinChannel を呼び出してチャンネルに再参加する必要があります。

パラメーター

戻り値の説明

0 は成功を示します。その他の値は失敗を示します。

認証情報を更新します。

public abstract int refreshAuthInfo(String token);

このメソッドはトークンを更新します。トークンは一定期間経過後に期限切れとなり、サーバーへの接続ができなくなります。

呼び出しのタイミング

以下の条件で、サーバーでトークンを再生成し、このメソッドを呼び出すことを推奨します：

• <a baseurl="t2309760_v6_0_0.xdita" data-node="4086566" data-root="16090" data-tag="xref" href="#e9acb46a25uym" id="d708af68eevs9">onAuthInfoWillExpire</a> コールバックで認証情報の有効期限がまもなく切れることが示されたとき。

• トークンを適時に更新しない場合、<a baseurl="t2309760_v6_0_0.xdita" data-node="4086566" data-root="16090" data-tag="xref" href="#8fa7e60f9f5qq" id="3fd674e985gl8">onAuthInfoExpired</a> 通知がトリガーされ、認証が期限切れであることが示されます。この時点で、joinChannel を呼び出してチャンネルに再参加する必要があります。

パラメーター

戻り値の説明

0 は成功を示します。その他の値は失敗を示します。

ローカルビデオストリームのパブリッシュを停止または再開できます。

public abstract int publishLocalAudioStream(boolean enable);

このメソッドは、ローカルでキャプチャされたオーディオトラックのパブリッシュを制御します。SDK はデフォルトでオーディオをパブリッシュします。パブリッシュを無効にするには、参加前に publishLocalAudioStream(false) を呼び出します。

呼び出しのタイミング

チャンネルに参加する前または後に呼び出すことができます。参加前に呼び出すと、デフォルトの動作が変更され、参加時に有効になります。

関連コールバック

ローカルオーディオストリームのアップストリーミング結果が変更された場合、ローカルクライアントは最新のオーディオストリームアップストリーミングステータスを通知するために <a baseurl="t2309760_v6_0_0.xdita" data-node="4086566" data-root="16090" data-tag="xref" href="#b7e3bb51c2ga9" id="4ced92c3f5hmj">onAudioPublishStateChanged</a> コールバックをトリガーし、リモートクライアントはリモートユーザーの音声および映像ストリームの変更を通知するために <a baseurl="t2309760_v6_0_0.xdita" data-node="4086566" data-root="16090" data-tag="xref" href="#7078e15087a0z" id="2b5460d448ga9">onRemoteTrackAvailableNotify</a> コールバックをトリガーします。

パラメーター

戻り値の説明

0 は成功を示します。その他の値は失敗を示します。

オーディオトラックがパブリッシュされているかどうかをクエリします。

public abstract boolean isLocalAudioStreamPublished();

戻り値の説明

true：オーディオトラックがパブリッシュされています。false：オーディオトラックがパブリッシュされていません。

リモートユーザーのオーディオトラックをデフォルトでサブスクライブするかどうかを指定します。

public abstract int setDefaultSubscribeAllRemoteAudioStreams(boolean sub);

このメソッドは、システムがリモートユーザーのオーディオトラックをデフォルトでサブスクライブするかどうかを構成します。これは新しく参加したユーザーのサブスクリプション動作に影響を与えます。特定の要件がない限り、true に設定することを推奨します。

呼び出しのタイミング

チャンネルに参加する前または後に呼び出すことができます。

• 参加前：

  • SDK はデフォルトでリモートユーザーのオーディオトラックをサブスクライブします。これを変更するには、参加前にこのメソッドを呼び出します。

• 参加後：

  • デフォルトのサブスクリプションを停止するには、setDefaultSubscribeAllRemoteAudioStreams(false) を呼び出します。その後に参加するユーザーはサブスクライブされません。

  • 特定のユーザーのサブスクリプションを再開するには、subscribeRemoteAudioStream を呼び出します。複数のユーザーに対しては、このメソッドを複数回呼び出します。

  • デフォルトのサブスクリプションを停止した後、setDefaultSubscribeAllRemoteAudioStreams(true) を呼び出すと、その後に参加するユーザーのみがサブスクライブされます。一時停止中に参加したユーザーは含まれません。

パラメーター

戻り値の説明

0 は成功を示します。その他の値は失敗を示します。

特定のリモートユーザーのオーディオストリームのプルを停止または再開できます。

public abstract int subscribeRemoteAudioStream(String uid, boolean sub);

この API は、特定のリモートユーザーのオーディオストリームのサブスクリプションを停止または再開します。シナリオで別途指定がない限り、true に設定することを推奨します。

パラメーター

戻り値の説明

0 は成功を示します。その他の値は失敗を示します。

すべてのリモートユーザーのオーディオトラックをサブスクライブするかどうかを指定します。

public abstract int subscribeAllRemoteAudioStreams(boolean sub);

このメソッドは、リモートオーディオトラックのサブスクリプションのマスタースイッチとして機能します。true に設定することを推奨します。false に設定すると、以下のようになります：

• 現在のセッション内のすべてのリモートオーディオトラックから即座にサブスクライブ解除されます。

• その後に参加する新しいユーザーもサブスクライブされません。

• <a baseurl="t2309760_v6_0_0.xdita" data-node="4086566" data-root="16090" data-tag="xref" href="#e09342eeb0z4k" id="a56b5f2a3f56k">subscribeRemoteAudioStream</a> を使用して、指定されたユーザーのオーディオストリームを個別に制御することはできません。

サブスクリプションを再開するには、このメソッドを再度呼び出し、sub を true に設定します。

パラメーター

戻り値の説明

0 は成功を示します。その他の値は失敗を示します。

カメラトラックをパブリッシュするかどうかを指定します。

public abstract int publishLocalVideoStream(boolean enable);

このメソッドは、ローカルでキャプチャされたビデオトラックのパブリッシュを制御します。

呼び出しのタイミング

チャンネルに参加する前または後に呼び出すことができます。

参加前に呼び出すと、デフォルトの構成が変更され、参加時に有効になります。

関連コールバック

ローカルオーディオストリームのアップストリーミング結果が変更された場合、ローカルクライアントは最新のオーディオストリームアップストリーミングステータスを通知するために <a baseurl="t2309760_v6_0_0.xdita" data-node="4086566" data-root="16090" data-tag="xref" href="#afe6d3c4b1rvg" id="8b70bc353aj68">onVideoPublishStateChanged</a> コールバックをトリガーし、リモートクライアントはリモートユーザーの音声および映像ストリームの変更を通知するために <a baseurl="t2309760_v6_0_0.xdita" data-node="4086566" data-root="16090" data-tag="xref" href="#7078e15087a0z" id="176ee94b46lb7">onRemoteTrackAvailableNotify</a> コールバックをトリガーします。

パラメーター

戻り値の説明

0 は成功を示します。その他の値は失敗を示します。

カメラトラックがパブリッシュされているかどうかをクエリします。

public abstract boolean isLocalVideoStreamPublished();

戻り値

true：カメラトラックがパブリッシュされています。false：カメラトラックがパブリッシュされていません。

リモートユーザーのビデオトラックをデフォルトでサブスクライブするかどうかを指定します。

public abstract int setDefaultSubscribeAllRemoteVideoStreams(boolean sub);

このメソッドは、リモートユーザーのビデオトラックをデフォルトでサブスクライブするかどうかを指定します。SDK はデフォルトでサブスクライブします。

呼び出しのタイミング

チャンネルに参加する前または後に呼び出すことができます。参加後に setDefaultSubscribeAllRemoteVideoStreams(false) を呼び出した場合、その後に参加するユーザーのビデオトラックは受信されません。

ビデオサブスクリプションを停止した後、再開するには、subscribeRemoteVideoStream を呼び出し、受信したいリモートユーザー ID を指定します。複数のユーザーに対しては、subscribeRemoteVideoStream を複数回呼び出します。setDefaultSubscribeAllRemoteVideoStreams(true) は、その後に参加するユーザーのみに再開を適用します。

このメソッドは、リモートユーザーのビデオトラックをデフォルトでサブスクライブするかどうかを指定します。

パラメーター

戻り値

0 は成功を示します。その他の値は失敗を示します。

指定されたリモートビデオトラックのサブスクリプションを開始または停止します。

public abstract int subscribeRemoteVideoStream(String uid, AliRtcVideoTrack track, boolean sub);

特定のユーザーのビデオストリームのサブスクリプションまたはアンサブスクリプションを行います。

呼び出しのタイミング

チャンネルに参加する前または後に呼び出すことができます。

パラメーター

戻り値の説明

• 0：成功しました。

• 0 以外：失敗しました。

すべてのリモートビデオストリームのサブスクリプションを開始または停止します。

public abstract int subscribeAllRemoteVideoStreams(boolean sub);

このメソッドは、リモートビデオストリームのサブスクリプションのマスタースイッチとして機能します。false に設定すると、以下のようになります：

• 現在のセッション内のすべてのリモートビデオストリームから即座にサブスクライブ解除されます。

• 後から参加する新しいユーザーも、 setDefaultSubscribeAllRemoteVideoStreams(true) を設定してデフォルトでサブスクライブするようにしても、サブスクライブしません。

• <a baseurl="t2309760_v6_0_0.xdita" data-node="4086566" data-root="16090" data-tag="xref" href="#b738a1b498bc1" id="19b0cea8593i5">subscribeRemoteVideoStream</a> を使用して、指定されたユーザーのビデオストリームを個別に制御することはできません。

サブスクリプションを再開するには、このメソッドを再度呼び出し、sub を true に設定します。

パラメーター

戻り値の説明

0 は成功を示します。その他の値は失敗を示します。

特定のリモート ユーザーからのメディア ストリームを停止または再開できます。

public abstract int subscribeRemoteMediaStream(String uid, AliRtcVideoTrack videoTrack, boolean subVideo, boolean subAudio);

このメソッドは、リモート音声および映像ストリームのサブスクリプションを統合します。

関連メソッド

<a baseurl="t2309760_v6_0_0.xdita" data-node="4086566" data-root="16090" data-tag="xref" href="#4cec275051vr6" id="faff82a053mev">subscribeRemoteMediaStream[2/2]</a> と比較して、このインターフェイスは subVideo および subAudio の 2 つのブール値パラメーターを使用して、リモート音声および映像ストリームのサブスクリプションを決定し、videoTrack でプルするビデオストリームを制御します。

パラメーター

戻り値の説明

0 は成功を示します。その他の値は失敗を示します。

リモートユーザーの音声および映像ストリームのサブスクリプションを開始または停止します。

public abstract int subscribeRemoteMediaStream(String uid, AliRtcVideoTrack videoTrack, AliRtcAudioTrack audioTrack) ;

このメソッドは、リモート音声および映像ストリームのサブスクリプションを統合します。

関連メソッド

subscribeRemoteMediaStream[1/2] と比較して、このインターフェイスは videoTrack および audioTrack パラメーターを使用して、単一のインターフェイス呼び出しでサブスクライブするメディアストリームを指定します。たとえば：

• カメラおよびマイクのストリームをサブスクライブするには、videoTrack および audioTrack をそれぞれ AliRtcVideoTrackCamera および AliRtcAudioTrackMic に設定します。

• カメラストリームのサブスクリプションを停止し、マイクを維持するには、videoTrack および audioTrack をそれぞれ AliRtcVideoTrackNo および AliRtcAudioTrackMic に設定します。

• 両方のサブスクリプションを停止するには、videoTrack および audioTrack をそれぞれ AliRtcVideoTrackNo および AliRtcAudioTrackNo に設定します。

• カメラおよび画面共有ストリームの両方をサブスクライブするには、videoTrack を AliRtcVideoTrackBoth に設定します。オーディオも同様です。

パラメーター

戻り値の説明

• 0：成功しました。

• <0：失敗しました。

チャンネル間で特定ユーザーのストリームのサブスクリプションを開始または停止します。

public abstract int subscribeRemoteDestChannelStream(String channelId, String uid, AliRtcVideoTrack track, boolean sub_audio, boolean sub);

パラメーター

戻り値の説明

0 は成功を示します。その他の値は失敗を示します。

チャンネル間ですべてのユーザーのストリームのサブスクリプションを開始または停止します。

public abstract int subscribeRemoteDestChannelAllStream(String channelId, AliRtcVideoTrack track, boolean sub_audio, boolean sub);

パラメーター

戻り値の説明

• 0：成功しました。

• 0 以外：失敗しました。

取り込まれたオーディオストリームの再生ボリュームを調整します。

public abstract int setRemoteAudioVolume(String uid, int volume);

このメソッドを使用して、特定のユーザーのオーディオストリームのローカルデバイス上での再生音量を調整します。

パラメーター

戻り値の説明

• 0：メソッドは正常に実行されました。

• 0 以外：失敗しました。たとえば、無効な音量値です。

ローカル音声データの送信を停止または再開します。

public abstract int muteLocalMic(boolean mute, AliRtcMuteLocalAudioMode mode);

呼び出しのタイミング

チャンネルに参加する前または後に呼び出すことができます。

関連コールバック

呼び出しが成功した後、リモートユーザーは <a baseurl="t2309760_v6_0_0.xdita" data-node="4086566" data-root="16090" data-tag="xref" href="#ea457055e4izi" id="cce3d390a3xud">onUserAudioMuted</a> をトリガーして、ユーザーがミュートされているかどうかを通知します。

パラメーター

戻り値の説明

0 は成功を示します。その他の値は失敗を示します。ミュートは無音フレームを送信しますが、キャプチャおよびエンコーディングはアクティブなままです。

特定のリモートユーザーのオーディオトラックの再生を停止または再開します。

public abstract int muteRemoteAudioPlaying(String uid, boolean mute);

この操作は、指定されたリモートユーザーのオーディオの再生を停止または再開する場合にのみ使用されます。ただし、リモートユーザーからのオーディオのストリームフェッチやデコードには影響しません。特定のユーザーのオーディオストリームのサブスクリプションを解除するには、<a baseurl="t2309760_v6_0_0.xdita" data-node="4086566" data-root="16090" data-tag="xref" href="#e09342eeb0z4k" id="66a2ef0919jjg">subscribeRemoteAudioStream</a> を呼び出します。

呼び出しのタイミング

チャンネルに参加する前または後にこの設定を行うことができます。

パラメーター

戻り値の説明

0 は成功を示します。その他の値は失敗を示します。

すべてのリモートユーザーのオーディオ再生を停止または再開します。

public abstract int muteAllRemoteAudioPlaying(boolean mute);

このメソッドは、すべてのリモートユーザーのオーディオ再生を停止または再開します。

呼び出しのタイミング

チャンネルに参加する前または後にこの設定を行うことができます。

パラメーター

戻り値の説明

0 は成功を示します。その他の値は失敗を示します。

音声キャプチャを開始します。

public abstract int startAudioCapture();

このメソッドは音声キャプチャを開始します。また、参加前に音声キャプチャを事前に開始するために、これも呼び出すことができます。設定しない場合、SDK が音声キャプチャデバイスを自動管理します。stopAudioCapture を呼び出して音声キャプチャを停止した後、このメソッドを呼び出して再開します。

呼び出しのタイミング

チャンネルに参加する前または後に呼び出すことができます。

関連メソッド

<a baseurl="t2309760_v6_0_0.xdita" data-node="4086566" data-root="16090" data-tag="xref" href="#b71a48f4b84n0" id="4565abdceeq8i">startAudioCapture[2/2]</a> インターフェイスでは、ミーティング終了後に音声キャプチャデバイスを有効な状態に保つかどうかをパラメーターで制御できます。

関連コールバック

このメソッドを呼び出してローカル音声キャプチャのステータスを変更した後、onLocalAudioStateChanged コールバックを使用して変更を監視します。

戻り値の説明

0 は成功を示します。その他の値は失敗を示します。

音声キャプチャを開始します。

public abstract int startAudioCapture(boolean keepAlive);

ミュート後にマイクキャプチャを停止します。

このメソッドは音声キャプチャを開始します。また、参加前に音声キャプチャを事前に開始するために、これも呼び出すことができます。設定しない場合、SDK が音声キャプチャデバイスを自動管理します。

呼び出しのタイミング

チャンネルに参加する前または後に呼び出すことができます。

関連メソッド

startAudioCapture[1/2] と比較して、このメソッドでは keepAlive パラメーターを使用して、チャンネル退出後の音声キャプチャデバイスの状態を制御できます。

関連コールバック

このメソッドを呼び出してローカル音声キャプチャのステータスを変更した後、onLocalAudioStateChanged コールバックを使用して変更を監視します。

パラメーター

戻り値の説明

0 は成功を示します。その他の値は失敗を示します。

音声キャプチャを停止します。

public abstract int stopAudioCapture();

SDK はデフォルトで音声キャプチャを有効にします。特別な構成がない場合、プレビュー開始やチャンネル参加などの操作により、音声キャプチャが自動的に開始されます。音声キャプチャを停止するには、このメソッドを呼び出します。

関連コールバック

このメソッドを呼び出してローカル音声キャプチャのステータスを変更した後、onLocalAudioStateChanged コールバックを使用して変更を監視します。

戻り値の説明

0 は成功を示します。その他の値は失敗を示します。

デフォルトのオーディオ出力がスピーカーであるかどうかを設定します。

public abstract int setDefaultAudioRoutetoSpeakerphone(boolean defaultToSpeakerphone);

このメソッドは、チャンネルに参加する前にデフォルトのオーディオルーティングデバイスを設定します。イヤホンまたはスピーカー出力を選択できます。SDK のデフォルトはスピーカーです。これを変更するには、参加前にこのメソッドを呼び出します。

SDK は内部的なオーディオルーティング優先順位を定義し、接続された周辺機器に基づいて自動的に切り替えます。優先順位：「有線ヘッドセット > Bluetooth ヘッドセット > ユーザー設定 > デフォルト設定」。したがって、周辺機器が接続されておらず、enableSpeakerphone を使用していない場合、デフォルト設定が適用されます。

オーディオルーティングの詳細については、「オーディオルーティング設定」をご参照ください。

モバイルデバイスは通常、イヤホンとスピーカーの 2 種類のオーディオルーティングオプションをサポートしています：

• イヤホン：音量が低く、明瞭な音声を得るには電話を耳に近づけて保持する必要があります。通話に最適なプライバシー性の高いオプションです。

• スピーカー：音量が高く、電話を耳に近づける必要がありません。ハンズフリー操作が可能になります。

関連メソッド

このメソッドはデフォルトのオーディオルーティング設定を変更します。enableSpeakerphone を使用して、現在のルーティングデバイスを設定します。

呼び出しのタイミング

チャンネルに参加する前または後に呼び出すことができます。

パラメーター

戻り値の説明

• 0：成功しました。

• <0：失敗しました。

オーディオ出力デバイスをイヤホンまたはスピーカーに設定します。

public abstract int enableSpeakerphone(boolean enable);

このメソッドは、チャンネルに参加した後の現在のオーディオ再生デバイスをイヤホンまたはスピーカーに設定します。設定しない場合、再生はデフォルトのオーディオルーティングデバイスを使用します。

SDK は内部的なオーディオルーティング優先順位を定義し、接続された周辺機器に基づいて自動的に切り替えます。優先順位：「有線ヘッドセット > Bluetooth ヘッドセット > ユーザー設定 > デフォルト設定」。したがって、周辺機器が接続されている場合、このメソッドは効果がありません。詳細については、「オーディオルーティング設定」をご参照ください。

呼び出しのタイミング

チャンネルに参加する前または後に呼び出すことができます。

関連メソッド

<a baseurl="t2309760_v6_0_0.xdita" data-node="4086566" data-root="16090" data-tag="xref" href="#d4dab00b21ebx" id="944fb5797e773">setDefaultAudioRoutetoSpeakerphone</a> は、デフォルトのオーディオルーティング設定を変更します。このインターフェイスは、現在のルーティングデバイスを設定します。

パラメーター

戻り情報

0 は成功を示します。その他の値は失敗を示します。

現在のオーディオ出力デバイスがイヤホンかスピーカーかをクエリします。

public abstract boolean isSpeakerOn();

戻り値の説明

true：スピーカー。false：イヤホン。

ユーザー音量表示を有効にします。

public abstract int enableAudioVolumeIndication(int interval, int smooth, int reportVad);

このメソッドにより、SDK はローカルユーザーおよび瞬間最大音量を持つリモートユーザーの音量情報を定期的に報告します。これを使用するには、AliRtcAudioVolumeObserver クラスを実装し、registerAudioVolumeObserver を使用して登録します。

呼び出しのタイミング

チャンネルに参加する前または後に呼び出すことができます。

関連コールバック

正常に呼び出した後、ユーザーがストリームをパブリッシュしている場合、SDK は設定された間隔でこれらのコールバックをトリガーします：

• スピーカー音量は AliRtcAudioVolumeObserver#onAudioVolume で報告されます。

• 音声活動検出 (VAD) は、話しているユーザーの UID を報告するために AliRtcAudioVolumeObserver#onActiveSpeaker をトリガーします。

パラメーター

戻り値の説明

0 は成功を示します。その他の値は失敗を示します。

インイヤーモニターを有効にします。

public abstract int enableEarBack(boolean enable);

このメソッドは、インイヤーモニターを有効または無効にします。有線または Bluetooth ヘッドフォンを使用する場合、最高の結果を得るために有効化することを推奨します。

呼び出しのタイミング

チャンネルに参加する前または後に呼び出すことができます。

パラメーター

戻り値の説明

0 は成功を示します。その他の値は失敗を示します。

インイヤーモニターの音量を設定します。

public abstract int setEarBackVolume(int volume) ;

このメソッドはインイヤーモニターの音量を設定します。enableEarBack が呼び出された後に有効になります。

呼び出しのタイミング

チャンネルに参加する前または後に呼び出すことができます。

パラメーター

戻り値

• 0：成功しました。

• <0：メソッド呼び出しが失敗しました。

オーディオ再生デバイスを開始します。

public abstract int startAudioPlayer();

このメソッドはオーディオ再生を事前に開始します。設定しない場合、SDK はオーディオストリームをサブスクライブした後に自動的に再生を開始します。

戻り値の説明

• 0：成功しました。

• 0 以外：失敗しました。エラーコードを返します。

オーディオ再生デバイスを停止します。

 public abstract int stopAudioPlayer();

このメソッドはオーディオ再生を停止します。startAudioPlayer に対応します。

戻り値の説明

• 0：成功しました。

• 0 以外：失敗しました。エラーコードを返します。

ローカル再生音量を設定します。

public abstract int setPlayoutVolume(int volume);

パラメーター

戻り値の説明

• 0：成功しました。

• 0 以外：失敗しました。

録音音量を設定します。

public abstract int setRecordingVolume(int volume);

パラメーター

戻り値の説明

• 0：成功しました。

• 0 以外：失敗しました。

オーディオファイルを再生します。

public abstract int playAudioFileTest(String filePath) ;

このメソッドは、チャンネルに参加する前にオーディオ再生をテストするためにオーディオファイルを再生します。

呼び出しのタイミング

チャンネルに参加する前にのみ呼び出してください。

制限事項

複数回の呼び出しは互いに上書きされます。これを呼び出すと、現在再生中のファイル (存在する場合) が停止します。

パラメーター

戻り値

• 0：成功しました。

• 0 以外：失敗しました。

オーディオファイルの再生を停止します。

public abstract int stopAudioFileTest();

このメソッドは、playAudioFileTest に対応し、オーディオファイルの再生を停止します。

制限事項

チャンネルに参加する前にのみ呼び出してください。

戻り値の説明

• 0：成功しました。

• 0 以外：失敗しました。

セッション開始前に音声キャプチャデバイスのテストを開始します。

public abstract int startAudioCaptureTest();

このメソッドは、セッション前にローカル音声キャプチャデバイスが正しく動作することを確認するために音声キャプチャテストを開始します。これを呼び出すと、SDK は AliRtcAudioVolumeObserver::onTestAudioVolume コールバックを介して音量情報を報告します。

呼び出しのタイミング

チャンネルに参加する前に呼び出します。テストが完了した後は、stopAudioCaptureTest を呼び出してテストを停止し、デバイスの競合を防止してください。

戻り値の説明

• 0：成功しました。

• 0 以外：失敗しました。エラーコードを返します。

音声キャプチャテストを停止します。

public abstract int stopAudioCaptureTest();

このメソッドは音声キャプチャテストを停止します。startAudioCaptureTest の後にこれを呼び出します。

呼び出しのタイミング

チャンネルに参加する前に呼び出します。

戻り値

• 0：成功しました。

• 0以外: 失敗した。エラーコードを返します。

ボイスチェンジ効果モードを設定します。

public abstract int setAudioEffectVoiceChangerMode(AliRtcAudioEffectVoiceChangerMode mode);

パラメーター

戻り値の説明

0 は成功を示します。その他の値は失敗を示します。

ピッチ調整値を設定します。

public abstract int setAudioEffectPitchValue(double value);

パラメーター

戻り値の説明

0 は成功を示します。その他の値は失敗を示します。

リバーブ効果モードを設定します。

public abstract int setAudioEffectReverbMode(AliRtcAudioEffectReverbMode mode);

パラメーター

戻り値の説明

0 は成功を示します。その他の値は失敗を示します。

リバーブ効果のタイプおよび特定のパラメーターを設定します。

public abstract int setAudioEffectReverbParamType(AliRtcAudioEffectReverbParamType type, float value);

パラメーター

戻り値の説明

0 は成功を示します。その他の値は失敗を示します。

定義済みの音声美化効果モードを設定します。

public abstract int setAudioEffectBeautifyMode(AliRtcAudioEffectBeautifyMode mode);

このメソッドは、SDK 内で提供される組み込みの音声美化モードを構成します。音声ライブ配信、カラオケ、音声 SNS アプリなど、音声品質を向上させる必要があるシナリオに最適です。異なるモードを選択することで、豊かさや明瞭さなどの音声の知覚が変わり、リモートユーザーの聴取体験が向上します。

呼び出しのタイミング

チャンネルに参加する前または後に呼び出すことができます。

パラメーター

戻り値の説明

• 0：成功しました。

• 0 以外：失敗しました。

オーディオイコライザー (EQ) パラメーターを設定して、特定の周波数帯域のゲインを調整します。

public abstract int setAudioEffectEqualizationParam(AliRtcAudioEffectEqualizationBandFrequency bandIndex, float gain);

このメソッドは、ローカルでキャプチャされた音声またはオーディオ信号にグラフィックイコライズを適用します。10 個の固定周波数帯域のうち 1 つの帯域のゲイン (dB 単位) を調整することで、トーン特性をカスタマイズできます。これは、発話の明瞭性向上、声の強調、ノイズ低減支援に役立ちます。

イコライザーは、31 Hz から 16 kHz までのフルオーディオスペクトルのチューニングをサポートしており、10 個の標準帯域があります。各帯域は [-15, 15] dB の独立したゲイン設定をサポートします。デフォルトのゲインは 0 dB (ブーストもアッテネーションもなし) です。

制限事項

• イコライザーを使用するには、まず音声美化モードを有効にする必要があります。このメソッドを呼び出す前に、setAudioEffectBeautifyMode を呼び出してください。

パラメーター

戻り値の説明

0：成功しました。

0 以外：失敗しました。

外部オーディオストリームを追加します。

public abstract int addExternalAudioStream(AliRtcExternalAudioStreamConfig config);

このメソッドは外部オーディオストリームを追加します。以下の手順に従ってください：

1. <a baseurl="t2309760_v6_0_0.xdita" data-node="4086566" data-root="16090" data-tag="xref" href="#42b363024fich" id="20c33a9acb0ui">addExternalAudioStream</a> API を呼び出して外部オーディオストリームを追加し、外部オーディオストリーム ID を取得します。

2. <a baseurl="t2309760_v6_0_0.xdita" data-node="4086566" data-root="16090" data-tag="xref" href="#930f22d3dcdco" id="d3deb62b2fl0f">pushExternalAudioStreamRawData</a> を呼び出して、作成したオーディオストリームにオーディオデータを送信します。

3. 通話終了時に、<a baseurl="t2309760_v6_0_0.xdita" data-node="4086566" data-root="16090" data-tag="xref" href="#0333f86114078" id="16d826dedcli6">removeExternalAudioStream</a> を呼び出して外部オーディオストリームを削除する必要があります。

チャンネル内でカスタムキャプチャされた音声をパブリッシュする方法については、「カスタム音声キャプチャ」をご参照ください。

パラメーター

戻り値の説明

値 >0 は成功を示し、外部オーディオストリーム ID を返します。その他の値は失敗を示します。

外部オーディオストリームデータをインポートします。

public abstract int pushExternalAudioStreamRawData(int streamId, AliRtcAudioFrame rawData);

このメソッドは、指定されたオーディオストリームにデータをインポートします。以下の手順に従ってください：

1. <a baseurl="t2309760_v6_0_0.xdita" data-node="4086566" data-root="16090" data-tag="xref" href="#42b363024fich" id="8822f2932e9ep">addExternalAudioStream</a> を呼び出して外部オーディオストリームを追加し、外部オーディオストリーム ID を取得します。

2. <a baseurl="t2309760_v6_0_0.xdita" data-node="4086566" data-root="16090" data-tag="xref" href="#930f22d3dcdco" id="880fe8cd02j10">pushExternalAudioStreamRawData</a> 操作を呼び出して、作成したオーディオストリームにオーディオデータをプッシュします。

3. 通話を終了した場合、<a baseurl="t2309760_v6_0_0.xdita" data-node="4086566" data-root="16090" data-tag="xref" href="#0333f86114078" id="106c7aefa27c0">removeExternalAudioStream</a> を呼び出して外部オーディオストリームを削除する必要があります。

チャンネル内でカスタムキャプチャされた音声をパブリッシュする方法の詳細については、「カスタム音声キャプチャ」をご参照ください。

呼び出しのタイミング

チャンネルに参加した後に呼び出すことができます。

パラメーター

戻り値の説明

0 の値は成功を示します。それ以外の値は失敗を示します。

アップストリーミング向けの外部オーディオストリームのボリュームを設定します。

public abstract int setExternalAudioStreamPublishVolume(int streamId, int publishVolume);

パラメーター

戻り値

戻り値が 0 の場合、成功を示します。その他の値は失敗を示します。

外部オーディオストリームのアップストリーミング音量を取得します。

public abstract int getExternalAudioStreamPublishVolume(int streamId);

パラメーター

戻り値の説明

音量は 0 から 100 の間です。負の値は失敗を示します。

外部オーディオストリームの再生音量を設定します。

public abstract int setExternalAudioStreamPlayoutVolume(int streamId, int playoutVolume);

パラメーター

戻り値の説明

0 は成功を示します。その他の値は失敗を示します。

外部オーディオストリームの再生音量を取得します。

public abstract int getExternalAudioStreamPlayoutVolume(int streamId);

パラメーター

戻り値の説明

再生音量は 0 から 100 の間です。負の値は失敗を示します。

外部オーディオストリームを削除します。

public abstract int removeExternalAudioStream(int streamId);

このメソッドは、指定された streamId に関連付けられた外部オーディオストリームを削除します。addExternalAudioStream メソッドと補完関係にあります。

呼び出しのタイミング

カスタム音声入力を使用したい場合は、addExternalAudioStream を呼び出してオーディオストリームを追加し、その ID を取得します。その後、pushExternalAudioStreamRawData を呼び出して、SDK に音声データを供給します。カスタム音声入力が不要になったら、このメソッドを呼び出してストリームを削除し、関連するリソースを解放します。

パラメーター

戻り値の説明

• 0：成功しました。

• <0：失敗しました。エラーコードを返します。

オーディオファイルに関する情報を取得します。

public abstract int getAudioFileInfo(String fileName);

このメソッドを非同期で呼び出して、ファイルの長さを取得できます。このメソッドは onAudioFileInfo コールバックを通じてオーディオファイル情報を返します。

パラメーター

導入に戻る

• 0：操作は成功しました。

• 0 以外の値：エラーコードが返されます。

音楽伴奏のミキシングを開始します。

public abstract int startAudioAccompany(String fileName, AliRtcAudioAccompanyConfig config) ;

このメソッドは、ローカルまたはオンラインの伴奏ファイルを再生します。非同期処理です。このメソッドを呼び出した後、AliRtcEngineNotify#onAudioAccompanyStateChanged を使用して伴奏再生ステータスを監視できます。

呼び出しのタイミング

チャンネルに参加した後のみ呼び出すことができます。

制限事項

効果音とは異なり、一度に再生できる伴奏は 1 つだけです。繰り返し呼び出すと、以前の伴奏が置き換えられます。

パラメーター

戻り値の説明

• 0：操作は成功しました。

• 0 以外：操作は失敗しました。エラーコードが返されます。

音楽伴奏のミキシングを停止します。

public abstract int stopAudioAccompany() ;

このメソッドは startAudioAccompany に対応し、伴奏再生を停止します。

呼び出しのタイミング

チャンネルに参加する前または後に呼び出すことができます。

戻り値の説明

• 0：成功しました。

• 0 以外：失敗しました。エラーコードが返されます。

このメソッドを使用して、音楽伴奏のローカル再生およびストリームアップストリーミングの両方の音量を設定できます。

public abstract int setAudioAccompanyVolume( int volume) ;

この操作は、音楽伴奏のローカル再生およびストリームアップストリーミングの両方の音量を設定します。これらの音量を個別に設定するには、ローカル再生用に setAudioAccompanyPlayoutVolume を、ストリームアップストリーミング用に setAudioAccompanyPublishVolume を使用します。

パラメーター

戻り値の説明

• 0：メソッド呼び出しは成功しました。

• 0 以外の値：メソッド呼び出しは失敗しました。エラーコードが返されます。

伴奏ストリームアップストリーミングの音量を設定します。

public abstract int setAudioAccompanyPublishVolume(int volume) ;

パラメーター

戻り値

• 0：成功しました。

• 0 以外：失敗しました。エラーコードが返されます。

伴奏ストリームアップストリーミング音量をクエリします。

public abstract int getAudioAccompanyPublishVolume() ;

戻り値の説明

伴奏音楽のストリームアップストリーミング音量。

• [0–100]：成功。

• その他の値：エラーコード。

伴奏のローカル再生音量を設定します。

public abstract int setAudioAccompanyPlayoutVolume(int volume) ;

パラメーター

戻り値の説明

• 0：成功しました。

• 0 以外：失敗しました。エラーコードが返されます。

伴奏音楽のローカル再生音量を取得します。

public abstract int getAudioAccompanyPlayoutVolume() ;

戻り値の説明

伴奏音楽のローカル再生音量。

• [0–100]：成功。

• その他の値：エラーコードを示します。

音楽伴奏のミキシングを一時停止します。

public abstract int pauseAudioAccompany();

戻り値の説明

• 0：成功しました。

• 0 以外：失敗しました。エラーコードが返されます。

音楽伴奏のミキシングを再開します。

public abstract int resumeAudioAccompany();

戻り値の説明

• 0：成功しました。

• 0 以外の値：失敗しました。エラーコードが返されます。

伴奏ファイルの長さをミリ秒単位でクエリします。

public abstract int getAudioAccompanyDuration();

このメソッドは、現在の伴奏ファイルの長さをクエリします。

戻り値

• >= 0：0 以上の値は伴奏ファイルの長さを示します。

• < 0：操作は失敗しました。エラーコードが返されます。

伴奏ファイルの再生進捗を取得します。

public abstract int getAudioAccompanyCurrentPosition();

このメソッドは、伴奏ファイルの現在の再生進捗をミリ秒単位で取得します。

戻り値の説明

• >=0：伴奏ファイルの再生進捗。

• <0：操作は失敗しました。エラーコードが返されます。

伴奏ファイルの再生位置を設定します。

public abstract int setAudioAccompanyPosition(int posMs);

このメソッドは、シークバーなどの機能に役立つ伴奏ファイルの再生進捗を設定します。正常に呼び出した後、再生は指定された位置から開始されます。

パラメーター

戻り値の説明

• 0：呼び出しは成功しました。

• 0 以外の値：呼び出しは失敗し、エラーコードが返されます。

効果音をプリロードします。

public abstract int preloadAudioEffect(int soundId, String filePath);

パラメーター

戻り値の説明

戻り値が 0 の場合、成功を示します。それ以外の値は失敗を示します。

プリロードされた効果音をアンロードします。

public abstract int unloadAudioEffect(int soundId);

パラメーター

戻り値の説明

戻り値が 0 の場合、成功を示します。0 以外の値は失敗を示します。

効果音を再生します。

public abstract int playAudioEffect(int soundId, String filePath, int cycles, boolean publish);

パラメーター

戻り値の説明

成功すると 0 を返します。0 以外の値は失敗を示します。

効果音の再生を停止します。

public abstract int stopAudioEffect(int soundId);

パラメーター

戻り値

戻り値が 0 の場合、成功を示します。それ以外の値は失敗を示します。

すべての効果音の再生を停止します。

public abstract int stopAllAudioEffects();

戻り値の説明

成功すると 0 が返されます。その他の値は失敗を示します。

効果音をストリームアップストリーミングにミキシングする際の音量を設定します。

public abstract int setAudioEffectPublishVolume(int soundId, int volume);

パラメーター

戻り値の説明

0 は成功を示します。その他の値は失敗を示します。

効果音をストリームアップストリーミングにミキシングする際に使用される音量レベルを取得します。

public abstract int getAudioEffectPublishVolume(int soundId);

パラメーター

戻り値

戻り値が 0 の場合、成功を示します。それ以外の値は失敗を示します。

効果音のローカル再生音量を設定します。

public abstract int setAudioEffectPlayoutVolume(int soundId, int volume);

パラメーター

戻り値の説明

戻り値が 0 の場合、成功を示します。それ以外の値は失敗を示します。

効果音のローカル再生音量を取得します。

public abstract int getAudioEffectPlayoutVolume(int soundId);

パラメーター

戻り値の説明

成功すると 0 を返します。その他の値は失敗を示します。

アップストリーミング中のすべての効果音のオーディオミキシングのボリュームを設定します。

public abstract int setAllAudioEffectsPublishVolume(int volume);

パラメーター

戻り値の説明

0 は成功を示します。その他の値は失敗を示します。

すべての効果音のローカル再生音量を設定します。

public abstract int setAllAudioEffectsPlayoutVolume(int volume);

パラメーター

戻り値の説明

戻り値が 0 の場合、成功を示します。それ以外の値は失敗を示します。

メディアファイルの録画を開始します。

public abstract boolean startRecord(AliRtcRecordType recordType, AliRtcRecordFormat recordFormat, String filePath, AliRtcRecordAudioConfig audioConfig, AliRtcRecordVideoConfig videoConfig, long maxSize, long maxDuration);

パラメーター

戻り値

TRUE は成功を示します。その他の値は失敗を示します。

メディアファイルの録画を停止します。

  public abstract void stopRecord();

パラメーター

なし。

効果音を一時停止できます。

public abstract int pauseAudioEffect(int soundId);

パラメーター

戻り値の説明

戻り値が 0 の場合、成功を示します。それ以外の値は失敗を示します。

このメソッドはすべての効果音を一時停止します。

public abstract int pauseAllAudioEffects();

戻り値の説明

戻り値が 0 の場合、成功を示します。それ以外の値は失敗を示します。

効果音の再生を再開できます。

public abstract int resumeAudioEffect(int soundId);

パラメーター

返品手順

戻り値が 0 の場合、成功を示します。それ以外の値は失敗を示します。

すべての効果音の再生を再開します。

public abstract int resumeAllAudioEffects();

戻り値の説明

0 は成功を示します。その他の値は失敗を示します。

SurfaceView レンダリングビューを作成します。

public abstract SophonSurfaceView createRenderSurfaceView(Context context);

ビデオビューを表示するには、このメソッドを直接 SurfaceView を作成する代わりに呼び出します。以下の手順に従ってください：

• 戻り値を AliRtcVideoCanvas#view に割り当てます。

• ローカルプレビュー表示ビューを設定するには setLocalViewConfig を呼び出し、リモートプレビュー表示ビューを設定するには setRemoteViewConfig を呼び出します。

呼び出しのタイミング

チャンネルに参加する前または後に呼び出すことができます。

制限事項

このメソッドはメインスレッドでのみ呼び出すことができます。

パラメーター

ローカルプレビューのレンダリングウィンドウおよび描画パラメーターを設定できます。

public abstract int setLocalViewConfig(AliRtcVideoCanvas viewConfig, AliRtcVideoTrack track);

このメソッドは、ローカルビデオストリームの表示ウィンドウ (view) をバインドし、レンダリングモード、ミラー化モード、回転角度を設定することでローカルプレビュー表示を設定します。この設定はローカルユーザーのプレビューにのみ影響し、公開されたビデオストリームには影響しません。リモートユーザーの UI 表示ビューを設定するには、setRemoteViewConfig を呼び出します。

呼び出しのタイミング

このメソッドは、チャンネルに参加する前または後に呼び出すことができます。

パラメーター

戻り値の説明

0 の値はメソッド呼び出しが成功したことを示します。それ以外の値はメソッド呼び出しが失敗したことを示します。

リモートユーザーのビデオストリームのレンダリングウィンドウおよび描画パラメーターを構成します。

public abstract int setRemoteViewConfig(AliVideoCanvas canvas, String uid,AliRtcVideoTrack track);

このメソッドは、指定されたリモートユーザーのビデオストリームに表示ビューをバインドし、そのユーザーのビデオのローカルレンダリングモード、ミラー化モード、回転角度を構成します。この設定は、ローカルユーザーに表示されるビデオにのみ影響します。ローカルプレビュー表示を構成するには、setLocalViewConfig を呼び出します。

• AliRtcVideoCanvas の view パラメーターが空の場合、レンダリングは停止します。

• 再生中に AliRtcVideoCanvas の renderMode パラメーターをリセットするには、他のすべてのパラメーターを変更せずに renderMode のみを変更します。

• 再生中に AliRtcVideoCanvas の mirrorMode パラメーターをリセットするには、他のすべてのパラメーターを変更せずに mirrorMode のみを変更します。

呼び出しのタイミング

リモートユーザーのビデオストリームが利用可能になったときにトリガーされる onRemoteTrackAvailableNotify コールバックを受信した後、つまりリモートユーザーのビデオストリームが利用可能になったときに、このメソッドを呼び出します。

パラメーター

戻り値の説明

戻り値が 0 の場合、成功を示します。それ以外の値は失敗を示します。

カメラキャプチャのプリファレンスを設定できます。たとえば、カメラの向きやフレームレートなどです。

public abstract int setCameraCapturerConfiguration(AliEngineCameraCapturerConfiguration cameraCapturerConfiguration);

このメソッドは、カメラキャプチャのプリファレンス (例：カメラの向きやフレームレートなど) を構成します。

呼び出しのタイミング

カメラを開く前にこのメソッドを呼び出します。たとえば、次の呼び出しの前です：

• startPreview (プレビュー開始)

• joinChannel (チャンネルへの参加)

パラメーター

戻り値の説明

戻り値が 0 の場合、成功を示します。それ以外の値は失敗を示します。

ローカルビデオキャプチャを無効または有効にします。

public abstract int enableLocalVideo(boolean enable);

このメソッドはローカルビデオキャプチャを制御します。無効にすると、ローカルプレビューおよびストリームアップストリーミングではビデオデータが生成されませんが、リモートビデオの受信には影響しません。このメソッドを使用してローカルカメラキャプチャを無効にすると、ローカルプレビューおよびリモート視聴者向けに最後にキャプチャされたフレームがフリーズします。

呼び出しのタイミング

このメソッドは、チャンネルに参加する前または後に呼び出すことができます。

関連コールバック

このメソッドを正常に呼び出した後、onUserVideoEnabled コールバックがリモートユーザーに対してトリガーされます。

パラメーター

戻り値

0 は成功を示します。それ以外の値は失敗を示します。

ローカルビデオデータの送信を停止または再開できます。

public abstract int muteLocalCamera(boolean mute, AliRtcVideoTrack track);

ストリームアップストリーミング中は、このメソッドを呼び出して黒いビデオフレームを送信できますが、ローカルプレビュー、およびキャプチャ・エンコーディング・送信モジュールには影響しません。

パラメーター

戻り値の説明

0 の値は成功を示します。

カメラが有効になっているかどうかを判定します。

public abstract boolean isCameraOn();

戻り値

true：カメラが有効です。false：カメラが無効です。

ビデオエンコーディングプロパティを設定します。

public abstract void setVideoEncoderConfiguration(AliRtcVideoEncoderConfiguration config);

このメソッドは、解像度、フレームレート、ビットレート、ビデオの向きなどのビデオストリームのエンコーディングパラメーターを設定します。すべてのビデオシナリオでこのメソッドを呼び出すことを推奨します。

呼び出しのタイミング

このメソッドは、チャンネルに参加する前または後に呼び出すことができます。カメラストリームのビデオエンコーディングプロパティをセッションごとに 1 回だけ設定する場合、チャンネルに参加する前にこのメソッドを呼び出すことを推奨します。

制限事項

このメソッドの mirrorMode パラメーターと setVideoMirrorMode メソッドの両方がビデオストリームのミラー化を設定します。どちらか一方のみを使用することを推奨します。両方を使用すると、ミラー化効果が重複し、ミラー化が失敗または不正になる可能性があります。

パラメーター

ビデオデコーディングプロパティを設定します。

    public abstract void setVideoDecoderConfiguration(AliRtcVideoDecoderConfiguration config);

このメソッドは、ビデオストリームのデコードのためのビデオパラメーターを構成します。

呼び出しのタイミング

チャンネルに参加する前にこのメソッドを呼び出すことができます。

パラメーター

前面および背面のカメラを切り替えます。デフォルトでは前面カメラが使用されます。

public abstract int switchCamera();

このメソッドを呼び出して、ビデオストリームを再起動したり、ビデオソースを再構成したりせずに、実行時にカメラを動的に切り替えることができます。

呼び出しのタイミング

カメラが正常に有効化された後にのみこのメソッドを呼び出します。

制限事項

このメソッドは Android および iOS プラットフォームでのみ使用可能です。

戻り値の説明

戻り値が 0 の場合、成功を示します。それ以外の値は失敗を示します。

現在のカメラの向きを取得します。

public abstract AliRTCCameraDirection getCurrentCameraDirection();

戻り値

• CAMERA_REAR (0) は背面カメラを示します。

• CAMERA_FRONT (1) は前面カメラを示します。

• CAMERA_INVALID (-1) は無効な状態を示します。

ローカルプレビューを開始します。

public abstract int startPreview();

このメソッドはローカルビデオプレビューを開始し、自動的にカメラをオンにします。ローカルプレビューを停止するには、stopPreview を呼び出すことができます。

呼び出しのタイミング

• 呼び出しを開始する前に `setLocalViewConfig` を呼び出してローカルプレビューのビューを設定する必要があります。そうしないと、プレビューは失敗しますが、アップストリーミングには影響しません。

• このメソッドを呼び出して、`joinChannel` を呼び出す前にプレビューを開始できます。カメラは自動的にオンになります。

戻り値の説明

戻り値が 0 の場合は成功を示します。それ以外の値は失敗を示します。

ローカルビデオプレビューを停止し、カメラをオフにします。

public abstract int stopPreview();

プレビューを停止した後、ローカルディスプレイは最後のフレームのままになります。アップストリーミングには影響しません。

呼び出しのタイミング

プレビューが開始された後にこのメソッドを呼び出してプレビューを停止できます。

戻り値

戻り値が 0 の場合は成功を示します。それ以外の値は失敗を示します。

カメラのズーム係数を設定します。

public abstract int setCameraZoom(float zoom);

このメソッドはカメラのズーム係数を設定します。

制限事項

このメソッドは iOS および Android でのみサポートされています。

呼び出しのタイミング

ズーム係数はカメラを有効にした後にのみ設定できます。カメラが再起動するたびにズーム係数はリセットされます。

パラメーター

戻り値

• 0：呼び出しは成功しました。

• 0 以外の値：呼び出しは失敗しました。

サポートされている最大のカメラズーム (デジタルズーム) 係数をクエリします。

public abstract float GetCameraMaxZoomFactor();

返品手順

デバイスのカメラがサポートする最大ズーム係数。

現在のカメラのズーム係数を取得します。

public abstract float GetCurrentZoom();

戻り値の説明

現在のカメラのズーム係数。

カメラの露出レベルを設定します。

public abstract int SetExposure(float exposure);

撮影環境が過度に暗いまたは明るい場合、キャプチャされたビデオの品質に影響を与える可能性があります。より良いビデオ効果を得るために、このメソッドを使用してカメラの露出レベルを調整できます。getMinExposure および getMaxExposure を使用して、サポートされている露出範囲をクエリできます。

パラメーター

戻り値

• 0：成功しました。

• 0 以外：失敗しました。

現在アクティブなカメラの露出レベルをクエリします。

public abstract float GetCurrentExposure();

現在アクティブな (カメラ) の露出レベルをクエリします。

戻り値の説明

現在のカメラの露出レベル。

サポートされている最小のカメラ露出レベルを取得します。

public abstract float GetMinExposure();

戻り値の説明

最小のカメラ露出レベル。

サポートされている最大のカメラ露出レベルを返します。

public abstract float GetMaxExposure();

戻り値の説明

最大のカメラ露出レベル。

カメラのフラッシュをオンまたはオフにします。

public abstract int setCameraFlash(boolean flash);

フラッシュをオンまたはオフにできます。

制限事項

このメソッドは iOS および Android でのみ使用可能です。

パラメーター

戻り値の説明

• 0：成功しました。

• 0 以外：失敗しました。

現在のデバイスがマニュアルフォーカスをサポートしているかどうかを判定します。

public abstract boolean isCameraFocusPointSupported();

現在のカメラがフォーカスポイントを設定してマニュアルフォーカスをサポートできるかどうかを判定します。

制限事項

このメソッドは iOS および Android でのみサポートされています。

戻り値の説明

• true：デバイスはマニュアルフォーカスをサポートしています。

• false：デバイスはマニュアルフォーカスをサポートしていません。

デバイスがカメラの露出ポイントの設定をサポートしているかどうかを判定します。

public abstract boolean isCameraExposurePointSupported();

このメソッドは、現在のデバイスがカメラの露出ポイントの設定をサポートしているかどうかを判定します。

制限事項

このメソッドは iOS および Android でのみサポートされています。

戻り値の説明

• true：デバイスはカメラの露出ポイントの設定をサポートしています。

• false：デバイスはカメラの露出ポイントの設定をサポートしていません。

カメラのマニュアルフォーカスポイントを設定できます。

public abstract int setCameraFocusPoint(float x, float y);

現在のカメラのフォーカスポイントを設定します。このメソッドを呼び出した後、カメラは指定されたポイントに一度露出調整を行い、そのフォーカス値を維持します。このメソッドを呼び出す前に、isCameraFocusPointSupported を使用してデバイスがマニュアルフォーカスをサポートしているかどうかを確認してください。

制限事項

このメソッドは iOS および Android でのみ使用可能です。

パラメーター

戻り値の説明

• 0：成功しました。

• 0 以外：失敗しました。

カメラの露出ポイントを設定します。

public abstract int setCameraExposurePoint(float x, float y);

このメソッドを呼び出した後、カメラは指定されたポイントに一度露出調整を行い、その露出値を維持します。このメソッドを呼び出す前に、isCameraExposurePointSupported を使用してデバイスが露出ポイントの設定をサポートしているかどうかを確認することを推奨します。

制限事項

このメソッドは iOS および Android でのみ使用可能です。

パラメーター

戻り値の説明

• 0：呼び出しは成功しました。

• 0 以外：呼び出しは失敗しました。

カメラが自動顔フォーカスをサポートしているかどうかを確認します。

public abstract boolean isCameraAutoFocusFaceModeSupported();

カメラが自動顔フォーカスをサポートしているかどうかを判定します。

呼び出しのタイミング

このメソッドはカメラが有効になった後にのみ呼び出すことができます。カメラが有効になる前にこのメソッドが呼び出された場合、デフォルトで false を返します。カメラが有効で、自動顔フォーカスをサポートしている場合、このメソッドは true を返します。

制限事項

このメソッドは iOS および Android でのみ使用可能です。

戻り値の説明

• true：カメラは自動顔フォーカスをサポートしています。

• false：カメラは自動顔フォーカスをサポートしていません。

カメラの顔フォーカスを設定します。

public abstract boolean setCameraAutoFocusFaceModeEnabled(boolean enable);

このメソッドは、カメラフォーカスのためのリアルタイム顔検出を有効または無効にします。このメソッドを呼び出す前に、isCameraAutoFocusFaceModeSupported を使用してデバイスのサポートを確認してください。

制限事項

このメソッドは iOS および Android でのみ使用可能です。

パラメーター

戻り値の説明

• true：呼び出しは成功しました。

• false：呼び出しは失敗しました。

プレビューとアップストリーミングのビデオミラーリングを設定できます。

public abstract int setVideoMirrorMode(AliRtcVideoPipelineMirrorMode mirrorMode);

ローカルビデオプレビューおよび公開されたビデオストリームのミラーリングを有効または無効にします。

呼び出しのタイミング

チャンネルに参加する前または後に動的に設定できます。SDK は状態を記録し、プレビューおよびエンコーディング (ストリームアップストリーミング) がアクティブなときにビデオ操作を適用します。

制限事項

このメソッドは、setLocalViewConfig および setVideoEncoderConfiguration の mirrorMode 設定と重複します。これらのメソッドのいずれか 1 つのみを使用できます。

パラメーターの説明

戻り値の説明

• 0 は成功を示します。

• <0：設定に失敗しました。

  • ERR_INNER (–1)：SDK 内部の状態エラーが発生しました。SDK インスタンスが正常に作成されたことを確認してください。

ビデオキャプチャのスケーリングのタイミングを設定します。

public abstract void setCapturePipelineScaleMode(AliRtcCapturePipelineScaleMode mode);

ビデオキャプチャのスケーリングがキャプチャ中またはエンコーディング中に発生するかどうかを決定します。たとえば、キャプチャ解像度がエンコーディング解像度と異なる場合、スケーリングのタイミングを設定して、プレビューデータが公開データと一致するようにできます。

呼び出しのタイミング

カメラを開く前に、たとえば startPreview または joinChannel を呼び出す前に設定できます。

パラメーター

戻り値の説明

なし。

外部ビデオ入力ソースを有効にできます。

public abstract void setExternalVideoSource(boolean enable,boolean useTexture,
 AliRtcVideoTrack streamType,AliRtcRenderMode renderMode);

パラメーター

ビデオデータを入力します。

public abstract int pushExternalVideoFrame(AliRtcRawDataFrame aliRawDataFrame,AliRtcVideoTrack streameType);

パラメーター

戻り値

操作が成功した場合は 0 を返します。それ以外の場合は、エラーコードが返されます。

リレーライブストリーミングを開始します。

public abstract int startPublishLiveStream(String streamUrl,AliRtcLiveTranscodingParam transcodingParam);

パラメーター

返却手順

成功すると 0 を返します。失敗すると 0 以外の値を返します。

リレーライブストリームのパラメーターを更新します。

public abstract int updatePublishLiveStream(String streamUrl,AliRtcLiveTranscodingParam transcodingParam);

パラメーター

戻り値の説明

戻り値が 0 の場合、成功を示します。それ以外の値は失敗を示します。

リレーライブストリームを停止します。

public abstract int stopPublishLiveStream(String streamUrl);

パラメーター

戻り値の説明

戻り値が 0 の場合、成功を示します。それ以外の値は失敗を示します。

このメソッドを使用して、リレーライブストリーミングのステータスをクエリできます。

public abstract AliRtcEngine.AliRtcLiveTranscodingState getPublishLiveStreamState(String streamUrl);

パラメーター

戻り値の説明

このメソッドは、リレーライブストリーミングのステータスを返します。

ネットワーク品質テストを開始します。

public abstract int startNetworkQualityProbeTest(AlirtcNetworkQualityProbeConfig config);

パラメーター

戻り値の説明

0 は成功を示します。その他の値は失敗を示します。

ネットワーク品質テストを停止します。

public abstract int stopNetworkQualityProbeTest();

戻り値の説明

戻り値が 0 の場合、成功を示します。それ以外の値は失敗を示します。

メディア拡張情報を送信します。

public abstract int sendMediaExtensionMsg(byte[]message, int repeatCount, int delay, boolean isKeyFrame);

SDK を使用すると、メディア拡張メッセージを送受信できます。このメソッドは、SEI 拡張プロトコルを使用してメディア拡張メッセージを送信します。受信者は、onMediaExtensionMsgReceived をリッスンすることでメッセージを取得できます。

一般的なユースケースは次のとおりです：

• メディア拡張メッセージを使用して、タイムスタンプを送信したり、エンドツーエンドのネットワーク遅延を計算したり、他のビジネスロジックとデータを同期したりできます。

• メディア拡張メッセージを使用して、説明情報を送信できます。現在、最大 4 KB のデータを送信でき、少量のデータに適しています。JSON またはプレーン文字列の使用を推奨します。

呼び出しのタイミング

アップストリーミングを開始した後、これを呼び出すことができます。

制限事項

メディア拡張メッセージは、音声および映像データチャンネルを共有します。したがって、カスタムメッセージの送信頻度とデータ長を制御する必要があります。制限事項は次のとおりです：

• SEI 情報は H.264/H.265 ストリーム内で送信されるため、プロファイルで構成されているように、1 秒あたり最大 fps のメッセージを送信できます。拡張情報は、ビデオフレームがエンコードされるときにのみ添付できます。

• メディアデータ送信品質への影響を避けるため、カスタムメッセージ本文の長さは 4 KB に制限されており、少量の情報の送信に適しています。

• sendMediaExtensionMsg の repeatCount パラメーターは、メッセージの冗長性を指定します。値が 1 より大きい場合、メッセージは複数回送信されます。

• これにより、パケット損失によるメッセージの損失を防ぎます。ルーム内の他の参加者は重複したメッセージを受信するため、重複排除が必要です。

• リレーライブストリーミングのサブスクライバーもカスタムメッセージを受信します。

• 一度に送信できる MediaExtensionMsg は 1 つだけです。sendMediaExtensionMsg を複数回呼び出すと、以前のデータが上書きされます。

関連コールバック

パブリッシャーがメディア拡張メッセージを送信すると、サブスクライバーは onMediaExtensionMsgReceived コールバックでそれらを受信します。

パラメーター

戻り値の説明

• 0：成功しました。

• <0：呼び出しは失敗し、エラーコードが返されます。

  • ERR_INNER(-1)：SDK 内部エラー。考えられる原因：SDK が初期化されていない、または破棄された後に呼び出された。

メディア拡張情報を送信します。

public abstract int sendMediaExtensionMsgEx(byte[]message, int repeatCount, int delay, boolean isKeyFrame, int payloadType);

SDK は、メディア拡張メッセージを送受信する機能を提供します。このメソッドは、SEI 拡張プロトコルを使用してメディア拡張メッセージを送信します。受信者は、onMediaExtensionMsgReceived をリッスンすることでメッセージを取得できます。payloadType が 5 の場合、sendMediaExtensionMsg メソッドを使用するのと同等です。

一般的なユースケースは次のとおりです：

• メディア拡張メッセージを使用して、タイムスタンプを送信したり、エンドツーエンドのネットワーク遅延を計算したり、他のビジネスロジックとデータを同期したりできます。

• メディア拡張メッセージを使用して、説明情報を送信できます。データサイズは 4 KB に制限されており、少量のペイロードに適しています。JSON またはプレーン文字列の使用を推奨します。

呼び出しのタイミング

アップストリーミングを開始した後、これを呼び出すことができます。

制限事項

メディア拡張メッセージは音声/映像データチャンネルを使用するため、カスタムメッセージの送信頻度とデータ長を制御する必要があります。制限事項は次のとおりです：

• SEI 情報は H.264 または H.265 ストリーム内で送信され、拡張情報はビデオフレームがエンコードされるときにのみ添付できるため、プロファイルで指定されているように、1 秒あたり最大 fps のメッセージを送信できます。

• メディアデータ送信品質への影響を避けるため、カスタムメッセージ本文の長さは 4 KB に制限されており、少量の情報の送信に適しています。

• sendMediaExtensionMsg の repeatCount パラメーターは、メッセージの冗長性を指定します。このパラメーターが 1 より大きい場合、メッセージは複数回送信されます。

• これにより、パケット損失によるメッセージの損失を防ぎます。ルーム内の他の参加者は重複したメッセージを受信するため、重複排除が必要です。

• リレーライブストリーミングのサブスクライバーもカスタムメッセージを受信します。

• 一度に送信できる MediaExtensionMsg は 1 つだけです。sendMediaExtensionMsg を複数回呼び出すと、以前のデータが上書きされます。

戻り値

戻り値の説明

• 0：操作は成功しました。

• <0：呼び出しは失敗し、エラーコードが返されます。

  • ERR_INNER(-1)：SDK 内部エラー。このエラーは、初期化前または破棄後に SDK が呼び出された場合に発生します。

このコールバックは、ネットワーク接続ステータスが変更されたときに呼び出されます。

public void onConnectionStatusChange(AliRtcEngine.AliRtcConnectionStatus status,
 AliRtcEngine.AliRtcConnectionStatusChangeReason reason);

パラメーター

オンプレミスデバイスから異常なコールバックが受信されます。このコールバックを処理する必要があります。

public void OnLocalDeviceException(AliRtcEngine.AliRtcEngineLocalDeviceType deviceType, AliRtcEngine.AliRtcEngineLocalDeviceExceptionType exceptionType, String msg)

パラメーターの説明

このコールバックは、ユーザー認証の有効期限がまもなく切れるときにトリガーされます。このコールバックを受信してから 30 秒後に認証が期限切れになります。このコールバックを注意深く監視してください。

public void onAuthInfoWillExpire();

このコールバックは、ユーザー認証情報がまもなく期限切れになることを示します。このコールバックを受信してから 30 秒後に認証が期限切れになります。次のいずれかの方法で新しいトークンを取得し、認証情報を更新できます：

• <a baseurl="t2309760_v6_4_1.xdita" data-node="4086566" data-root="16090" data-tag="xref" href="#975b9af9ecq1a" id="8099ac5a509hn">refreshAuthInfo</a> API を呼び出して認証情報を更新します。

• <a baseurl="t2309760_v6_0_0.xdita" data-node="4086566" data-root="16090" data-tag="xref" href="#fef395c4beqdt" id="fe88be037dy4g">leaveChannel</a> を呼び出して現在のチャンネルから退出 し、その後 joinChannel を呼び出してチャンネルに再参加します。

トリガーのタイミング

SDK は、ユーザー認証情報が期限切れになる 30 秒前にこのコールバックをトリガーします。このコールバックを受信した後、速やかに認証情報を更新する必要があります。

ユーザーが認証を必要とする API を呼び出すと、サーバー側は「情報が期限切れです」というメッセージを返します。

public void onAuthInfoExpired();

セッションを続行するには、サーバーで新しいトークンを生成し、次の方法で認証情報を更新します：

• <a baseurl="t2309760_v6_0_0.xdita" data-node="4086566" data-root="16090" data-tag="xref" href="#fef395c4beqdt" id="c3b0cf2f19dgm">leaveChannel</a> を呼び出して現在のチャンネルから退出 し、その後 joinChannel を呼び出してチャンネルに再参加します。

トリガーのタイミング

このコールバックは、ユーザー認証情報が期限切れになったときにトリガーされます。

このコールバックは、チャンネルへの参加結果を返します。

public void onJoinChannelResult(int result, String channel, String userId, int elapsed);

パラメーター

このコールバックは、チャンネルからの退出結果を返すために呼び出されます。

public void onLeaveChannelResult(int result, AliRtcEngine.AliRtcStats stats);

トリガー条件

このコールバックは、アプリケーションが <a baseurl="t2309760_v6_0_0.xdita" data-node="4086566" data-root="16090" data-tag="xref" href="#fef395c4beqdt" id="7f3d2133c81tx">leaveChannel</a> を正常に呼び出してチャンネルから退出したときにトリガーされ、現在のチャンネルセッションの結果とパフォーマンス統計を提供します。

パラメーター

リモートユーザーのオフラインイベントのコールバック。

public void onRemoteUserOffLineNotify(String uid, AliRtcUserOfflineReason reason);

このコールバックは、リモートユーザーがオフラインになったときにトリガーされ、ユーザーがチャンネルから退出したことを示します。

トリガー条件

• このコールバックは、リモートユーザーがアクティブにチャンネルから退出したときにトリガーされます。

• このコールバックは、リモートストリーマーが <a baseurl="t2309760_v6_0_0.xdita" data-node="4086566" data-root="16090" data-tag="xref" href="#84f350f904s98" id="4c0adbe948tif">setClientRole</a> を呼び出してロールを AliRTCSdkLive に設定し、視聴者ロールに切り替えたときにトリガーされます。

• リモートストリーマーが長期間データを送信せず、オフラインと見なされた場合、このコールバックがトリガーされます。

パラメーター

リモートユーザーがオンラインになったときにトリガーされます。

public void onRemoteUserOnLineNotify(String uid, int elapsed);

このインターフェイスは、リモートユーザーがチャンネルに参加したときにローカルクライアントに通知します。

トリガー条件

• リモートユーザーがチャンネルに正常に参加しました。

• 現在のユーザーがチャンネルに参加すると、すでにチャンネルにいるユーザーの参加コールバックを受信します。これらのコールバックを使用して、以前に参加したユーザーを表示できます。

パラメーター

リモートユーザーの音声または映像ストリームが変更されたときにトリガーされるコールバックです。

public void onRemoteTrackAvailableNotify(String uid, AliRtcAudioTrack audioTrack,
 AliRtcVideoTrack videoTrack);

このコールバックは、リモートユーザーのストリームアップストリーミングステータスが変更されたときにトリガーされます。これにより、開発者はリモートユーザーが音声または映像ストリームをパブリッシュしているかどうかをリアルタイムで判断し、それに応じてリモートユーザーの音声または映像情報を表示または非表示にすることができます。

トリガー条件

このコールバックは、次のシナリオでトリガーされます：