最終更新日:2021-10-11 17:21:40

    このドキュメントでは、主にTRTC-API-Example(Android)をすばやく実行する方法について説明します。

    環境要件

    • 互換性のある最低バージョンはAndroid 4.1(SDK API Level 16)。Android 5.0(SDK API Level 21)およびそれ以降のバージョンの使用を推奨します。
    • Android Studio 3.5およびそれ以降のバージョン。
    • AppにはAndroid4.1およびそれ以降のデバイスが必要です。

    前提条件

    Tencent Cloudアカウントの登録を行い、実名認証が完了済みであること。

    操作手順

    ステップ1:新規アプリケーションの作成

    1. TRTCコンソールにログインし、【開発支援】>【快速跑通Demo】を選択します。
    2. 【アプリケーションの作成】をクリックして、 TestTRTCなどのアプリケーション名を入力します。すでにアプリケーションがある場合は、【既存のアプリケーションを選択】をクリックします。
    3. ビジネスのニーズに合わせてタグを追加または編集し、【作成する】をクリックします。
      説明:

      • アプリケーション名には、数字、中国語と英語の文字、アンダーラインのみを含めることができ、15文字以内とします。
      • タグは、Tencent Cloudのさまざまなリソースを識別および整理するのに役立ちます。例えば:企業に複数の事業部門があり、各部門に1つ以上のTRTCアプリケーションがある場合、TRTCアプリケーションにタグを追加することで部門情報にマークを付けることができます。タグは必須ではありません。実際のビジネスニーズに合わせてタグを追加または編集できます。

    ステップ2:SDKおよびTRTC-API-Exampleのソースコードのダウンロード

    1. 実際のビジネスニーズに合わせてSDKおよびTRTC-API-Exampleのソースコードをダウンロードします。
    2. ダウンロード完了後、【ダウンロード済み。次へ】をクリックします。

    ステップ3:TRTC-API-Exampleプログラムファイルの設定

    1. 設定変更画面に進み、ダウンロードしたソースコードパッケージに基づき、対応する開発環境を選択します。
    2. LiteAVSDK_TRTC_Androidバージョンナンバ/TRTC-API-Example/Debug/src/main/java/com/tencent/trtc/debug/GenerateTestUserSig.java ファイルを見つけて開きます。
    3. GenerateTestUserSig.javaファイル内の関連パラメータを設定します。
      • SDKAPPID:デフォルトはPLACEHOLDER、実際のSDKAppIDを設定してください。
      • SECRETKEY:デフォルトはPLACEHOLDER、実際のキー情報を設定してください。
    4. 貼り付け完了後、【貼り付けました。次へ】をクリックすれば、作成が完了します。
    5. コンパイル完了後、【コンソールの概要ページに戻る】をクリックすればOKです。
    注意:

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

    手順4:コンパイル動作

    Android Studio(3.5およびそれ以降のバージョン)を使用してソースプロジェクト TRTC-API-Exampleを開き、【実行】をクリックすればOKです。

    よくあるご質問

    1. キーをクエリーするとき、パブリックキーとプライベートキーの情報しか取得できませんが、キーはどうしたら取得できますか。

    TRTC SDK 6.6バージョン(2019年08月)では新しい署名アルゴリズムのHMAC-SHA256の使用を始めています。その前に作成済のアプリケーションは、署名アルゴリズムをアップグレードしないと暗号化したキーを取得できません。アップグレードしなくても、旧バージョンアルゴリズム ECDSA-SHA256は引き続き使用できます。アップグレード済みなら、必要に応じて新旧アルゴリズムに切り替えます。

    アップグレード/切替の操作:

    1. Tencent Real-Time Communicationコンソールにログインします。
    2. 左側ナビゲーションバーで【アプリケーション管理】を選択し、ターゲットアプリケーションのある行の【アプリケーション情報】をクリックします。
      3.【クイックスタート】タブを選択して【ステップ2 UserSigを発行するためのキーを取得】エリアの【ここをクリックしてアップグレード】、【非対称暗号化】または【HMAC-SHA256】をクリックします。
      • アップグレード。
      • 旧バージョンアルゴリズムの ECDSA-SHA256に切り替えます。
      • 新バージョンアルゴリズムのHMAC-SHA256に切り替えます。

    2. 2台の携帯電話で同時にAppを実行しているのに、お互いの画面が表示されないのはなぜですか。

    2台の携帯電話でAppを操作するとき、UserIDが異なるものを使用してください。TRTCでは、同一のUserID(SDKAppIDが異なる場合を除く)が2つの端末で同時に使用することをサポートしていません。

    3. ファイアウォールにはどのような制限がありますか。

    SDK が UDP プロトコルを使用してオーディオビデオ伝送を行っていることから、 UDPに対してブロックがあるオフィスネットワークでは使用することができません。類似の問題があれば、 企業ファイアウォール制限の対応をご参照の上、問題原因を調べ解決してください。