game_chat_communication_relationship_adjuster

chat_user_local::set_communication_relationship の呼び出しによって以前に設定されたコミュニケーションリレーションシップに対して、Game Chat 2 が適用する追加の調整ステップを定義します。

構文

enum class game_chat_communication_relationship_adjuster  
{  
    uninitialized,  
    initializing,  
    none,  
    privilege,  
    privacy,  
    reputation,  
    conflict_with_other_user,  
    privilege_check_failure,  
    resolve_user_issue,
    service_unavailable,
}  

定数

定数	説明
uninitialized	ユーザーのペアに対してアプリからリレーションシップが設定されていません。 Game Chat 2 は、少なくとも一方向のコミュニケーションを許可するリレーションシップが設定されるまで、ユーザーのペアの調整機能を初期化できません。
initializing	Game Chat 2 は、対象ユーザーの一方について、特権、プライバシー、または評価に関する情報を初期化しています。調整機能がこの状態にある間、実効コミュニケーションは `none` に設定されます。
none	Game Chat 2 は、このリレーションシップに追加の調整を適用していません。実効リレーションシップは、最後に呼び出された chat_user_local::set_communication_relationship で指定されたものに設定されます。
privilege	Game Chat 2 は、ローカルユーザーのコミュニケーション特権によりコミュニケーションを制限しています。この問題はローカルユーザーが UI で解決できる可能性があります。この調整機能が適用されている間、リレーションシップから game_chat_communication_relationship_flags::send_microphone_audio、game_chat_communication_relationship_flags::send_text_to_speech_audio、および game_chat_communication_relationship_flags::send_text のリレーションシップフラグが false に設定されます。アプリは、XUserResolvePrivilegeWithUiAsync メソッドを呼び出し、`options` パラメーターに XUserPrivilegeOptions::None 定数、`privilege` パラメーターに XUserPrivilege::Communications 定数を指定して、問題の解決を試みることができます。ユーザーが問題を解決できない、または解決したくない場合もあります。ユーザーが問題を解決した場合、その解決は次にユーザーが Game Chat 2 に追加されたときに有効になります。
privacy	Game Chat 2 は、リモートユーザーに対するローカルユーザーのプライバシー設定によりコミュニケーションを制限しています。この調整機能が適用されている間、リレーションシップから game_chat_communication_relationship_flags::receive_audio および game_chat_communication_relationship_flags::receive_text のリレーションシップフラグが false に設定されます。さらに、game_chat_communication_relationship_flags::send_microphone_audio、game_chat_communication_relationship_flags::send_text_to_speech_audio、および game_chat_communication_relationship_flags::send_text のリレーションシップフラグも、プライバシー制限の性質に基づいて false に設定される場合があります。
reputation	XBOX Live サービスによってユーザーに「Avoid Me」の評価が指定されているため、Game Chat 2 はコミュニケーションを制限しています。この調整機能が適用されている間、リレーションシップから game_chat_communication_relationship_flags::receive_audio および game_chat_communication_relationship_flags::receive_text のリレーションシップフラグが false に設定されます。
conflict_with_other_user	ユーザーが Kinect などの共有デバイスを使用しており、他のユーザーのリレーションシップ設定によりリレーションシップが変更されました。競合は、chat_manager::initialize メソッドで指定された設定に基づいて解決されます。
privilege_check_failure	Game Chat 2 は、ユーザーの特権の取得に失敗したためコミュニケーションを制限しています。この調整機能が適用されている間、リレーションシップから game_chat_communication_relationship_flags::send_microphone_audio、game_chat_communication_relationship_flags::send_text_to_speech_audio、および game_chat_communication_relationship_flags::send_text のリレーションシップフラグが false に設定されます。
resolve_user_issue	Game Chat 2 は、ユーザーの特権の取得に失敗したためコミュニケーションを制限しています。この問題はユーザーが UI で解決できる可能性があります。この調整機能が適用されている間、リレーションシップから game_chat_communication_relationship_flags::send_microphone_audio、game_chat_communication_relationship_flags::send_text_to_speech_audio、および game_chat_communication_relationship_flags::send_text のリレーションシップフラグが false に設定されます。アプリは、XUserResolveIssueWithUiAsync を呼び出し、`url` パラメーターに `nullptr` を指定して、問題の解決を試みることができます。ユーザーが問題を解決できない、または解決したくない場合もあります。ユーザーが問題を解決した場合、その解決は次にユーザーが Game Chat 2 に追加されたときに有効になります。
service_unavailable	XBOX Live が一時的に利用できず、ユーザーのコミュニケーション設定を取得できなかったため、Game Chat 2 はコミュニケーションを制限しています。

解説

この列挙は、chat_user_local::set_communication_relationship の呼び出しによって以前に設定されたコミュニケーションリレーションシップに対して、Game Chat 2 が適用する追加の調整ステップ (存在する場合) を表します。既存のリレーションシップに対して Game Chat 2 が適用したリレーションシップフラグとリレーションシップ調整機能 (存在する場合) を確認するには、chat_user_local::get_effective_communication_relationship を呼び出します。この列挙で説明されている調整機能は優先順位順に列挙されています。つまり、特定のリレーションシップが (ローカルユーザーの) 特権制限と (リモートユーザーの) プライバシー制限の両方の影響を受ける場合、chat_user_local::get_effective_communication_relationship を呼び出すと、communicationRelationshipAdjuster パラメーターに privilege が返されます。コミュニケーションリレーションシップの詳細については、「Game Chat 2 C++ API の使用」を参照してください。

要件

ヘッダー: GameChat2.h サポートされているプラットフォーム: Windows、XBOX One ファミリ本体および XBOX Series 本体

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

game_chat_communication_relationship_adjuster

game_chat_communication_relationship_adjuster

構文

定数

解説

要件

関連項目

​game_chat_communication_relationship_adjuster

​構文

​定数

​解説

​要件

​関連項目

game_chat_communication_relationship_adjuster

構文

定数

解説

要件

関連項目