Android 用 ARTC デモプロジェクトの実行 - ApsaraVideo Live - Alibaba Cloud ドキュメントセンター

このトピックでは、ApsaraVideo Real-time Communication（ARTC）のデモプロジェクトを実行して、Android で ARTC 機能を試す方法について説明します。

ソースコードをダウンロードする

ApsaraVideo Live は、ARTC SDK の API 使用法を示すオープンソースのサンプルプロジェクトを提供し、開発者が ARTC 機能を理解して統合するのに役立ちます。ソースコードをダウンロードするには、GitHub リポジトリにアクセスしてください。

環境要件

デモプロジェクトを実行する前に、開発環境が次の要件を満たしていることを確認してください。

開発ツール: Android Studio 2020.3.1 以降。
- 推奨: Android Studio 2024.1.2 以降、Android Gradle Plugin (AGP) バージョン 8.6.0、Gradle バージョン 8.7、JDK 17。
  説明
  以前のバージョンの Android Studio を使用すると、AGP との互換性の問題が発生する可能性があります。コンパイルに失敗した場合は、AGP、Gradle、および JDK のバージョンをダウングレードしてください。詳細については、「Android Gradle プラグインと Android Studio の互換性」をご参照ください。
テストデバイス: Android 5.0 (API レベル 21) 以降を実行しているデバイス。
説明
エミュレータはすべての機能をサポートしていない可能性があるため、テストには物理デバイスを使用することをお勧めします。
ネットワーク: 安定したインターネット接続。
アプリケーションの設定: ARTC アプリケーションの AppID と AppKey を取得します。

手順

ステップ 1: デモプロジェクトを取得する

ARTC デモプロジェクトをローカルデバイスにクローンします。

git clone https://github.com/MediaBox-Demos/amdemos-artc

説明

このリポジトリには、複数のネイティブプラットフォーム用のデモプロジェクトが含まれています。 Android デモプロジェクトは、Android/ARTCExample ディレクトリにあります。

デモプロジェクトには、クライアント側でトークンを生成するためのコードが含まれています。これは、デモとテストの目的でのみ使用されます。本番環境では、AppKey を保護するために、安全なサーバーでトークンを生成する必要があります。

Android/ARTCExample プロジェクトのファイル構造:

├── Android       		       // Android プロジェクトのルートディレクトリ
│   ├── ARTCExample            // API サンプルのメインプロジェクト
│       ├── app                // デモアプリ
│       ├── KeyCenter          // AppId と AppKey の設定
│           ├── keycenter      // AppId と AppKey を設定
│       ├── quickstart         // クイックスタートモジュール
│           ├── TokenGenerate  // トークンを生成してチャンネルに参加
│           ├── VideoCall      // ビデオ通話を実装
│           ├── VoiceChat      // 音声チャットルームを実装
│       ├── BasicUsage          // 基本機能モジュール
│           ├── AudioBasicUsage  // 一般的な音声操作と設定
│           ├── VideoBasicUsage // 一般的な映像操作と設定
│           |—— CameraCommonControl // 一般的なカメラコントロール
│           |—— SEIUsage         // SEI メッセージの送受信
│           |—— DataChannelMessage // カスタムメッセージの送受信
│           |—— ScreenShareUsage  // 画面共有
│           |—— StreamMonitoring // 通話中のストリーム品質モニタリング
            |—— PlayAudioFiles    // 音声伴奏と効果音の再生
        |—— AdvancedUsage // 高度な機能モジュール
            |—— ProcessAudioRawData // 音声のローデータ処理
            |—— ProcessVideoRawData // 映像のローデータ処理
            |—— CustomAudioCaptureAndRender // 音声のカスタムキャプチャとレンダリング
            |—— CustomVideoCaptureAndRender // 映像のカスタムキャプチャとレンダリング
            |—— PreJoinChannelTest // チャンネル参加前のデバイスとネットワーク品質テスト
            |—— PictureInPicture // ピクチャーインピクチャー
            |—— H265 // H.265 コーデック         
            |—— IntelligentDenoise // インテリジェントノイズリダクション            
            |—— LocalRecord     // ローカル録画           
│       ├── build.gradle  
│       └── settings.gradle

ステップ 2: デモプロジェクトを構成する

Android Studio で Android/ARTCExample ディレクトリを開きます。
プロジェクトの AppID と AppKey を構成します。Android/ARTCExample/KeyCenter/src/main/java/com/aliyun/artc/api/keycenter/ARTCTokenHelper.java ファイルに移動し、ApsaraVideo Live コンソールから取得した AppID と AppKey を入力します。

// ARTCTokenHelper.java
// ARTC アプリケーションの AppID
private static String AppId = "<AppID>";
// ARTC アプリケーションの AppKey
private static String AppKey = "<AppKey>";

ステップ 3: デモプロジェクトをコンパイルして実行する

Android テストデバイスで開発者向けオプションを有効にし、ローカルデバイスに接続します。 Android Studio で、使用可能なデバイスのリストからデバイスを選択します。

Android Studio で、[ Gradle ファイルとプロジェクトを同期] をクリックします。
同期が成功したら、[ app を実行] をクリックしてプロジェクトをコンパイルします。ビルドが完了すると、ARTCExample アプリケーションがデバイスにインストールされます。

テストデバイスで、アプリケーションを開き、[ビデオ通話] をタップしてこの機能をテストします。

ビデオ通話をテストするには、同じチャネル ID を使用して 2 つのデバイスで通話に参加します。

通話が開始され、両方のデバイスからのビデオストリームが表示されます。