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