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로 설정됩니다. 앱은 `options` 매개 변수에 XUserPrivilegeOptions::None 상수를 지정하고 `privilege` 매개 변수에 XUserPrivilege::Communications 상수를 지정하여 XUserResolvePrivilegeWithUiAsync 메서드를 호출해 문제 해결을 시도할 수 있습니다. 사용자는 문제를 해결할 수 없거나 원하지 않을 수 있습니다. 사용자가 문제를 해결하면 다음 번에 사용자가 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로 설정됩니다. 앱은 `url` 매개 변수에 `nullptr`을 지정하여 XUserResolveIssueWithUiAsync를 호출해 문제 해결을 시도할 수 있습니다. 사용자는 문제를 해결할 수 없거나 원하지 않을 수 있습니다. 사용자가 문제를 해결하면 다음 번에 사용자가 Game Chat 2에 추가될 때 해결 사항이 적용됩니다.
service_unavailable	XBOX Live를 일시적으로 사용할 수 없어 사용자 통신 설정을 검색할 수 없으므로 Game Chat 2가 통신을 제한하고 있습니다.

설명

이 열거형은 chat_user_local::set_communication_relationship를 호출하여 이전에 설정된 통신 관계에 Game Chat 2가 적용하는 추가 조정 단계(있는 경우)를 설명합니다. chat_user_local::get_effective_communication_relationship를 호출하여 Game Chat 2가 기존 관계에 적용한 관계 플래그와 관계 조정자(있는 경우)를 찾을 수 있습니다. 이 열거형에 설명된 조정자는 우선 순위 순으로 나열됩니다. 즉, 특정 관계가 (로컬 사용자에 대한) 권한 제한과 (원격 사용자에 대한) 개인 정보 제한 모두의 영향을 받는 경우, 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

구문

상수

설명

요구 사항

관련 항목