tencent cloud

PrevNext

フィードバック

キーワードで検索してください

Recent Pages

ドキュメント
Tencent Real-Time Communication
    ドキュメント
    Download PDF

    Android&iOS&Windows&Mac

    最終更新日:2024-07-19 15:29:07
    PDFファイルをダウンロード
      このドキュメントでは、主にTRTC SDKを使用して、カスタムオーディオのキャプチャと取得を実装する方法を紹介します。オーディオキャプチャとオーディオ取得の2つの部分に分かれています。

      オーディオキャプチャのカスタマイズ

      TRTC SDKのカスタムオーディオキャプチャ機能の有効化は、機能の有効化とSDKへのオーディオフレームの送信の2つの手順に分かれています。具体的なAPIの使用手順は次のとおりです。また、対応するプラットホームのAPI-Exampleも提供します：
      Android
      iOS
      Windows

      カスタムオーディオキャプチャ機能の有効化

      まず、TRTCCloudのenableCustomAudioCaptureインターフェースを呼び出して、TRTC SDKのカスタムオーディオキャプチャ機能を有効にしてください。サンプルコードは次のとおりです：
      Android
      iOS&Mac
      Windows 
      TRTCCloud mTRTCCloud = TRTCCloud.shareInstance();
      mTRTCCloud.enableCustomAudioCapture(true);
      
      self.trtcCloud = [TRTCCloud sharedInstance];
      [self.trtcCloud enableCustomAudioCapture:YES];
      
      liteav::ITRTCCloud* trtc_cloud = liteav::ITRTCCloud::getTRTCShareInstance();
      trtc_cloud->enableCustomAudioCapture(true);
      

      カスタムオーディオフレームの送信

      次に、TRTCCloudのsendCustomAudioDataインターフェースを使用して、TRTC SDKに自身の音声データを送信できます。サンプルコードは次のとおりです：
      Android
      iOS&Mac
      Windows 
      TRTCCloudDef.TRTCAudioFrame trtcAudioFrame = new TRTCCloudDef.TRTCAudioFrame();
      trtcAudioFrame.data = data;
      trtcAudioFrame.sampleRate = sampleRate;
      trtcAudioFrame.channel = channel;
      trtcAudioFrame.timestamp = timestamp;
      mTRTCCloud.sendCustomAudioData(trtcAudioFrame);
      
      TRTCAudioFrame *audioFrame = [[TRTCAudioFrame alloc] init];
      audioFrame.channels = audioChannels;
      audioFrame.sampleRate = audioSampleRate;
      audioFrame.data = pcmData;
      
      [self.trtcCloud sendCustomAudioData:audioFrame];
      
      liteav::TRTCAudioFrame frame;
      frame.audioFormat = liteav::TRTCAudioFrameFormatPCM;
      frame.length = buffer_size;
      frame.data = array.data();
      frame.sampleRate = 48000;
      frame.channel = 1;
      getTRTCShareInstance()->sendCustomAudioData(&frame);
      
      ご注意：
      endCustomAudioData`を使用すると、エコーキャンセル(AEC)の機能が無効になる場合があります。

      オーディオ生データの取得

      音声モジュールは非常に複雑なモジュールで、SDKは音声デバイスのキャプチャおよび再生のロジックを厳密に制御する必要があります。一部のシーンにおいて、リモートユーザーのオーディオデータまたはローカルマイクによってキャプチャされたオーディオデータを取得する必要がある場合は、TRTCCloudに対応する異なるプラットフォームのインターフェースを介して取得することができ、対応するプラットフォームのAPI-Exampleも提供します：
      Android：
      iOS
      Windows

      オーディオコールバック関数の設定

      Android
      iOS&Mac
      Windows
      mTRTCCloud.setAudioFrameListener(new TRTCCloudListener.TRTCAudioFrameListener() {
              @Override
              public void onCapturedRawAudioFrame(TRTCCloudDef.TRTCAudioFrame trtcAudioFrame) {
      
              }
      
              @Override
              public void onLocalProcessedAudioFrame(TRTCCloudDef.TRTCAudioFrame trtcAudioFrame) {
      
              }
      
              @Override
              public void onRemoteUserAudioFrame(TRTCCloudDef.TRTCAudioFrame trtcAudioFrame, String s) {
      
              }
      
              @Override
              public void onMixedPlayAudioFrame(TRTCCloudDef.TRTCAudioFrame trtcAudioFrame) {
      
              }
      
              @Override
              public void onMixedAllAudioFrame(TRTCCloudDef.TRTCAudioFrame trtcAudioFrame) {
                  // 詳細については、TRTC-API-Exampleのカスタムレンダリングのツールクラスをご参照ください：com.tencent.trtc.mediashare.helper.CustomFrameRender  
              }
          }); 
      
       [self.trtcCloud setAudioFrameDelegate:self];
       // MARK: - TRTCAudioFrameDelegate
       - (void)onCapturedRawAudioFrame:(TRTCAudioFrame *)frame {
              NSLog(@"onCapturedRawAudioFrame");
      }
      
      - (void)onLocalProcessedAudioFrame:(TRTCAudioFrame *)frame {
              NSLog(@"onLocalProcessedAudioFrame");
      }
      
      - (void)onRemoteUserAudioFrame:(TRTCAudioFrame *)frame userId:(NSString *)userId {
              NSLog(@"onRemoteUserAudioFrame");
      }
      
      - (void)onMixedPlayAudioFrame:(TRTCAudioFrame *)frame {
              NSLog(@"onMixedPlayAudioFrame");
      }
      
      - (void)onMixedAllAudioFrame:(TRTCAudioFrame *)frame {
              NSLog(@"onMixedAllAudioFrame");
      }
      
      // オーディオデータのカスタムコールバックの設定
      liteav::ITRTCCloud* trtc_cloud = liteav::ITRTCCloud::getTRTCShareInstance();
      trtc_cloud->setAudioFrameCallback(callback)
      
      // オーディオデータのカスタムコールバック
      
      virtual void onCapturedRawAudioFrame(TRTCAudioFrame* frame) {
      }
      
      virtual void onLocalProcessedAudioFrame(TRTCAudioFrame* frame) {
      }
      
      virtual void onPlayAudioFrame(TRTCAudioFrame* frame, const char* userId) {
      }
      
      virtual void onMixedPlayAudioFrame(TRTCAudioFrame* frame) {
      }
      
      ご注意：
      音声が途切れたりエコーキャンセル(AEC)が無効になったりするトラブルが発生するおそれがありますので、上述のコールバック関数では時間のかかる操作を行わず、直接コピーして別のスレッドで処理することを推奨します。
      各種の不確実な影響が生じるおそれがありますので、上述のコールバック関数でコールバックされたデータはいずれも読み取りとコピーのみが許可され、修正することはできません。
      お問い合わせ

      カスタマーサービスをご提供できるため、ぜひお気軽にお問い合わせくださいませ。

      お問い合わせ
      テクニカルサポート

      さらにサポートが必要な場合は、サポートチケットを送信して弊社サポートチームにお問い合わせください。24時間365日のサポートをご提供します。

      チケットを送信
      電話サポート（24 時間365日対応）
      Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
      個人情報保護方針利用規約クッキーポリシー