> For the complete documentation index, see [llms.txt](https://docs.ggwp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ggwp.com/kr/api-1.md).

# API 문서: 음성

## **소개**

GGWP 음성 모더레이션은 GGWP의 모더레이션 플랫폼을 음성 기반 플레이어 상호작용까지 확장합니다.\
이 서비스는 간단한 API 엔드포인트를 통해 오디오 클립을 수집하고, 게임에 맞게 조정된 음성-텍스트 변환 파이프라인을 거쳐 처리한 뒤, 생성된 전사본을 GGWP의 모더레이션 모델과 정책 엔진으로 평가합니다.

음성 모더레이션 결과는 텍스트 채팅, 신고, Discord, 사용자 평판, 대시보드, 웹훅, 자동 모더레이션, 플레이어 알림에 사용되는 동일한 GGWP 플랫폼으로 전달됩니다. 이를 통해 팀은 상호작용 채널 전반에 걸친 플레이어 행동을 일관되게 파악할 수 있습니다.\
\
GGWP 음성 모더레이션은 다음을 지원합니다:<br>

* Voice, Text Chat, Reports, Discord 전반의 통합 사용자 평판
* GGWP가 지원하는 사건 분류 체계 전반에 걸친 감지
* 대시보드 검토, 웹훅 이벤트, 사용자 관리 워크플로
* 자동 모더레이션 및 플레이어 알림
* GGWP의 더 넓은 데이터 서비스와 연계된 안전하고, 규정을 준수하며, 개인정보를 고려한 처리

GGWP는 효율적인 라우팅과 우선순위 지정을 지원하기 위해 음성 활동 감지, 분류, 키워드 또는 구문 탐지, 신호 추출과 같은 가벼운 오디오 측면 처리도 적용합니다. 핵심 모더레이션 결정은 GGWP 플랫폼 내의 전사본 분석, 정책 설정, 사용 가능한 사용자 컨텍스트를 기반으로 합니다.

## **언어 지원**

GGWP의 음성 모더레이션 서비스는 다음 언어를 지원합니다:&#x20;

* 중국어(간체 및 번체)
* 영어
* 프랑스어
* 독일어
* 인도네시아어
* 이탈리아어
* 일본어
* 한국어
* 포르투갈어
* 러시아어
* 스페인어
* 터키어

새로운 언어는 정기적으로 추가됩니다. 예정된 언어에 대해 알아보거나 추가 언어를 검토 대상으로 제출하려면 계정 관리자에게 문의해 주세요.

## **모델 지원**

GGWP의 음성 모더레이션이 다루는 범주는 [모델 용어집 섹션에](/kr/text-and-voice-model-glossary.md).

## 통합 워크플로

당사 서비스는 단 하나의 Voice Ingestion API 호출만 필요하므로, 게임의 음성 인프라와 관계없이 빠르게 통합할 수 있는 여러 방법이 있습니다. 예시 경로는 다음과 같습니다:

1. 사용자 오디오 파일 또는 스트림에 접근할 수 있는 위치를 식별합니다.
   1. 오디오가 이미 어딘가에 저장되어 있다면(예: AWS S3, 내부 데이터 웨어하우스, 타사 서비스), 추가 엔지니어링은 필요하지 않습니다.
   2. 오디오가 저장되고 있지 않다면, Vivox, EOS, Photon, ODIN과 같은 음성 서비스가 각 음성 세션을 위해 생성하는 "오디오 룸"에서 오디오 스트림으로 직접 접근할 수 있을 가능성이 높습니다. 서비스 SDK를 사용하면 이러한 오디오 스트림을 청크로 나누어 당사 수집 API에 직접 전달하거나 오프라인 처리를 위해 저장할 수 있습니다. 예시:
      1. EOS는 [여기에서](https://dev.epicgames.com/docs/game-services/real-time-communication-interface/voice/using-voice#speech-to-text) 오디오 스트림을 제3자 전사 서비스로 보낼 수 있는 방법을 설명하며, 이는 GGWP 음성 수집 방식과 동일합니다.
      2. Vivox는 [여기에서](https://support.unity.com/hc/en-us/articles/4418149054356-Vivox-How-to-Access-client-side-audio-buffers) 콜백을 사용하여 저장하거나 API 서비스로 전송하는 등 클라이언트/서버 상호작용의 다양한 단계에서 오디오 스트림을 처리하는 방법을 설명합니다.
      3. Photon은 [여기에서](https://doc.photonengine.com/voice/current/troubleshooting/faq#how_to_save_conversations_into_files_) 오디오 스트림을 유사한 방식으로 파일에 저장하는 방법을 설명합니다.
2. 사용자 오디오를 Voice Ingestion API의 요구 사항을 충족하는 파일 청크로 처리합니다.
   1. 간단한 코딩이 필요하며, 이에 대해 GGWP가 코드 조각과 구현 지원을 제공할 수 있습니다.
3. 가장 편리한 위치(클라이언트 또는 서버 측)에서 수집 API를 통해 오디오 파일을 제출합니다.
4. 이후 곧 GGWP 대시보드 또는 웹훅 이벤트를 통해 사용자 프로필과 사건을 확인할 수 있습니다.