tencent cloud

음성 변조
PDF 다운로드
마지막 업데이트 시간:2024-01-18 16:00:04
음성 변조
마지막 업데이트 시간: 2024-01-18 16:00:04
PDF 다운로드
이 문서는 음성 변조 효과를 위해 GME(Game Multimedia Engine) API와 통합하고 디버깅하는 방법을 설명합니다.

시나리오





전제 조건

음성 채팅 서비스 활성화: 서비스 활성화를 참고하십시오.
음성-텍스트 변환 서비스 활성화: 서비스 활성화를 참고하십시오.
GME SDK 통합: 핵심 API 및 음성 채팅 API를 포함합니다. 자세한 내용은 Quick Integration of Native SDK, Quick Integration of SDK for Unity, Quick Integration of SDK for Unreal Engine을 참고하십시오.
GME SDK의 libgmesoundtouch 라이브러리 파일 통합: 프로젝트의 라이브러리 파일에 libgmesoundtouch가 포함되어 있는지 확인하십시오. 자세한 내용은 Library files' corresponding features를 참고하십시오.

실시간 음성 변조 통합

음성 변조 API

성공적인 방 입장 및 마이크 활성화 후, SetVoiceType API를 호출하여 음성 변조 효과를 설정합니다. API가 0을 반환하면 호출이 성공한 것이고 방에 있는 사용자에게 들리는 로컬 사운드가 음성 변조 효과를 갖습니다. 음성 변조 효과를 테스트하려면 인이어 모니터링 기능(API: EnableLoopBack)을 사용하십시오.

함수 프로토타입

Android
iOS
Unity
C++
    public static class ITMG_VoiceType {
        public static final int ITMG_VOICE_TYPE_ORIGINAL_SOUND = 0;
        public static final int ITMG_VOICE_TYPE_LOLITA = 1;   
        public static final int ITMG_VOICE_TYPE_UNCLE = 2;  
        public static final int ITMG_VOICE_TYPE_INTANGIBLE = 3; 
        public static final int ITMG_VOICE_TYPE_DEAD_FATBOY = 4; 
        public static final int ITMG_VOICE_TYPE_HEAVY_MENTAL = 5;
        public static final int ITMG_VOICE_TYPE_DIALECT = 6; 
        public static final int ITMG_VOICE_TYPE_INFLUENZA = 7;
        public static final int ITMG_VOICE_TYPE_CAGED_ANIMAL = 8; 
        public static final int ITMG_VOICE_TYPE_HEAVY_MACHINE = 9;
        public static final int ITMG_VOICE_TYPE_STRONG_CURRENT = 10;
        public static final int ITMG_VOICE_TYPE_KINDER_GARTEN = 11; 
        public static final int ITMG_VOICE_TYPE_HUANG = 12;
    };
    public abstract int SetVoiceType(int type);

-(QAVResult)SetVoiceType:(ITMG_VOICE_TYPE) type 

public abstract class ITMGAudioEffectCtrl{
    public static int VOICE_TYPE_ORIGINAL_SOUND = 0;
    public static int VOICE_TYPE_LOLITA = 1;		
    public static int VOICE_TYPE_UNCLE = 2;			
    public static int VOICE_TYPE_INTANGIBLE = 3;	
    public static int VOICE_TYPE_DEAD_FATBOY = 4;	
    public static int VOICE_TYPE_HEAVY_MENTAL = 5;	 
    public static int VOICE_TYPE_DIALECT = 6;		
    public static int VOICE_TYPE_INFLUENZA = 7;		
    public static int VOICE_TYPE_CAGED_ANIMAL = 8;	
    public static int VOICE_TYPE_HEAVY_MACHINE = 9;	
    public static int VOICE_TYPE_STRONG_CURRENT = 10;
    public static int VOICE_TYPE_KINDER_GARTEN = 11;
    public static int VOICE_TYPE_HUANG = 12;
    public abstract int SetVoiceType(int voiceType);
}

class ITMGAudioEffectCtrl {
public:
    virtual ~ITMGAudioEffectCtrl(){};
    virtual int SetVoiceType(ITMG_VOICE_TYPE voiceType) = 0;
}

매개변수
유형
설명
type
int
로컬 음성 변조 효과의 종류를 나타냅니다
유형 매개변수
값
설명
ITMG_VOICE_TYPE_ORIGINAL_SOUND
0
오리지널
ITMG_VOICE_TYPE_LOLITA
1
로리타
ITMG_VOICE_TYPE_UNCLE
2
삼촌
ITMG_VOICE_TYPE_INTANGIBLE
3
오묘한
ITMG_VOICE_TYPE_DEAD_FATBOY
4
통통이
ITMG_VOICE_TYPE_HEAVY_MENTA
5
헤비메탈
ITMG_VOICE_TYPE_DIALECT
6
외국인
ITMG_VOICE_TYPE_INFLUENZA
7
감기
ITMG_VOICE_TYPE_CAGED_ANIMAL
8
동물
ITMG_VOICE_TYPE_HEAVY_MACHINE
9
기계
ITMG_VOICE_TYPE_STRONG_CURRENT
10
강한 전류
ITMG_VOICE_TYPE_KINDER_GARTEN
11
유치원
ITMG_VOICE_TYPE_HUANG
12
미니언

예시 코드

ITMGContextGetInstance()->GetAudioEffectCtrl()->setVoiceType(0);

음성 메시지에 대한 음성 변조 통합

음성 메시지에 대한 음성 변조 프로세스




음성 변조 효과는 재생 중에만 반영되므로 음성 변조는 원본 음성 메시지에는 영향을 미치지 않습니다.

음성 메시지 재생

음성 메시지 재생 API 호출 시 음성 변조 매개변수를 추가합니다.
Android
iOS
Unity
C++
public abstract int PlayRecordedFile(String filePath,int voicetype);

-(int)PlayRecordedFile:(NSString*)filePath VoiceType:(ITMG_VOICE_TYPE) type

ITMGPTT PlayRecordedFile(string filePath,int voiceType);

public abstract int PlayRecordedFile(string filePath,int voiceType);

매개변수
유형
설명
filePath
string
로컬 오디오 파일 경로
voicetype
int
음성 변조 유형

오류 코드

오류 코드 값
원인
솔루션 제안
20485
재생이 시작되지 않습니다
파일의 존재와 파일 경로의 유효성을 확인하십시오

문제 해결에 도움이 되었나요?
더 자세한 내용은 문의하기 또는 티켓 제출 을 통해 문의할 수 있습니다.
예
아니오

피드백