当社のAppをダウンロードしてインストールし、多人数ビデオミーティングの効果を体験いただけます。これには、画面共有、美顔、低遅延ミーティングなど、TRTCの多人数ビデオミーティングシナリオ関連の機能が含まれています。

AppのUIの再利用

手順1：アプリケーションの新規作成

1. TRTCコンソールにログインし、【開発支援】>【Demoクイックスタート】を選択します。
2. アプリケーション名（例：TestMeetingRoom）を入力し、【作成】をクリックします。
3. 【ダウンロードしました。次のステップ】をクリックすると、この手順をスキップします。

注意：

本機能はTencent CloudのTRTCとIMという2つの基本的なPaaSサービスを同時に使用し、TRTCをアクティブにした後、IMサービスを同期的にアクティブにすることができます。IMは付加価値サービスであり、課金ルールの詳細については 、Instant Messagingの料金説明をご参照ください。

手順2：Appソースコードのダウンロード

TRTCFlutterScenesDemoクリックして当該ページに入り、ソースコードをCloneまたはダウンロードします。

手順3：Appファイルの設定

1. 設定変更ページに進み、ダウンロードしたソースコードパッケージに基づき、対応する開発環境を選択します。

2. /lib/debug/GenerateTestUserSig.dartファイルを見つけて開きます。

3. GenerateTestUserSig.dartファイル内の関連パラメータを設定します。

   • SDKAPPID：デフォルトはPLACEHOLDER。実際のSDKAppIDを設定してください。
   • SECRETKEY：デフォルトはPLACEHOLDER。実際のキー情報を設定してください。

4. 貼り付け完了後、【貼り付けました。次のステップ】をクリックすれば、作成が完了します。

5. コンパイル完了後、【コンソール概要に戻る】をクリックすればOKです。

注意：

• ここで言及したUserSigの新規作成ソリューションでは、クライアントコードでSECRETKEYを設定します。この手法のうちSECRETKEYは逆コンパイルによって逆向きにクラッキングされやすく、キーがいったん漏洩すると、攻撃者はTencent Cloudトラフィックを盗用できるようになります。そのためのこの手法は、ローカルのDemoクイックスタートおよび機能デバッグにのみ適合します。
• UserSigの正しい発行方法は、UserSigの計算コードをサーバーに統合し、Appのインターフェース向けに提供します。 UserSigが必要なときは、Appから業務サーバーにリクエストを発出し動的にUserSigを取得します。詳細はサーバーでのUserSig新規作成をご参照ください。

手順4：コンパイル実行

注意：

Android端末は実際のマシンで実行する必要があり、エミュレーターのデバッグはサポートされていません。

1. flutter pub getを実行します。
2. コンパイルを実行し、デバッグを行います。
   • iOS 端末
   • Android 端末

   1. XCode（11.0およびそれ以降のバージョン）を使用して、ソースコードディレクトリの /iosプロジェクト を開きます。
   2. コンパイルを行い、Demoプロジェクトを実行します。

   1. flutter runを実行します。
   2. Android Studio（3.5およびそれ以降のバージョン）を使用して、ソースプロジェクトを開き、【実行】をクリックすれば完了です。

手順5：Demoソースコードの修正

ソースコードのTRTCMeetingDemoフォルダには、uiとmodelの2つのサブフォルダが含まれ、uiフォルダの中はいずれもインターフェースコードです。以下の表にはファイルまたはフォルダおよび対応するUIをリストアップし、二次調整に役立つようにしています。

カスタムUIの実装

ソースコードの中のTRTCMeetingDemoフォルダにはuiとmodelの2つのサブフォルダが含まれ、modelフォルダには再利用可能なオープンソースコンポーネントTRTCMeetingが含まれています。TRTCMeeting.dart ファイルの中からこのコンポーネントが提供するインターフェース関数を見つけ、対応するインターフェースを使用してカスマイズUIを実装することが可能です。

手順1：SDKへの統合

インタラクティブライブストリーミングコンポーネントTRTCMeetingは、TRTC SDKとIM SDKに依存しています。pubspec.yamlを設定することで、自動的にダウンロードして更新できます。

プロジェクトのpubspec.yamlに次の依存関係を記述します。

dependencies:
 tencent_trtc_cloud: 最新バージョン番号
 tencent_im_sdk_plugin: 最新バージョン番号

手順2：権限の設定および難読化ルール

手順3：TRTCMeetingコンポーネントのインポート

次のディレクトリ内のすべてのファイルをプロジェクトにコピーします。

lib/TRTCMeetingDemo/model/

手順4：コンポーネントの作成およびログイン

1. sharedInstanceインターフェースを呼び出すと、TRTCMeetingコンポーネントのインスタンスオブジェクトを作成できます。
2. registerListener関数を呼び出して、コンポーネントのイベント通知を登録します。
3. login関数を呼び出してコンポーネントのログインを完了します。下表を参考にキーパラメータを入力してください。

   パラメータ名	作用
   sdkAppId	TRTCコンソール でSDKAppIDを表示できます。
   userId	現在のユーザーID。文字列タイプでは、英語のアルファベット（a-zとA-Z）、数字（0-9）、ハイフン（-）とアンダーライン（_）のみ使用できます。
   userSig	Tencent Cloudによって設計されたセキュリティ保護署名。取得方法については、UserSigの計算方法をご参照ください。

TRTCMeeting trtcMeeting = TRTCMeeting.sharedInstance();
trtcMeeting.registerListener(onListener);
ActionCallback res = await trtcMeeting.login(
    GenerateTestUserSig.sdkAppId,
    userId,
    GenerateTestUserSig.genTestSig(userId),
);
if (res.code == 0) {
    // ログイン成功
}

手順5：多人数ミーティングの新規作成

1. キャスターは、手順4でログインした後、setSelfProfileを呼び出して自身のニックネームおよびプロフィール画像を設定することができます。
2. キャスターがcreateMeetingを呼び出し、新しいミーティングルームを作成します。
3. キャスターは、startCameraPreviewを呼び出してビデオ画面をキャプチャすることができ、startMicrophoneを呼び出して音声をキャプチャすることもできます。
4. キャスターに美顔のニーズがある場合は、インターフェース上に美顔調節ボタンを設定して呼び出すことができ、getBeautyManager を介して美顔設定を行います。

   説明：

   エンタープライズ版以外のSDKは美顔やスタンプの機能をサポートしていません。

// 1. キャスターがニックネームとプロフィール画像を設定
trtcMeeting.setSelfProfile('my_name', 'my_avatar');

// 2. キャスターがミーティングを作成
ActionCallback res = await trtcMeeting.createMeeting(roomId);
if (res.code == 0) {
    // ミーティング作成に成功
    // 3. カメラと音声キャプチャを起動
    trtcMeeting.startCameraPreview(true, TRTCCloudVideoViewId);
    trtcMeeting.startMicrophone();
    // 4. 美顔設定
    trtcMeeting.getBeautyManager().setBeautyStyle(TRTCCloudDef.TRTC_BEAUTY_STYLE_PITU);
    trtcMeeting.getBeautyManager().setBeautyLevel(6);
}

手順6：参加者の多人数ミーティングへの参加

1. 参加者は、手順4でログインした後、setSelfProfileを呼び出して自身のニックネームおよびプロフィール画像を設定することができます。
2. 参加者は、enterMeeting呼び出してミーティングルーム番号を渡すと、ミーティングルームに参加できます。
3. 参加者は、startCameraPreviewを呼び出してビデオ画面をキャプチャすることができ、またstartMicrophoneを呼び出して音声をキャプチャすることもできます。
4. 他の参加者がカメラを起動すると、onUserVideoAvailableのイベントを受け取ります。この時、startRemoteViewを呼び出してuserIdを渡すと再生を開始できます。

// 1. 参加者がニックネームとプロフィール画像を設定
trtcMeeting.setSelfProfile('my_name', 'my_avatar');

// 2. 参加者がenterMeetingを呼び出してミーティングルームに参加
ActionCallback res = await trtcMeeting.enterMeeting(roomId);
if (res.code == 0) {
    // ミーティング参加に成功
    // 3. カメラと音声キャプチャを起動
    trtcMeeting.startCameraPreview(true, TRTCCloudVideoViewId);
    trtcMeeting.startMicrophone();
    // 4. 美顔設定
    trtcMeeting.getBeautyManager().setBeautyStyle(TRTCCloudDef.TRTC_BEAUTY_STYLE_PITU);
    trtcMeeting.getBeautyManager().setBeautyLevel(6);
}

// 5. 参加者が他のメンバーのカメラ起動の通知を受信し、再生が開始されます
trtcMeeting.registerListener(onListener);
onListener(TRTCMeetingDelegate type, param) {
    switch (type) {
        case TRTCMeetingDelegate.onUserVideoAvailable:
            if (param['available']) {
                trtcMeeting.startCameraPreview(
                    param['userId'],
                    TRTCCloudDef.TRTC_VIDEO_STREAM_TYPE_BIG,
                    TRTCCloudVideoViewId
                );
            } else {
                trtcMeeting.stopRemoteView(
                    param['userId'],
                    TRTCCloudDef.TRTC_VIDEO_STREAM_TYPE_BIG
                );
            }
            break;
    }
}

手順7：画面共有

1. 画面共有機能は、システムにフローティングウィンドウの権限を申請する必要があり、自分でUIの中で特定のロジックを実装する必要があります。
2. startScreenCaptureを呼び出し、エンコードパラメータとスクリーンキャプチャのプロセスのフローティングウィンドウを渡すと、画面共有機能を実装できます。具体的な情報については、TRTC SDKをご参照ください。
3. ミーティング中の他メンバーがonUserVideoAvailableのイベント通知を受け取ります。

注意：

画面共有とカメラキャプチャは相互排他的な操作です。画面共有機能をアクティブにしたい場合は、先にstopCameraPreviewを呼び出してカメラキャプチャを停止してください。詳細については、TRTC SDKをご参照ください。

await trtcMeeting.stopCameraPreview();
trtcMeeting.startScreenCapture(
    videoFps: 10,
    videoBitrate: 1600,
    videoResolution: TRTCCloudDef.TRTC_VIDEO_RESOLUTION_1280_720,
    videoResolutionMode: TRTCCloudDef.TRTC_VIDEO_RESOLUTION_MODE_PORTRAIT,
    appGroup: iosAppGroup,
);

手順8：文字チャットとミュートメッセージの実現

• sendRoomTextMsgにより、ノーマルなテキストメッセージを送信でき、そのミーティングのすべての参加者がonRecvRoomTextMsgのコールバックを受信します。IMバックエンドにはデフォルトのセンシティブワードフィルタリングルールが備わっており、センシティブワードと判定されたテキストメッセージがクラウドで転送されることはありません。

  // 送信側：テキストメッセージの送信
  trtcMeeting.sendRoomTextMsg('Hello Word!');
  // 受信側：テキストメッセージの監視
  trtcMeeting.registerListener(onListener);
  onListener(TRTCMeetingDelegate type, param) {
      switch (type) {
          case TRTCMeetingDelegate.onRecvRoomTextMsg:
              print( param['userName'] + 'からのメッセージ：' + param['message']+'を受信' );
              break;
      }
  }

• sendRoomCustomMsgにより、カスタム（コマンド）メッセージを送信でき、そのミーティングのすべての参加者がonRecvRoomCustomMsgのコールバックを受信します。カスタムメッセージは、通常カスタマイズしたシグナリングの転送に使用されます（例：ミュートの会場内制御など）。

  // 送信側：カスタマイズしたcmdでミュートの通知を区別できます
  // eg: "CMD_MUTE_AUDIO"はミュートの通知を表します
  trtcMeeting.sendRoomCustomMsg('CMD_MUTE_AUDIO', '1');
  // 受信側：カスタムメッセージの監視
  trtcMeeting.registerListener(onListener);
  onListener(TRTCMeetingDelegate type, param) {
      switch (type) {
          case TRTCMeetingDelegate.onRecvRoomCustomMsg:
              if (param['command'] == 'CMD_MUTE_AUDIO') {
                  // ミュートの通知を受信します
                  print(param['userName'] +'から' + 'のミュートの通知：' + param['message']'を受信');
                  trtcMeeting.muteLocalAudio(message == '1');
              }
              break;
      }
  }