PartyLocalChatControl::SetPermissions
ローカル チャット コントロールとターゲット チャット コントロールの間のチャットアクセス許可を設定します。
構文
PartyError SetPermissions(
const PartyChatControl* targetChatControl,
PartyChatPermissionOptions chatPermissionOptions
)
パラメーター
targetChatControl
PartyChatControl*
対象のチャットコントロール。
chatPermissionOptions
PartyChatPermissionOptions
チャットのアクセス許可オプション。
戻り値
PartyError
呼び出しが成功した場合は c_partyErrorSuccess、それ以外の場合はエラー コードになります。 人間が読める形式のエラー コードは、PartyManager::GetErrorMessage() を介して取得できます。
解説
チャットのアクセス許可を使用すると、任意のペアのチャット コントロール間で、音声通信の着信と発信、またテキスト通信の着信を制御できます。 チャットのアクセス許可は、ターゲット シナリオを反映するように構成する必要があります。 たとえば、ターゲット チャット コントロールが同じチームのメンバーである場合は、両方向の音声を許可できます。 ターゲット チャット コントロールが相手チームのメンバーである場合、どちらの方向でもオーディオを許可しないことができます。 チームに関係なく、テキストの受信を許可してもかまいません。
ターゲット チャット コントロールはリモートである必要があります。 既定のアクセス許可は PartyChatPermissionOptions::None です。
この設定はローカルのみです。 ローカル チャット コントロールがリモート チャット コントロールにオーディオを送信するように構成されている場合、リモート チャット コントロールがライブラリのインスタンスのローカル チャット コントロールからオーディオを受信するように構成されていない限り、リモート チャット コントロールにオーディオは送信されません。 同様に、ローカル チャット コントロールがリモート チャット コントロールからオーディオを受信するように構成されている場合、リモート チャット コントロールもライブラリのインスタンス内のローカル チャット コントロールにオーディオを送信するように構成されていない限り、リモート チャット コントロールからオーディオは受信されません。 そのため、両方のチャット コントロールは、通信が許可されていることに同意する必要があります。あるチャット コントロールでは、不要なチャットの受け入れまたは送信を別のチャット コントロールに強制することはできません。
sendText() への各呼び出しには、ターゲット チャット コントロールの明示的なリストが必要であるため、チャット テキストの送信に関連付けられたアクセス許可はありません。 ターゲットを含めたり省略したりすることは、そのテキスト メッセージに対する送信アクセス許可を付与または拒否することと同じです。 ターゲットが実際に配信されるようにするには、ターゲット PartyChatPermissionOptions::ReceiveText をライブラリのインスタンスに設定しておく必要があります。
パーティー ライブラリでは、チャットを「フレンドのみ」に制限するプラットフォーム設定など、ユーザーの ID に関連付けられたプラットフォーム制限は適用されません。 プラットフォームの制限は、2 つのチャット コントロール間でチャットのアクセス許可を構成するときに考慮する必要があります。
要件
ヘッダー: Party.h