tencent cloud

피드백

Native SDK 빠른 통합

마지막 업데이트 시간:2024-01-18 15:57:14
    본문에서는 Native 프로젝트 개발자가 GME(Game Multimedia Engine)용 API를 쉽게 디버깅하고 통합할 수 있도록 자세한 설명을 제공합니다.
    이 문서는 API 디버깅 및 통합을 위해 GME를 시작하는 데 도움이 되는 기본 API만 제공합니다.

    GME 사용 시 주의할 점

    GME는 실시간 음성 채팅 서비스와 음성 메시지 및 음성-텍스트 변환 서비스의 두 가지 서비스를 제공하며 둘 다 Init 및 Poll과 같은 주요 API에 의존합니다.
    Init API 정보
    실시간 음성 채팅과 음성 메시지 서비스를 동시에 사용해야 하는 경우 Init API를 한 번만 호출하면 됩니다.

    API 호출 순서도

    
    image
    
    

    액세스 단계

    핵심 API

    실시간 음성 채팅

    음성 메시지

    핵심 API 액세스

    1. SDK 다운로드

    SDK 다운로드 가이드 페이지에서 적절한 클라이언트 SDK를 다운로드합니다.

    2. 헤더 파일 가져오기

    Java
    Object-C
    C++
    import com.tencent.TMG.ITMGContext;
    import com.tencent.av.sig.AuthBuffer;
    import com.tencent.bugly.crashreport.CrashReport;
    
    #import "GMESDK/TMGEngine.h"
    #import "GMESDK/QAVAuthBuffer.h"
    
    #include "auth_buffer.h"
    #include "tmg_sdk.h"
    #include "AdvanceHeaders/tmg_sdk_adv.h"
    #include <vector>
    

    3. 싱글톤 가져오기

    음성 기능을 사용하려면 ITMGContext 객체를 먼저 가져와야 합니다.

    함수 프로토타입

    Java
    Object-C
    C++
    public static ITMGContext GetInstance(Context context)
    
    
    + (ITMGContext*) GetInstance;
    
    __UNUSED static ITMGContext* ITMGContextGetInstance(){
    return ITMGContextGetInstanceInner(TMG_SDK_VERSION);
    }
    

    예시 코드

    Java
    Object-C
    C++
    //MainActivity.java
    import com.tencent.TMG.ITMGContext;
    ITMGContext tmgContext = ITMGContext.GetInstance(this);
    
    //TMGSampleViewController.m
    ITMGContext* _context = [ITMGContext GetInstance];
    
    ITMGContext* context = ITMGContextGetInstance();
    

    4. 콜백 설정

    API 클래스는 Delegate 메소드를 사용하여 애플리케이션에 콜백 알림을 보냅니다. 콜백 메시지 수신을 위해 입장 전 SDK에 콜백 함수를 등록합니다.

    함수 프로토타입 및 예시 코드

    콜백 메시지 수신을 위해 입장 전에 SDK에 콜백 함수를 등록합니다.
    Java
    Object-C
    C++
    //ITMGContext
    public abstract int SetTMGDelegate(ITMGDelegate delegate);
    
    //MainActivity.java
    tmgContext.SetTMGDelegate(TMGCallbackDispatcher.getInstance());
    
    ITMGDelegate < NSObject >
    
    //TMGSampleViewController.m
    ITMGContext* _context = [ITMGContext GetInstance];
    _context.TMGDelegate = [DispatchCenter getInstance];
    
    //SDK 초기화 시
    m_pTmgContext = ITMGContextGetInstance();
    m_pTmgContext->SetTMGDelegate(this);
    //소멸자 중
    CTMGSDK_For_AudioDlg::~CTMGSDK_For_AudioDlg()
    {
    ITMGContextGetInstance()->SetTMGDelegate(NULL);
    }
    

    콜백 예시

    콜백의 매개변수를 처리하려면 생성자에서 이 콜백 함수를 재정의하십시오.
    Java
    Object-C
    C++
    //MainActivity.java
    tmgContext.SetTMGDelegate(TMGCallbackDispatcher.getInstance());
    
    //RealTimeVoiceActivity.java
    public void OnEvent(ITMGContext.ITMG_MAIN_EVENT_TYPE type, Intent data) {
    if (type == ITMG_MAIN_EVENT_TYPE_ENTER_ROOM)
    {
    //콜백 프로세스
    }
    }
    
    //TMGCallbackDispatcher.java, TMGCallbackHelper.java 및 TMGDispatcherBase.java 참고
    
    //TMGRealTimeViewController.m
    TMGRealTimeViewController ()< ITMGDelegate >
    
    
    - (void)OnEvent:(ITMG_MAIN_EVENT_TYPE)eventType data:(NSDictionary *)data {
    NSString *log = [NSString stringWithFormat:@"OnEvent:%d,data:%@", (int)eventType, data];
    [self showLog:log];
    NSLog(@"====%@====", log);
    switch (eventType) {
    // Step 6/11 : Perform the enter room event
    case ITMG_MAIN_EVENT_TYPE_ENTER_ROOM: {
    int result = ((NSNumber *)[data objectForKey:@"result"]).intValue;
    NSString *error_info = [data objectForKey:@"error_info"];
    
    [self showLog:[NSString stringWithFormat:@"OnEnterRoomComplete:%d msg:(%@)", result, error_info]];
    
    if (result == 0) {
    [self updateStatusEnterRoom:YES];
    }
    }
    break;
    
    }
    }
    
    //DispatchCenter.h 및 DispatchCenter.m 참고
    
    //헤더 파일 중 선언
    virtual void OnEvent(ITMG_MAIN_EVENT_TYPE eventType,const char* data);
    //예시 코드
    void CTMGSDK_For_AudioDlg::OnEvent(ITMG_MAIN_EVENT_TYPE eventType, const char* data)
    {
    switch(eventType)
    {
    case ITMG_MAIN_EVENT_TYPE_XXXX_XXXX:
    {
    //콜백 처리 진행
    }
    break;
    }
    }
    
    매개변수
    유형
    설명
    type
    ITMGContext.ITMG_MAIN_EVENT_TYPE
    콜백 이벤트 유형
    data
    Intent 메시지 유형
    콜백 메시지, 즉, 이벤트 데이터

    5. SDK 초기화

    실시간 음성, 음성 메시지, 음성 텍스트 변환 서비스를 사용하려면 먼저 Init API를 통해 SDK를 초기화해야 합니다. Init API는 다른 API와 동일한 스레드에서 호출해야 합니다. 기본 스레드에서 모든 API를 호출하는 것이 좋습니다.

    API 프로토타입

    Java
    Object-C
    C++
    public abstract int Init(String sdkAppId, String openId);
    
    -(int)InitEngine:(NSString*)sdkAppID openID:(NSString*)openID;
    
    ITMGContext virtual int Init(const char* sdkAppId, const char* openId)
    
    매개변수
    유형
    설명
    sdkAppId
    string
    GME 콘솔에서 제공되는 AppID는 서비스 활성화에서 안내된 대로 얻을 수 있습니다.
    openID
    string
    openID는 Int64 타입만 가능하며 문자열로 변환되어 전달됩니다. 해당 규칙을 사용자 정의할 수 있으며 App에서 고유해야 합니다. Openid를 문자열로 전달하기 위해서는 Submit Ticket하여 신청하십시오.

    예시 코드

    Java
    Object-C
    C++
    //MainActivity.java
    int nRet = tmgContext.Init(appId, openId);
    if (nRet == AV_OK )
    {
    GMEAuthBufferHelper.getInstance().setGEMParams(appId, key, openId);
    // Step 4/11: Poll to trigger callback
    //https://www.tencentcloud.com/document/product/607/40860
    EnginePollHelper.createEnginePollHelper();
    showToast("Init success");
    }else if (nRet == AV_ERR_HAS_IN_THE_STATE) // SDK가 초기화되었습니다. 이 작업은 성공적입니다.
    {
    showToast("Init success");
    }else
    {
    showToast("Init error errorCode:" + nRet);
    }
    
    //TMGSampleViewController.m
    QAVResult result = [_context InitEngine:self.appIDTF.text openID:self.openIDTF.text];
    if (result == QAV_OK) {
    self.isSDKInit = YES;
    }
    
    #define SDKAPPID3RD "14000xxxxx"
    cosnt char* openId="10001";
    ITMGContext* context = ITMGContextGetInstance();
    context->Init(SDKAPPID3RD, openId);
    

    6. 이벤트 콜백 트리거

    이벤트 콜백은 update에서 Poll API를 주기적으로 호출하여 트리거할 수 있습니다. Poll API는 GME의 메시지 펌프이며 GME가 이벤트 콜백을 트리거하도록 주기적으로 호출해야 합니다. 그렇지 않으면 전체 SDK 서비스가 비정상적으로 실행됩니다. 자세한 내용은 SDK 다운로드 가이드의 EnginePollHelper 파일을 참고하십시오.

    예시 코드

    Java
    Object-C
    C++
    //MainActivity.java
    [EnginePollHelper createEnginePollHelper];
    
    //EnginePollHelper.java
    private Handler mhandler = new Handler();
    private Runnable mRunnable = new Runnable() {
    @Override
    public void run() {
    if (s_pollEnabled) {
    if (ITMGContext.GetInstance(null) != null)
    ITMGContext.GetInstance(null).Poll();
    }
    mhandler.postDelayed(mRunnable, 33);
    }
    };
    //Poll을 주기적으로 호출하는 코드는 EnginePollHelper.java를 참고하십시오.
    
    //TMGSampleViewController.m
    [EnginePollHelper createEnginePollHelper];
    //EnginePollHelper.m 및 EnginePollHelper.h 참고
    
    void TMGTestScene::update(float delta)
    {
    ITMGContextGetInstance()->Poll();
    }
    

    7. 로컬 인증 키 계산

    관련 기능의 암호화 및 인증을 위해 AuthBuffer를 생성합니다. 프로덕션 환경에서 릴리스하려면 Authentication Key에 설명된 대로 백엔드 배포 키를 사용하십시오.

    API 프로토타입

    Java
    Object-C
    C++
    AuthBuffer public native byte[] genAuthBuffer(int sdkAppId, String roomId, String openId, String key)
    
    //TMGSampleViewController.m
    [EnginePollHelper createEnginePollHelper];
    //EnginePollHelper.m 및 EnginePollHelper.h 참고
    
    void TMGTestScene::update(float delta)
    {
    ITMGContextGetInstance()->Poll();
    }
    
    매개변수
    유형
    설명
    appId
    int
    Tencent Cloud 콘솔의 AppId.
    roomId
    string
    방 ID, 최대 127자 지원(음성 메시지의 경우 null 입력).
    openId
    string
    사용자 ID. Init 시 openId와 동일.
    key
    string
    Tencent Cloud 콘솔의 권한 키.

    예시 코드

    Java
    Object-C
    C++
    //GMEAuthBufferHelper.java
    import com.tencent.av.sig.AuthBuffer;//헤더파일
    public byte[] createAuthBuffer(String roomId)
    {
    byte[] authBuffer;
    // Generate AuthBuffer for encryption and authentication of relevant features. For release in the production environment,
    // please use the backend deployment key as detailed in https://www.tencentcloud.com/document/product/607/12218
    if (TextUtils.isEmpty(roomId))
    {
    authBuffer = AuthBuffer.getInstance().genAuthBuffer(Integer.parseInt(mAppId), "0", mOpenId, mKey);
    }else
    {
    authBuffer = AuthBuffer.getInstance().genAuthBuffer(Integer.parseInt(mAppId), roomId, mOpenId, mKey);
    }
    return authBuffer;
    }
    
    //실시간 음성 채팅 인증
    NSData* authBuffer = [QAVAuthBuffer GenAuthBuffer:SDKAPPID3RD.intValue roomID:self.roomIdTF.text openID:_openId key:_key];
    //음성 메시지 인증
    NSData* authBuffer = [QAVAuthBuffer GenAuthBuffer:(unsigned int)SDKAPPID3RD.integerValue roomID:nil openID:self.openId key:AUTHKEY];
    
    unsigned int bufferLen = 512;
    unsigned char retAuthBuff[512] = {0};
    QAVSDK_AuthBuffer_GenAuthBuffer(atoi(SDKAPPID3RD), roomId, "10001", AUTHKEY,retAuthBuff,bufferLen);
    

    실시간 음성 채팅 액세스

    1. 방 입장

    생성된 인증 정보로 방에 입장하기 위해 사용하는 API입니다. 마이크와 스피커는 방 입장 후 기본적으로 켜지지 않습니다. 반환된 AV_OK 값은 API 호출은 성공했지만 방 입장은 성공하지 못했다는 의미입니다.

    API 프로토타입

    Java
    Object-C
    C++
    public abstract int EnterRoom(String roomID, int roomType, byte[] authBuffer);
    
    -(int)EnterRoom:(NSString*) roomId roomType:(int)roomType authBuffer:(NSData*)authBuffer;
    
    ITMGContext virtual int EnterRoom(const char* roomID, ITMG_ROOM_TYPE roomType, const char* authBuff, int buffLen);
    
    매개변수
    유형
    설명
    roomId
    String
    방 ID, 최대 127자 지원
    roomType
    int
    FLUENCY 음질을 사용하여 방에 입장하십시오
    authBuffer
    byte[]
    인증 코드

    예시 코드

    Java
    Object-C
    C++
    //RealTimeVoiceActivity.java
    byte[] authBuffer = GMEAuthBufferHelper.getInstance().createAuthBuffer(roomId);
    ITMGContext.GetInstance(this).EnterRoom(roomId, roomType, authBuffer);
    
    //TMGRealTimeViewController.m
    [[ITMGContext GetInstance] EnterRoom:self.roomIdTF.text roomType:(int)self.roomTypeControl.selectedSegmentIndex + 1 authBuffer:authBuffer];
    
    ITMGContext* context = ITMGContextGetInstance();
    context->EnterRoom(roomID, ITMG_ROOM_TYPE_FLUENCY, (char*)retAuthBuff,bufferLen);
    

    방 입장 콜백

    사용자가 방에 입장한 후 ITMG_MAIN_EVENT_TYPE_ENTER_ROOM 메시지가 전송되고 콜백 및 처리를 위해 OnEvent 함수에서 식별됩니다. 성공적인 콜백은 방 입장 성공 및 과금 시작을 의미합니다.
    예시 코드방 입장 및 네트워크 연결 해제 이벤트를 포함한 콜백 처리 예시 코드입니다.
    Java
    Object-C
    C++
    //RealTimeVoiceActivity.java
    public void OnEvent(ITMGContext.ITMG_MAIN_EVENT_TYPE type, Intent data) {
    if (type == ITMG_MAIN_EVENT_TYPE_ENTER_ROOM)
    {
    // Step 6/11 : Perform the enter room event
    int nErrCode = TMGCallbackHelper.ParseIntentParams2(data).nErrCode;
    String strMsg = TMGCallbackHelper.ParseIntentParams2(data).strErrMsg;
    if (nErrCode == AV_OK)
    {
    appendLog2MonitorView("EnterRomm success");
    }else
    {
    appendLog2MonitorView(String.format(Locale.getDefault(), "EnterRomm errCode:%d errMsg:%s", nErrCode, strMsg));
    }
    }
    }
    
    //TMGRealTimeViewController.m
    
    - (void)OnEvent:(ITMG_MAIN_EVENT_TYPE)eventType data:(NSDictionary *)data {
    NSString *log = [NSString stringWithFormat:@"OnEvent:%d,data:%@", (int)eventType, data];
    [self showLog:log];
    NSLog(@"====%@====", log);
    switch (eventType) {
    // Step 6/11 : Perform the enter room event
    case ITMG_MAIN_EVENT_TYPE_ENTER_ROOM: {
    int result = ((NSNumber *)[data objectForKey:@"result"]).intValue;
    NSString *error_info = [data objectForKey:@"error_info"];
    
    [self showLog:[NSString stringWithFormat:@"OnEnterRoomComplete:%d msg:(%@)", result, error_info]];
    
    if (result == 0) {
    [self updateStatusEnterRoom:YES];
    }
    }
    break;
    
    }
    
    void TMGTestScene::OnEvent(ITMG_MAIN_EVENT_TYPE eventType,const char* data){
    switch (eventType) {
    case ITMG_MAIN_EVENT_TYPE_ENTER_ROOM:
    {
    ListMicDevices();
    ListSpeakerDevices();
    std::string strText = "EnterRoom complete: ret=";
    strText += data;
    m_EditMonitor.SetWindowText(MByteToWChar(strText).c_str());
    }
    }
    }
    
    에러 코드
    에러 코드 값
    원인 및 권장 방안
    7006
    인증 실패. 가능한 원인들:
    AppID 가 존재하지 않거나 올바르지 않음
    authbuff를 인증하는 동안 오류 발생
    인증 만료
    openId 사양 불충족
    7007
    이미 다른 방에 있음
    1001
    사용자는 이미 방에 들어가는 과정에 있었지만 이 작업을 반복했습니다. 방 입장 콜백이 반환될 때까지 방 입장 API를 호출하지 않는 것이 좋습니다.
    1003
    사용자가 이미 방에 있었고 API를 입력하는 방을 다시 호출함
    1101
    SDK가 초기화되었는지, openId가 규칙을 준수하는지, API가 동일한 스레드에서 호출되는지, Poll API가 정상적으로 호출되는지 확인

    2. 마이크 활성화 또는 비활성화

    이 API는 마이크를 활성화/비활성화하는 데 사용됩니다. 방 입장 후 마이크와 스피커는 기본적으로 활성화되어 있지 않습니다.

    예시 코드

    Java
    Object-C
    C++
    //RealTimeVoiceActivity.java
    ITMGContext.GetInstance(this).GetAudioCtrl().EnableMic(true);
    
    //TMGRealTimeViewController.m
    [[[ITMGContext GetInstance] GetAudioCtrl] EnableMic:YES];
    
    ITMGContextGetInstance()->GetAudioCtrl()->EnableMic(true);
    

    3. 스피커 활성화 또는 비활성화

    이 API는 스피커를 활성화/비활성화하는 데 사용됩니다.

    예시 코드

    Java
    Object-C
    C++
    //RealTimeVoiceActivity.java
    ITMGContext.GetInstance(this).GetAudioCtrl().EnableSpeaker(true);
    
    //TMGRealTimeViewController.m
    [[[ITMGContext GetInstance] GetAudioCtrl] EnableSpeaker:YES];
    
    ITMGContextGetInstance()->GetAudioCtrl()->EnableSpeaker(true);
    

    4. 방 퇴장

    이 API는 현재 방을 나가기 위해 호출됩니다. 종료를 위해 콜백을 기다리고 처리해야 합니다.

    예시 코드

    Java
    Object-C
    C++
    //RealTimeVoiceActivity.java
    ITMGContext.GetInstance(this).ExitRoom();
    
    //TMGRealTimeViewController.m
    [[ITMGContext GetInstance] ExitRoom];
    
    ITMGContext* context = ITMGContextGetInstance();
    context->ExitRoom();
    

    방 퇴장 콜백

    사용자가 방을 나가면 ITMG_MAIN_EVENT_TYPE_EXIT_ROOM이라는 메시지와 함께 콜백이 반환됩니다. 예시 코드는 아래와 같습니다.
    Java
    Object-C
    C++
    //RealTimeVoiceActivity.java
    public void OnEvent(ITMGContext.ITMG_MAIN_EVENT_TYPE type, Intent data) {
    if (ITMGContext.ITMG_MAIN_EVENT_TYPE.ITMG_MAIN_EVENT_TYPE_EXIT_ROOM == type)
    {
    //방 퇴장 성공 이벤트 수신
    }
    }
    
    //TMGRealTimeViewController.m
    -(void)OnEvent:(ITMG_MAIN_EVENT_TYPE)eventType data:(NSDictionary *)data{
    NSLog(@"OnEvent:%lu,data:%@",(unsigned long)eventType,data);
    switch (eventType) {
    case ITMG_MAIN_EVENT_TYPE_EXIT_ROOM:
    {
    //방 퇴장 성공 이벤트 수신
    }
    break;
    }
    }
    
    void TMGTestScene::OnEvent(ITMG_MAIN_EVENT_TYPE eventType,const char* data){
    switch (eventType) {
    case ITMG_MAIN_EVENT_TYPE_EXIT_ROOM:
    {
    //프로세스
    break;
    }
    }
    }
    

    음성 메시지 액세스

    1. 인증 초기화

    SDK 초기화 후 인증 초기화를 호출합니다. authBuffer를 얻는 방법에 대한 자세한 내용은 genAuthBuffer(실시간 음성 채팅 인증 정보 API)를 참고하십시오.

    API 프로토타입

    Java
    Object-C
    C++
    public abstract int ApplyPTTAuthbuffer(byte[] authBuffer);
    
    -(QAVResult)ApplyPTTAuthbuffer:(NSData *)authBuffer;
    
    ITMGPTT virtual int ApplyPTTAuthbuffer(const char* authBuffer, int authBufferLen)
    
    매개변수
    유형
    의미
    authBuffer
    String
    인증

    예시 코드

    Java
    Object-C
    C++
    //VoiceMessageRecognitionActivity.java
    byte[] authBuffer = GMEAuthBufferHelper.getInstance().createAuthBuffer("");
    ITMGContext.GetInstance(this).GetPTT().ApplyPTTAuthbuffer(authBuffer);
    
    //TMGPTTViewController.m
    NSData* authBuffer = [QAVAuthBuffer GenAuthBuffer:(unsigned int)SDKAPPID3RD.integerValue roomID:nil openID:self.openId key:AUTHKEY];
    [[[ITMGContext GetInstance] GetPTT] ApplyPTTAuthbuffer:authBuffer];
    
    ITMGContextGetInstance()->GetPTT()->ApplyPTTAuthbuffer(authBuffer,authBufferLen);
    

    2. 스트리밍 음성 인식 시작

    이 API는 스트리밍 음성 인식을 시작하는 데 사용됩니다. 음성-텍스트 변환에서 얻은 텍스트는 콜백에서 실시간으로 반환됩니다. 녹음을 중지하려면 StopRecording을 호출합니다. 녹음이 중지된 후 콜백이 반환됩니다.

    API 프로토타입

    Java
    Object-C
    C++
    public abstract int StartRecordingWithStreamingRecognition (String filePath);
    
    public abstract int StopRecording();
    
    -(int)StartRecordingWithStreamingRecognition:(NSString *)filePath;
    
    -(QAVResult)StopRecording;
    
    ITMGPTT virtual int StartRecordingWithStreamingRecognition(const char* filePath)
    
    ITMGPTT virtual int StopRecording()
    
    매개변수
    유형
    설명
    filePath
    String
    저장된 오디오 파일의 경로

    예시 코드

    Java
    Object-C
    C++
    //VoiceMessageRecognitionActivity.java
    ITMGContext.GetInstance(this).GetPTT().StartRecordingWithStreamingRecognition(recordfilePath);
    
    //TMGPTTViewController.m
    QAVResult ret = [[[ITMGContext GetInstance] GetPTT] StartRecordingWithStreamingRecognition:[self pttTestPath]];
    if (ret == 0) {
    self.currentStatus = @"스트리밍 녹음 시작";
    } else {
    self.currentStatus = @"스트리밍 녹음 시작 실패";
    }
    
    ITMGContextGetInstance()->GetPTT()->StartRecordingWithStreamingRecognition(filePath);
    

    스트리밍 음성 인식 콜백

    스트리밍 음성 인식이 시작된 후 콜백 함수 OnEvent에서 콜백 메시지를 수신 대기해야 합니다. 이벤트 메시지는 ITMG_MAIN_EVNET_TYPE_PTT_STREAMINGRECOGNITION_COMPLETE입니다. 즉, 녹화가 중지되고 인식이 완료된 후 텍스트를 반환합니다. 이는 한 단락을 말한 이후에 인식된 텍스트를 반환하는 것과 같습니다.
    이벤트 메시지는 실제 필요에 따라 OnEvent 함수에서 식별됩니다. 전달된 매개변수에는 다음 네 가지 메시지가 포함됩니다.
    메시지 이름
    설명
    result
    스트리밍 음성 인식 성공 여부를 판단하기 위한 반환 코드
    text
    음성에서 변환된 텍스트
    file_path
    저장된 녹음 파일의 로컬 경로
    file_id
    90일 동안 보관되는 녹음 파일의 백엔드 url 주소
    예시 코드
    Java
    Object-C
    C++
    //VoiceMessageRecognitionActivity.java
    import static com.tencent.TMG.ITMGContext.ITMG_MAIN_EVENT_TYPE.ITMG_MAIN_EVNET_TYPE_PTT_STREAMINGRECOGNITION_COMPLETE;
    public void OnEvent(ITMGContext.ITMG_MAIN_EVENT_TYPE type, Intent data) {
    if (type == ITMG_MAIN_EVNET_TYPE_PTT_STREAMINGRECOGNITION_COMPLETE)
    {
    // Step 1.3/3 handle ITMG_MAIN_EVNET_TYPE_PTT_STREAMINGRECOGNITION_COMPLETE event
    mIsRecording = false;
    if (nErrCode ==0)
    {
    String recordfilePath = data.getStringExtra("file_path");
    mRecFilePathView.setText(recordfilePath);
    
    String recordFileUrl = data.getStringExtra("file_id");
    mRecFileUrlView.setText(recordFileUrl);
    }
    else
    {
    appendLog2MonitorView("Record and recognition fail errCode:" + nErrCode);
    }
    }
    
    }
    
    //TMGPTTViewController.m
    
    - (void)OnEvent:(ITMG_MAIN_EVENT_TYPE)eventType data:(NSDictionary*)data
    {
    NSNumber *number = [data objectForKey:@"result"];
    switch (eventType)
    {
    case ITMG_MAIN_EVNET_TYPE_PTT_STREAMINGRECOGNITION_COMPLETE:
    {
    if (data != NULL &&[[data objectForKey:@"result"] intValue]== 0)
    {
    self.translateTF.text = [data objectForKey:@"text"] ;
    self.currentStatus = @"스트리밍 변환 완료";
    }
    }
    break;
    }
    
    void TMGTestScene::OnEvent(ITMG_MAIN_EVENT_TYPE eventType,const char* data){
    switch (eventType) {
    case ITMG_MAIN_EVNET_TYPE_PTT_STREAMINGRECOGNITION_COMPLETE:
    {
    HandleSTREAM2TEXTComplete(data,true);
    break;
    }
    ...
    case ITMG_MAIN_EVNET_TYPE_PTT_STREAMINGRECOGNITION_IS_RUNNING:
    {
    HandleSTREAM2TEXTComplete(data, false);
    break;
    }
    }
    }
    void CTMGSDK_For_AudioDlg::HandleSTREAM2TEXTComplete(const char* data, bool isComplete)
    {
    std::string strText = "STREAM2TEXT: ret=";
    strText += data;
    m_EditMonitor.SetWindowText(MByteToWChar(strText).c_str());
    Json::Reader reader;
    Json::Value root;
    bool parseRet = reader.parse(data, root);
    if (!parseRet) {
    ::SetWindowText(m_EditInfo.GetSafeHwnd(),MByteToWChar(std::string("parse result Json error")).c_str());
    }
    else
    {
    if (isComplete) {
    ::SetWindowText(m_EditUpload.GetSafeHwnd(), MByteToWChar(root["file_id"].asString()).c_str());
    }
    else{
    std::string isruning = "STREAMINGRECOGNITION_IS_RUNNING";
    ::SetWindowText(m_EditUpload.GetSafeHwnd(), MByteToWChar(isruning).c_str());
    }
    }
    }
    
    에러 코드
    에러 코드
    설명
    제안된 솔루션
    32775
    스트리밍 음성을 텍스트로 변환하는 데 실패했지만 녹음은 성공함
    UploadRecordedFile API를 호출하여 녹음 파일을 업로드한 다음 SpeechToText API를 호출하여 음성을 텍스트로 변환
    32777
    스트리밍 음성을 텍스트로 변환하는 데 실패했지만 녹음 및 업로드는 성공함
    반환된 메시지에는 업로드 성공 후 백엔드 url이 포함되어 있으며, SpeechToText API를 호출하여 음성을 텍스트로 변환
    32786
    스트리밍 음성-텍스트 변환 실패
    스트리밍 녹화 중 스트리밍 녹화 API의 실행 결과가 반환될 때까지 기다리십시오

    3. 녹음 중지

    이 API는 녹음을 중지하는 데 사용됩니다. 비동기식이며 녹음이 중지된 후 녹음 완료에 대한 콜백이 반환됩니다. 녹음 파일은 녹음이 성공한 후에만 사용할 수 있습니다.

    API 프로토타입

    Java
    Object-C
    C++
    public abstract int StopRecording();
    
    -(QAVResult)StopRecording;
    
    ITMGPTT virtual int StopRecording();
    

    예시 코드

    Java
    Object-C
    C++
    //VoiceMessageRecognitionActivity.java
    ITMGContext.GetInstance(this).GetPTT().StopRecording();
    
    //TMGPTTViewController.m
    
    - (void)stopRecClick {
    // Step 3/12 stop recording, need handle ITMG_MAIN_EVNET_TYPE_PTT_RECORD_COMPLETE event
    // https://www.tencentcloud.com/document/product/607/15221
    QAVResult ret = [[[ITMGContext GetInstance] GetPTT] StopRecording];
    if (ret == 0) {
    self.currentStatus = @"녹음 중지";
    } else {
    self.currentStatus = @"녹음 중지 실패";
    }
    }
    
    ITMGContextGetInstance()->GetPTT()->StopRecording();
    
    
    문의하기

    고객의 업무에 전용 서비스를 제공해드립니다.

    기술 지원

    더 많은 도움이 필요하시면, 티켓을 통해 연락 바랍니다. 티켓 서비스는 연중무휴 24시간 제공됩니다.

    연중무휴 24시간 전화 지원