tencent cloud

PrevNext

피드백

키워드를 검색하세요

Recent Pages

문서
Game Multimedia Engine
    문서
    Download PDF

    Getting Started

    마지막 업데이트 시간:2024-01-18 15:11:45
    PDF 다운로드
      This document describes how to get started with the GME APIs for Cocos2d.
      This document only describes the most important APIs to help you get started with GME. For more information on APIs, please see the API documentation.
      Important API
      Description
      Init
      Initializes GME
      Poll
      Triggers event callback
      EnterRoom
      Enters room
      EnableMic
      Enables mic
      EnableSpeaker
      Enables speaker
      Configure your project before using GME; otherwise, the SDK will not take effect.
      After a GME API is called successfully, AV_OK will be returned with the value being 0.
      GME APIs should be called in the same thread.
      The Poll API should be called periodically for GME to trigger event callbacks.
      For GME callback messages, please see the callback message list.
      Operation on devices should be performed after successful room entry.
      For detailed error codes, please see Error Codes.

      Directions for Quick Access

      1. Get a singleton

      To use the voice feature, get the ITMGContext object first.

      Sample code

      ITMGContext* context = ITMGContextGetInstance();
      context->SetTMGDelegate(this);

      2. Initialize the SDK

      For more information on how to get parameters, please see Access Guide. This API requires the AppID from the Tencent Cloud Console and the openID as parameters. The openID uniquely identifies a user with the rules stipulated by the application developer and must be unique in the application (currently, only INT64 is supported).
      Note:
      The SDK must be initialized so that a room can be entered

      Function prototype

      ITMGContext virtual int Init(const char* sdkAppId, const char* openID)
      Parameter
      Type
      Description
      sdkAppId
      char*
      AppId from the Tencent Cloud Console
      openId
      char*
      OpenID can only be in Int64 type (converted to char*) with a value greater than 10,000, which is used to identify the user

      Sample code

      #define SDKAPPID3RD "1400089356"
      cosnt char* openId="10001";
      ITMGContext* context = ITMGContextGetInstance();
      context->Init(SDKAPPID3RD, openId);

      3. Trigger event callback

      Event callbacks can be triggered by periodically calling the Poll API in update.

      Function prototype

      class ITMGContext {
      protected:
          virtual ~ITMGContext() {}
      
      public:    	
          virtual void Poll()= 0;
      }

      Sample code

      ITMGContextGetInstance()->Poll();

      4. Authenticate

      Generate AuthBuffer for encryption and authentication of relevant features. For release in the production environment, please use the backend deployment key as detailed in Authentication Key.To get authentication for voice messaging and speech-to-text, the room ID parameter must be set to null.

      Function prototype

      int  QAVSDK_AuthBuffer_GenAuthBuffer(unsigned int dwSdkAppID, const char* strRoomID, const char* strOpenID,
          const char* strKey, unsigned char* strAuthBuffer, unsigned int bufferLength);
      Parameter
      Type
      Description
      dwSdkAppID
      int
      AppId from the Tencent Cloud Console.
      strRoomID
      char*
      Room ID, which can contain up to 127 characters (for voice messaging and speech-to-text feature, enter null).
      strOpenID
      char*
      User ID, which is the same as openID during initialization.
      strKey
      char*
      Permission key from the Tencent Cloud Console.
      strAuthBuffer
      char*
      Returned authbuff.
      bufferLength
      int
      Length of the authbuff passed in. 500 is recommended.

      Sample code

      unsigned int bufferLen = 512;
      unsigned char retAuthBuff[512] = {0};
      QAVSDK_AuthBuffer_GenAuthBuffer(atoi(SDKAPPID3RD), roomId, "10001", AUTHKEY,retAuthBuff,bufferLen);

      5. Enter a room

      When a client enters a room with the generated authentication information, the ITMG_MAIN_EVENT_TYPE_ENTER_ROOM message will be received as a callback. Mic and speaker are not enabled by default after room entry. The returned value of AV_OK indicates a success. For entering a common voice chat room that does not involve range voice, use the common room entry API. For more information, please see Range Voice.

      Function prototype

      ITMGContext virtual int EnterRoom(const char*  roomID, ITMG_ROOM_TYPE roomType, const char* authBuffer, int buffLen)
      Parameter
      Type
      Description
      roomID
      char*
      Room ID, which can contain up to 127 characters
      roomType
      ITMG_ROOM_TYPE
      Room audio type
      authBuffer
      char*
      Authentication key
      buffLen
      int
      Authentication key length
      For more information on how to choose a room audio type, please see Sound Quality Selection.

      Sample code

      ITMGContext* context = ITMGContextGetInstance();
      context->EnterRoom(roomID, ITMG_ROOM_TYPE_STANDARD, (char*)retAuthBuff,bufferLen);

      6. Receive callback for room entry

      After the client enters the room, the message ITMG_MAIN_EVENT_TYPE_ENTER_ROOM will be sent and identified in the OnEvent function.

      Sample code

      
      void TMGTestScene::OnEvent(ITMG_MAIN_EVENT_TYPE eventType,const char* data){
          switch (eventType) {
                  case ITMG_MAIN_EVENT_TYPE_ENTER_ROOM:
              {
              // Process
              break;
              }
          }
      }

      7. Enable/Disable the mic

      This API is used to enable/disable the mic. Mic and speaker are not enabled by default after room entry.

      Function prototype

      ITMGAudioCtrl virtual int EnableMic(bool bEnabled)
      Parameter
      Type
      Description
      bEnabled
      bool
      To enable the mic, set this parameter to true; otherwise, set it to false.

      Sample code

      ITMGContextGetInstance()->GetAudioCtrl()->EnableMic(true);

      8. Enable/Disable the speaker

      This API is used to enable/disable the speaker.

      Function prototype

      ITMGAudioCtrl virtual int EnableSpeaker(bool enable )
      Parameter
      Type
      Description
      enable
      bool
      To disable the speaker, set this parameter to false; otherwise, set it to true.

      Sample code

      ITMGContextGetInstance()->GetAudioCtrl()->EnableSpeaker(true);
      
      문의하기

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

      문의하기
      기술 지원

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

      티켓 제출
      연중무휴 24시간 전화 지원
      Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
      개인정보 처리방침서비스 약관쿠키 정책