tencent cloud

Game Multimedia Engine

릴리스 노트
제품 소개
제품 개요
장점 및 특징
제품 기능
응용 시나리오
보안 및 컴플라이언스 인증
사용자 튜토리얼
SDK 다운로드 가이드
제품 기능 데모
기본 기능 데모
시나리오 기반 Demo
콘솔 가이드
사용량 조회
서비스 활성화
시작하기
Quick Integration of SDK
Quick Integration of Sample Project
기본 기능 개발 가이드
인증 키
실시간 음성 채팅 역할 설정
음질 선택
고급 기능 개발 가이드
서버 녹음
레인지 보이스
3D 음향 효과
음향 효과 및 반주
네트워크 오디오 스트림 포워딩 라우팅
사용자 지정 메시지 채널
회사 방화벽 제한을 해결하는 방법
Language Parameter Reference List
GME 채팅방 관리 통합
클라이언트 API
Unity SDK
SDK for Unreal Engine
Cocos2D SDK
SDK for Windows
SDK for iOS
SDK for Android
SDK for macOS
H5 SDK
Electron SDK
SDK for Flutter
SDK Version Upgrade Guide
에러 코드
Toolchain
Server APIs
History
Introduction
API Category
Usage APIs
Recording APIs
Making API Requests
Voice Chat APIs
Application APIs
Data Types
Error Codes
FAQ
제품 기능
문제 해결 가이드
과금
Sample Project 사용 문제
일반 문제
인증
방 입장 실패
사운드 및 오디오
네트워크
음성을 텍스트로 변환
프로그램 내보내기
Service Agreement
Service Level Agreement
문의하기
용어집
GME 정책
데이터 처리 및 보안 계약
개인 정보 보호 정책
문서Game Multimedia Engine사용자 튜토리얼

사용자 튜토리얼

PDF
포커스 모드
폰트 크기
마지막 업데이트 시간: 2026-01-20 11:54:54
본 문서는 GME(Game Multimedia Engine)를 시작하는 데 도움이 됩니다.

1. 기본 GME 지식

2. GME 과금 방식

GME는 현재 음성 채팅 및 음성 메시지와 같은 여러 서비스를 제공합니다. 과금 세부 정보는 구매 가이드를 참고하십시오.

3. 무료 Demo

GME를 사용하기 전에 먼저 사용해 볼 수 있습니다.



기본 기능 Demo: 음성 채팅, 음성 메시지, 음성 텍스트 변환, 실시간 3D 음향 효과 및 실시간 기본 음성 변조 기능.
시나리오 기반 Demo: 간단한 게임 시나리오를 시뮬레이션하고 실시간 음성 채팅, 3D 음성, 레인지 보이스 및 음성 변조 기능을 체험합니다.

4. 서비스 활성화

GME를 사용하기 전에 먼저 Signing Up해야 합니다.
GME 콘솔에서 서비스를 활성화하고 필요에 따라 기능을 활성화합니다. 자세한 내용은 서비스 활성화를 참고하십시오.

5. 통합 매개변수 획득

5.1 클라이언트 통합 매개변수

GME 콘솔에서 방금 생성한 애플리케이션을 찾고 작업 열의 설정을 클릭하여 애플리케이션 설정 페이지로 이동합니다.
아래와 같이 페이지에서 해당 AppID 및 권한 키를 얻을 수 있습니다.
Sample Project 사용 시 AppID와 권한 키가 매개변수로 필요합니다.
SDK 사용 시 초기화 API Init에는 AppID를 매개변수로, 로컬 인증 생성 API QAVAuthBuffer.GenAuthBuffer에는 권한 키를 매개변수로 필요로 합니다.

5.2 TencentCloud API 통합 매개변수

TencentCloud API를 사용하는 경우 SecretId와 SecretKey가 필요하며 이는 API 키 관리 페이지에서 얻을 수 있습니다. Security Best Practice의 지침에 따라 계정 액세스를 관리하는 것이 좋습니다.

6. Sample Project 실행

GME는 다양한 플랫폼을 위한 SDK와 Sample Project를 제공합니다. SampleProject를 실행하여 GME SDK를 통합하는 방법을 더 잘 이해할 수 있습니다.

6.1 Sample Project 다운로드

SDK 다운로드 가이드의 안내에 따라 대상 플랫폼에 대한 Sample Project를 다운로드할 수 있습니다.

6.2 Sample Project 실행

사용하는 플랫폼에 해당하는 문서 보기: Quick Unreal Engine Demo Run

7. 기본 기능 통합

7.1 SDK 다운로드

SDK 다운로드 가이드의 안내에 따라 대상 플랫폼에 필요한 SDK 파일을 다운로드할 수 있습니다.


7.2 프로젝트 구성

프로젝트 구성은 플랫폼별 문서를 참고하십시오. 구성이 완료된 후에야 API를 호출하여 GME 서비스를 사용할 수 있습니다.

7.3 SDK를 빠르게 통합

빠른 통합 문서는 기능을 빠르게 시험해 볼 수 있도록 통합 프로세스를 단순화합니다. 이러한 문서에 설명된 기능에는 음성 채팅 및 음성을 텍스트로 스트리밍하는 기능이 포함됩니다.
플랫폼
빠른 통합 문서
Unity
Unreal Engine
Windows, iOS, Mac, Android

7.4 기본 기능 통합

사용하는 플랫폼에 해당하는 문서를 찾으려면 여기를 클릭하십시오.

7.5 통합 도움말 문서

사용할 수 있는 문서:
문서
사용 시기
실시간 음성 채팅방 유형 선택이 어렵다면 이 문서를 참고하십시오.
애플리케이션의 GME 서비스와 관련된 인증 배포의 보안성을 높이려면 이 문서를 참고하십시오.
이전 GME 버전에서 새 버전으로 업그레이드하는 경우 이 문서를 통해 API 변경 사항을 이해해야 합니다.
SDK 통합 디버깅 프로세스 중에 API 또는 콜백이 오류 코드를 반환하는 경우 이 문서를 참고하여 해결하시기 바랍니다.

8. 고급 기능 통합

다음을 원하시는 경우
다음을 참고하시기 바랍니다
음성 채팅에서 레인지 보이스 효과를 구현합니다(PUBG의 전체/팀 전용 오디오 모드와 유사).
캐릭터가 움직일 때 캐릭터의 방향감이 있는 스테레오 음성을 들을 수 있습니다. 음원과의 거리가 멀어질수록 음성도 약해져서 게임 음성의 몰입도가 높아집니다.
방 구성원 관리, 마이크 켜기/끄기 및 음소거를 구현합니다. 예를 들어 팀 리더는 방에 있는 다른 유저를 음소거하거나 게임 호스트는 청중이 마이크를 켜기를 원합니다.
음성 채팅방에서 GME를 이용하여 반주를 틀고, 반주의 EQ를 조절하고, 로컬 음향 효과를 재생합니다.
음성 채팅 중 음성 변조를 수행합니다. 유저는 ‘중년 남성’, ‘어린 소녀’ 등의 톤으로 변조할 수 있습니다.
음성 채팅 방에서 현재 팀의 구성원에게만 자신의 목소리를 들려주고 일치하는 팀의 다른 낯선 유저의 목소리를 들을 수 있습니다.

9. 콘솔 운영 가이드

음성 채팅, 음성 메시지 및 기타 서비스의 사용 데이터는 사용량 조회를 참고하십시오.

10. FAQ

기능 관련 질문:
개발:

11. 통합

통합 중에 문제가 발생하면 다음과 같이 문제를 해결하십시오.

11.1 문제 확인

먼저 문제 유형을 파악한 후 해당 문서를 확인합니다: 인증, Demo, 네트워크 또는 프로그램 내보내기.
사용된 서비스에 따라 확인해야 하는 문제 문서를 결정할 수도 있습니다.
사용된 서비스
문서
음성 채팅 서비스
음성 메시지 서비스
음성-텍스트 변환 서비스

11.2 에러 코드

통화 오류가 발생하면 에러 코드를 기준으로 원인과 솔루션을 확인할 수 있습니다.
예를 들어 SDK를 사용할 때 3D 음향 효과 API가 에러 7003을 반환하면 에러 코드 문서를 확인하여 InitSpatializer가 호출되지 않은 것이 원인임을 알 수 있습니다. 그 다음 올바른 순서로 코드에서 InitSpatializer가 호출되는지 확인합니다.

11.3 도움 요청

문서 및 에러 코드를 통해 문제를 해결할 수 없는 경우 문제 해결 가이드의 지침에 따라 지원을 요청하십시오.

12. 피드백 및 제안

Tencent Cloud GME 제품 및 서비스를 사용하면서 의문점이나 제안 사항이 있는 경우 다음 채널을 통해 피드백을 제출할 수 있습니다. 전담 직원이 귀하의 문제를 해결하기 위해 연락을 드릴 것입니다.
링크, 콘텐츠 또는 API와 같은 제품 설명서에 대한 질문은 문서 페이지 오른쪽에 있는 피드백 보내기를 클릭하십시오.
제품 사용 중 문제가 발생하면 온라인 고객 서비스에 도움을 요청하십시오.

도움말 및 지원

문제 해결에 도움이 되었나요?

피드백