本文にスキップする
Version: 1.0

ミュート状態の共有および制御

ミュートとは、ローカルマイク装置から転送するオーディオを無効にすることをいいます。ローカルオーディオのミュート/ミュート解除を操作し、アプリケーションのミュート状態をピアと共有できます。また、特定のピアもしくはすべてのピアにミュート/ミュート解除をリクエストすることもできます。

ローカルオーディオのミュート制御および共有

ローカルオーディオをミュート/ミュート解除するには、muteMyAudio()を使用します。

1対1通話

1対1通話では、ローカルオーディオのミュート状態の変更がonPeerMicMutedまたはonPeerMicUnmutedを通じてピアに転送されます。

1対1通話のローカルオーディオのミュートシーケンス図

グループ通話

グループ通話では、ローカルオーディオのミュート状態の変更がonPeersMicMutedまたはonPeersMicUnmutedを通じてピアに転送されます。

グループ通話のローカルオーディオのミュートシーケンス図

リモートオーディオのミュートのリクエスト

特定のピアまたはすべてのピアにオーディオをミュート/ミュート解除するようにリクエストできます。

  • 1対1通話やグループ通話で特定のピアにミュート/ミュート解除するようにリクエストするには、requestPeerMute()を使用します。
  • グループ通話ですべてのピアに対してミュート/ミュート解除するようにリクエストするには、requestPeersMute()を使用します。

ミュートリクエストはonMuteMyAudioRequestedByPeerを通じてピアに通知されます。

Note

ピアがリクエストを受けた際にオーディオをミュート/ミュート解除するかどうかは、実装によって異なります。

次の例では、ピアがリクエストに応じてミュート/ミュート解除することを仮定しています。

1対1通話

1対1通話では、リモートオーディオのミュート状態の変更がonPeerMicMutedまたはonPeerMicUnmutedを通じてローカルユーザーに転送されます。

1対1通話のリモートオーディオのミュートシーケンス図

グループ通話

グループ通話では、リモートオーディオのミュート状態の変更がonPeersMicMutedまたはonPeersMicUnmutedを通じてローカルユーザーに転送されます。

グループ通話のリモートオーディオのミュートシーケンス図

関連API

ミュートの制御とミュート状態の共有に関連するAPIは次のとおりです。

1対1通話

メソッド

イベント

グループ通話

メソッド

イベント