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

# game_chat_audio_format

> game_chat_audio_format

# game\_chat\_audio\_format

Game Chat 2 오디오 데이터를 해석하는 데 필요한 형식 정보를 설명합니다.

## 구문

```cpp theme={null}
typedef struct game_chat_audio_format {  
    uint32_t sample_rate;  
    uint32_t channel_mask;  
    uint16_t channel_count;  
    uint16_t bits_per_sample;  
    game_chat_sample_type sample_type;  
    bool is_interleaved;  
} game_chat_audio_format  
```

### 멤버

*sample\_rate*  \
형식: uint32\_t

각 채널이 재생되거나 녹음되어야 하는 샘플 주파수입니다.

*channel\_mask*  \
형식: uint32\_t

다중 채널 오디오 스트림의 채널을 스피커 위치에 할당하는 것을 재정의하기 위한 채널 마스크입니다. 이 값의 비트-스피커 매핑에 대해서는 [Microsoft Docs](https://docs.xbox.com/ko.md)의 [WAVEFORMATEXTENSIBLE](https://learn.microsoft.com/windows-hardware/drivers/ddi/ksmedia/ns-ksmedia-waveformatextensible) 구조체에 대한 *dwChannelMask* 멤버 설명을 참조하세요. 기본 매핑을 사용하려면 이를 0으로 설정하세요.

*channel\_count*  \
형식: uint16\_t

오디오 데이터의 채널 수입니다.

*bits\_per\_sample*  \
형식: uint16\_t

샘플당 비트 수입니다. 이 값이 바이트로 나누어지지 않는 경우, 포함하는 샘플 유형이 바이트로 나누어지도록 비트로 채워져 있다고 가정합니다.

*sample\_type*  \
형식: [game\_chat\_sample\_type](https://docs.xbox.com/ko/reference/chat/gamechat2/enums/game_chat_sample_type.md)

Game Chat 2가 정수([game\_chat\_sample\_type::integer](https://docs.xbox.com/ko/reference/chat/gamechat2/enums/game_chat_sample_type.md))로 표현된 PCM(Pulse Code Manipulation) 데이터를 사용하는지 아니면 부동 소수점 숫자([game\_chat\_sample\_type::ieee\_float](https://docs.xbox.com/ko/reference/chat/gamechat2/enums/game_chat_sample_type.md))로 표현된 것을 사용하는지 지정합니다.

*is\_interleaved*  \
형식: bool

다중 채널 오디오 스트림이 다중 채널 형식에 대해 인터리브되는지를 나타내는 플래그입니다.

Game Chat 2에서 검색된 오디오는 항상 인터리브된 것으로 표시됩니다. 이 매개 변수는 [game\_chat\_audio\_format::channel\_count](https://docs.xbox.com/ko/reference/chat/gamechat2/structs/game_chat_audio_format.md)가 1보다 큰 경우에만 의미가 있습니다.

## 설명

이 구조체는 Game Chat 2의 사전 인코딩 오디오 스트림, 사후 디코딩 오디오 소스 스트림 및 사후 디코딩 오디오 싱크 스트림에 대한 오디오 데이터의 형식을 설명하는 데 사용됩니다. 다음 함수들은 해당 스트림 개체에서 사용하는 `game_chat_audio_format`을 가져오거나 설정합니다.

* [pre\_encode\_audio\_stream::get\_pre\_processed\_format](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/pre_encode_audio_stream/methods/pre_encode_audio_stream_get_pre_processed_format.md)
* [pre\_encode\_audio\_stream::set\_processed\_format](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/pre_encode_audio_stream/methods/pre_encode_audio_stream_set_processed_format.md)
* [post\_decode\_audio\_source\_stream::get\_pre\_processed\_format](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/post_decode_audio_source_stream/methods/post_decode_audio_source_stream_get_pre_processed_format.md)
* [post\_decode\_audio\_sink\_stream::set\_processed\_format](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/post_decode_audio_sink_stream/methods/post_decode_audio_sink_stream_set_processed_format.md)

오디오 형식에 대한 자세한 내용은 [실시간 오디오 조작](https://docs.xbox.com/ko/services/xbox-services/multiplayer/chat/game-chat2/real-time-audio-manipulation.md)을 참조하세요.

## 요구 사항

**헤더:** GameChat2.h

**지원 플랫폼:** Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

## 함께 보기

[Game Chat 2 소개](https://docs.xbox.com/ko/services/xbox-services/multiplayer/chat/game-chat2/game-chat-2-intro.md)\
[chat\_manager](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/chat_manager/chat_manager.md)\
[pre\_encode\_audio\_stream](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/pre_encode_audio_stream/pre_encode_audio_stream.md)\
[post\_decode\_audio\_sink\_stream](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/post_decode_audio_sink_stream/post_decode_audio_sink_stream.md)\
[post\_decode\_audio\_source\_stream](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/post_decode_audio_source_stream/post_decode_audio_source_stream.md)\
[GameChat2 멤버](https://docs.xbox.com/ko/reference/chat/gamechat2/gamechat2_members.md)


## Related topics

- [pre_encode_audio_stream::get_pre_processed_format](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/pre_encode_audio_stream/methods/pre_encode_audio_stream_get_pre_processed_format.md)
- [post_decode_audio_source_stream::get_pre_processed_format](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/post_decode_audio_source_stream/methods/post_decode_audio_source_stream_get_pre_processed_format.md)
- [post_decode_audio_sink_stream::set_processed_format](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/post_decode_audio_sink_stream/methods/post_decode_audio_sink_stream_set_processed_format.md)
- [game_chat_sample_type](https://docs.xbox.com/ko/reference/chat/gamechat2/enums/game_chat_sample_type.md)
- [pre_encode_audio_stream::set_processed_format](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/pre_encode_audio_stream/methods/pre_encode_audio_stream_set_processed_format.md)