다음을 통해 공유


PartyLocalDevice::CreateChatControl

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

구문

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

매개 변수

localUserPartyLocalUser*

새 로컬 채팅 컨트롤의 로컬 사용자입니다.

languageCodePartyString
선택 사항

사용할 선택적 언어입니다.

asyncIdentifier void*
선택 사항

완료 상태 변경을 이 호출과 연결하는 데 사용할 수 있는 선택적 앱 정의 포인터 크기의 컨텍스트 값입니다.

localChatControlPartyLocalChatControl**
선택적 라이브러리 할당 출력

선택적 출력 로컬 채팅 컨트롤입니다.

반환 값

PartyError

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

비고

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

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

이 채팅 컨트롤과 연결된 언어는 필요에 따라 languageCode 매개 변수를 통해 지정할 수 있습니다. 언어를 지정하지 않으면 플랫폼에 의해 결정되는 사용자의 기본값이 사용됩니다. 이 언어는 전사를 위해 이 채팅 컨트롤과 연결된 음성 언어 및 들어오는 번역의 대상 언어로 사용됩니다. 예를 들어 지정된 언어 코드가 en-US인 경우 이 채팅 컨트롤에 대한 입력 오디오는 영어(미국) 언어로 처리 및 기록됩니다. PartyLocalChatControl::SetTranscriptionOptions() 또는 PartyLocalChatControl::SetTextChatOptions()을 통해 번역을 사용하도록 설정한 경우 들어오는 음성 채팅 기록 및/또는 문자 채팅은 영어(미국)로 번역됩니다.

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

요구 사항

헤더: Party.h

참고 항목

PartyLocalDevice
PartyCreateChatControlCompletedStateChange
PartyChatControlCreatedStateChange
PartyChatControlDestroyedStateChange
PartyManager::GetChatControls
PartyDevice::GetChatControls
PartyNetwork::ConnectChatControl
PartyLocalChatControl::GetLanguage
PartyLocalChatControl::SetTranscriptionOptions
PartyLocalChatControl::SetTranscriptionOptions