PartyLocalChatControl::SendText
지정된 각 대상 채팅 컨트롤에 채팅 문자열을 전송합니다.
구문
PartyError SendText(
uint32_t targetChatControlCount,
PartyChatControlArray targetChatControls,
PartyString chatText,
uint32_t dataBufferCount,
const PartyDataBuffer* dataBuffers
)
매개 변수
targetChatControlCount uint32_t
targetChatControls 배열의 대상 채팅 컨트롤 수입니다.
targetChatControlsPartyChatControlArray
크기의 입력 배열targetChatControlCount
대상 PartyChatControls의 targetChatControlCount 항목 배열입니다.
chatTextPartyString
보낼 문자입니다.
dataBufferCount uint32_t
dataBuffers 배열에 제공된 버퍼 구조의 수입니다.
dataBuffersPartyDataBuffer*
크기가 dataBufferCount인 입력 배열
보낼 보조 메시지 페이로드를 설명하는 PartyDataBuffer 구조의 dataBufferCount 항목 배열입니다. dataBufferCount가 0이면 무시됩니다.
반환 값
PartyError
호출이 성공한 경우 c_partyErrorSuccess이고 그렇지 않은 경우 오류 코드입니다. 사용자가 읽을 수 있는 형식의 오류 코드는 PartyManager::GetErrorMessage()를 통해 검색할 수 있습니다.
비고
로컬 채팅 컨트롤에 채팅 문자 보내기는 현재 지원되지 않습니다. 대상 채팅 컨트롤 배열에 로컬 대상이 포함된 경우 이 호출은 동기화된 방식으로 실패합니다.
텍스트 콘텐츠의 번역, 지역화 또는 부적절한 표현 필터링이 보장되지 않습니다. 채팅 문자열은 있는 그대로의 문자로 표시됩니다.
문자열은 PartyLocalChatControl::SetPermissions()통해 로컬 채팅 컨트롤에서 문자 메시지를 받도록 자체 인스턴스를 구성한 대상 채팅 컨트롤에만 전달됩니다.
대상 채팅 컨트롤이 소스 채팅 컨트롤과 공통된 하나 이상의 네트워크에 연결되지 않은 경우 문자열이 전달되지 않습니다. 이는 로컬 채팅 컨트롤이 두 개인 경우에 가능합니다. 로컬 채팅 컨트롤 중 하나에 연결된 대상 채팅 컨트롤은 다른 모든 로컬 채팅 컨트롤에 연결될 수 없습니다.
dataBuffers 배열의 PartyDataBuffer 구조는 채팅 문자와 함께 렌더링할 아이콘에 대한 이미지 데이터가 포함된 이진 Blob 또는 문자를 렌더링하는 데 사용할 색을 나타내는 메타데이터와 같은 채팅 문자와 연결된 보조 데이터를 위한 것입니다. 문자 채팅과 관련 없는 게임 데이터를 보내려면 메시지 전송 동작에 대한 세부 컨트롤을 노출하는 메시징 옵션인 PartyLocalEndpoint::SendMessage()를 참조하세요.
호출자는 dataBuffers 배열에 0개 이상의 PartyDataBuffer 구조를 제공합니다. 구조가 참조하는 메모리는 연속적일 필요가 없으므로 고정 헤더 버퍼와 변수 페이로드를 쉽게 사용할 수 있습니다. 버퍼는 PartyChatTextReceivedStateChange에서 채팅 문자와 별도로 단일 연속 데이터 블록으로 순서대로 어셈블리되고, 전송되고, 대상 채팅 컨트롤에 제공됩니다. 파티 라이브러리는 원래 PartyDataBuffer 세분화를 설명하기 위해 메타데이터를 전송하는 대역폭을 사용하지 않습니다.
요구 사항
헤더: Party.h