ミュート状態の共有および制御
ミュートとは、ローカルマイク装置から転送するオーディオを無効にすることをいいます。ローカルオーディオのミュート/ミュート解除を操作し、アプリケーションのミュート状態をピアと共有できます。また、特定のピアもしくはすべてのピアにミュート/ミュート解除をリクエストすることもできます。
ローカルオーディオのミュート制御および共有
ローカルオーディオをミュート/ミュート解除するには、muteMyAudio()
を使用します。
1対1通話
1対1通話では、ローカルオーディオのミュート状態の変更がonPeerMicMuted
またはonPeerMicUnmuted
を通じてピアに転送されます。
グループ通話
グループ通話では、ローカルオーディオのミュート状態の変更がonPeersMicMuted
またはonPeersMicUnmuted
を通じてピアに転送されます。
リモートオーディオのミュートのリクエスト
特定のピアまたはすべてのピアにオーディオをミュート/ミュート解除するようにリクエストできます。
- 1対1通話やグループ通話で特定のピアにミュート/ミュート解除するようにリクエストするには、
requestPeerMute()
を使用します。 - グループ通話ですべてのピアに対してミュート/ミュート解除するようにリクエストするには、
requestPeersMute()
を使用します。
ミュートリクエストはonMuteMyAudioRequestedByPeer
を通じてピアに通知されます。
Note
ピアがリクエストを受けた際にオーディオをミュート/ミュート解除するかどうかは、実装によって異なります。
次の例では、ピアがリクエストに応じてミュート/ミュート解除することを仮定しています。
1対1通話
1対1通話では、リモートオーディオのミュート状態の変更がonPeerMicMuted
またはonPeerMicUnmuted
を通じてローカルユーザーに転送されます。
グループ通話
グループ通話では、リモートオーディオのミュート状態の変更がonPeersMicMuted
またはonPeersMicUnmuted
を通じてローカルユーザーに転送されます。
関連API
ミュートの制御とミュート状態の共有に関連するAPIは次のとおりです。