> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PartyLocalChatControl::SendText

> 지정된 각 대상 채팅 컨트롤에 채팅 텍스트 문자열을 전송합니다.

지정된 각 대상 채팅 컨트롤에 채팅 텍스트 문자열을 전송합니다.

## Syntax

```cpp theme={null}
PartyError SendText(  
    uint32_t targetChatControlCount,  
    PartyChatControlArray targetChatControls,  
    PartyString chatText,  
    uint32_t dataBufferCount,  
    const PartyDataBuffer* dataBuffers  
)  
```

### Parameters

**`targetChatControlCount`**   uint32\_t

`targetChatControls` 배열의 대상 채팅 컨트롤 수입니다.

**`targetChatControls`**   [PartyChatControlArray](/services/playfab/multiplayer/networking/reference/typedefs)\
*크기가 `targetChatControlCount`인 입력 배열*

대상 PartyChatControl로 구성된 `targetChatControlCount` 항목 배열입니다.

**`chatText`**   [PartyString](/services/playfab/multiplayer/networking/reference/typedefs)

보낼 텍스트입니다.

**`dataBufferCount`**   uint32\_t

`dataBuffers` 배열에 제공된 버퍼 구조체의 수입니다.

**`dataBuffers`**   [PartyDataBuffer\*](/services/playfab/multiplayer/networking/reference/structs/partydatabuffer)\
*크기가 `dataBufferCount`인 입력 배열*

보낼 보조 메시지 페이로드를 설명하는 PartyDataBuffer 구조체의 `dataBufferCount` 항목 배열입니다. 이 값은 `dataBufferCount`가 0인 경우 무시됩니다.

### Return value

PartyError

호출이 성공한 경우 `c_partyErrorSuccess`, 그렇지 않으면 오류 코드입니다. 오류 코드의 사람이 읽을 수 있는 형식은 [PartyManager::GetErrorMessage()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage)를 통해 검색할 수 있습니다.

## Remarks

로컬 채팅 컨트롤에 채팅 텍스트를 보내는 것은 현재 지원되지 않습니다. 대상 채팅 컨트롤 배열에 로컬 대상이 포함되어 있으면 이 호출은 동기적으로 실패합니다. <br /><br /> 텍스트 콘텐츠의 번역, 지역화 또는 불쾌한 언어 필터링은 보장되지 않으며, 채팅 텍스트 문자열은 텍스트 그대로 표시됩니다.   <br /><br /> 텍스트 문자열은 [PartyLocalChatControl::SetPermissions()](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_setpermissions)를 통해 로컬 채팅 컨트롤로부터 텍스트 메시지를 수신하도록 자체 인스턴스를 구성한 대상 채팅 컨트롤에만 전달됩니다.   <br /><br /> 대상 채팅 컨트롤이 소스 채팅 컨트롤과 공통된 네트워크에 하나 이상 연결되어 있지 않으면 텍스트 문자열은 전달되지 않습니다. 이는 두 개의 로컬 채팅 컨트롤이 있는 경우에 가능합니다. 로컬 채팅 컨트롤 중 하나에 연결된 대상 채팅 컨트롤이 다른 모든 로컬 채팅 컨트롤에는 연결되지 않을 수 있습니다.   <br /><br /> `dataBuffers` 배열의 PartyDataBuffer 구조체는 채팅 텍스트와 연결된 보조 데이터를 위한 것입니다. 예를 들어 텍스트 렌더링에 사용해야 하는 색상을 나타내는 메타데이터 또는 채팅 텍스트와 함께 렌더링할 아이콘의 이미지 데이터를 포함하는 이진 blob 등입니다. 텍스트 채팅과 관련이 없는 게임 데이터를 보내려면 메시지 전송 동작을 더 세밀하게 제어할 수 있는 메시징 옵션인 [PartyLocalEndpoint::SendMessage()](/services/playfab/multiplayer/networking/reference/classes/PartyLocalEndpoint/methods/partylocalendpoint_sendmessage)를 참조하세요.   <br /><br /> 호출자는 `dataBuffers` 배열에 0개 이상의 PartyDataBuffer 구조체를 제공합니다. 구조체가 참조하는 메모리는 연속적일 필요가 없으므로, 예를 들어 고정 헤더 버퍼 뒤에 가변 페이로드가 오도록 하기가 쉽습니다. 버퍼는 순서대로 조립되어 전송되며, [PartyChatTextReceivedStateChange](/services/playfab/multiplayer/networking/reference/structs/partychattextreceivedstatechange)에서 채팅 텍스트와 별도로 하나의 연속된 데이터 블록으로 대상 채팅 컨트롤에 전달됩니다. Party 라이브러리는 원래 PartyDataBuffer 분할을 설명하는 메타데이터를 전송하는 데 대역폭을 사용하지 않습니다.

## Requirements

**Header:** Party.h

## See also

[PartyLocalChatControl](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/partylocalchatcontrol)\
[PartyChatTextReceivedStateChange](/services/playfab/multiplayer/networking/reference/structs/partychattextreceivedstatechange)


## Related topics

- [PartyChatTextReceivedStateChange](/ko/services/playfab/multiplayer/networking/reference/structs/partychattextreceivedstatechange.md)
- [Understanding How PlayFab Party chat works](/ko/services/playfab/community/voice-communications/concepts-chat.md)
- [PartyLocalChatControl](/ko/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/partylocalchatcontrol.md)
- [PartyLocalChatControl::SetPermissions](/ko/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_setpermissions.md)
- [PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles](/ko/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_populateavailabletexttospeechprofiles.md)