PartyLocalDevice::CreateChatControl

지정된 사용자에 대해 로컬 채팅 컨트롤을 만드는 비동기 작업을 큐에 넣습니다.

Syntax

PartyError CreateChatControl(  
    const PartyLocalUser* localUser,  
    PartyString languageCode,  
    void* asyncIdentifier,  
    PartyLocalChatControl** localChatControl  
)  

Parameters

localUser PartyLocalUser* 새 로컬 채팅 컨트롤에 대한 로컬 사용자입니다. languageCode PartyString
선택 사항 사용할 선택적 언어입니다. asyncIdentifier void*
선택 사항 완료 상태 변경을 이 호출과 연결하는 데 사용할 수 있는 선택적, 앱 정의, 포인터 크기의 컨텍스트 값입니다. localChatControl PartyLocalChatControl**
선택 사항, 라이브러리에서 할당된 출력 선택적 출력 로컬 채팅 컨트롤입니다.

Return value

PartyError 채팅 컨트롤을 만들기 위한 비동기 작업이 시작된 경우 c_partyErrorSuccess, 그렇지 않으면 오류 코드입니다. 이 메서드가 실패하면 관련 상태 변경이 생성되지 않습니다. 오류 코드의 사람이 읽을 수 있는 형식은 PartyManager::GetErrorMessage()를 통해 검색할 수 있습니다.

Remarks

이 메서드가 성공을 반환하면 비동기 작업의 결과를 제공하기 위해 PartyCreateChatControlCompletedStateChange가 생성됩니다. 비동기 작업이 성공하면 PartyChatControlCreatedStateChange가 생성됩니다. 작업이 실패하면 PartyChatControlDestroyedStateChange가 생성됩니다. 이 메서드 자체는 채팅 컨트롤을 원격 디바이스에 표시하지 않습니다. 이 채팅 컨트롤을 원격 디바이스에 알리려면 타이틀이 PartyNetwork::ConnectChatControl()을 호출해야 합니다.

성공적으로 반환되면 이 메서드는 PartyManager::GetChatControls() 또는 로컬 디바이스에 대한 PartyDevice::GetChatControls()에서 이전에 반환된 배열의 메모리를 무효화합니다. 새 채팅 컨트롤을 배열에 동기적으로 추가하기 때문입니다. PartyManager::StartProcessingStateChanges()도 이러한 배열의 메모리를 무효화합니다. 반환된 localChatControl 객체는 PartyChatControlDestroyedStateChange가 생성되고 해당 객체를 참조하는 모든 상태 변경이 PartyManager::FinishProcessingStateChanges()에 반환될 때까지 유효합니다.

이 채팅 컨트롤과 연결된 언어는 선택적으로 languageCode 매개 변수를 통해 지정할 수 있습니다. 언어를 지정하지 않으면 플랫폼에 의해 결정된 사용자의 기본값이 사용됩니다. 언어는 전사에 대한 이 채팅 컨트롤과 연결된 사용 언어 및 들어오는 번역의 대상 언어로 사용됩니다. 예를 들어 지정된 언어 코드가 en-US인 경우, 이 채팅 컨트롤에 대한 입력 오디오는 영어(미국) 언어로 처리되고 그렇게 전사됩니다. PartyLocalChatControl::SetTranscriptionOptions() 또는 PartyLocalChatControl::SetTextChatOptions()를 통해 번역이 활성화되면 들어오는 음성 채팅 전사 및/또는 텍스트 채팅이 영어(미국)로 번역됩니다.

언어 코드는 BCP 47 형식이어야 합니다. 지원되는 언어 코드는 Language support에 열거되어 있습니다. 지원되지 않거나 잘못된 언어 코드를 지정해도 이 메서드는 실패하지 않지만, 이 채팅 컨트롤과 연결된 전사 생성에 실패하게 됩니다. 이 메서드에 사용된 언어 코드는 PartyLocalChatControl::GetLanguage()를 통해 쿼리할 수 있습니다.

Requirements

Header: Party.h

XBOX Services

PlayFab

Syntax

Parameters

Return value

Remarks

Requirements

See also

​Syntax

​Parameters

​Return value

​Remarks

​Requirements

​See also

Syntax

Parameters

Return value

Remarks

Requirements

See also