Menjalankan proyek demo ARTC untuk Android - ApsaraVideo Live

Topik ini menjelaskan cara menjalankan proyek demo ApsaraVideo Real-time Communication (ARTC) untuk mencoba fitur ARTC di Android.

Unduh kode sumber

ApsaraVideo Live menyediakan proyek contoh open-source yang menunjukkan penggunaan API ARTC SDK untuk membantu pengembang memahami dan mengintegrasikan fitur ARTC. Untuk mengunduh kode sumber, kunjungi repositori GitHub.

Persyaratan lingkungan

Sebelum menjalankan proyek demo, pastikan lingkungan pengembangan Anda memenuhi persyaratan berikut:

Alat pengembangan: Android Studio 2020.3.1 atau versi lebih baru.
- Disarankan: Android Studio 2024.1.2 atau yang lebih baru, versi Android Gradle Plugin (AGP) 8.6.0, Gradle versi 8.7, JDK 17.
  Catatan
  Menggunakan versi Android Studio yang lebih lama dapat menyebabkan masalah kompatibilitas dengan AGP. Jika Anda mengalami kegagalan kompilasi, turunkan versi AGP, Gradle, dan JDK Anda. Untuk informasi lebih lanjut, lihat Kompatibilitas Android Gradle Plugin dan Android Studio.
Perangkat uji: Perangkat yang menjalankan Android 5.0 (API Level 21) atau versi lebih baru.
Catatan
Kami merekomendasikan menggunakan perangkat fisik untuk pengujian karena emulator mungkin tidak mendukung semua fitur.
Jaringan: Koneksi Internet yang stabil.
Pengaturan aplikasi: Dapatkan AppID dan AppKey dari aplikasi ARTC.

Prosedur

Langkah 1: Dapatkan proyek demo

Kloning proyek demo ARTC ke perangkat lokal Anda:

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

Catatan

Repositori ini berisi proyek demo untuk beberapa platform asli. Proyek demo Android terletak di direktori Android/ARTCExample.

Proyek demo mencakup kode untuk menghasilkan token di sisi klien. Ini hanya untuk demonstrasi dan tujuan pengujian. Di lingkungan produksi, token harus dihasilkan di server aman untuk melindungi AppKey Anda.

Struktur file proyek Android/ARTCExample:

├── Android       		       // Direktori root untuk proyek Android
│   ├── ARTCExample            // Proyek utama untuk contoh penggunaan API
│       ├── app                // Aplikasi demo
│       ├── KeyCenter          // Konfigurasi AppId dan AppKey
│           ├── keycenter      // Mengatur AppId dan AppKey Anda
│       ├── quickstart         // Modul quick start
│           ├── TokenGenerate  // Menghasilkan token dan bergabung ke channel
│           ├── VideoCall      // Mengimplementasikan panggilan video
│           ├── VoiceChat      // Mengimplementasikan ruang obrolan suara
│       ├── BasicUsage          // Modul fitur dasar
│           ├── AudioBasicUsage  // Operasi dan konfigurasi audio umum
│           ├── VideoBasicUsage // Operasi dan konfigurasi video umum
│           |—— CameraCommonControl // Kontrol kamera umum
│           |—— SEIUsage         // Pengiriman dan penerimaan pesan SEI
│           |—— DataChannelMessage // Pengiriman dan penerimaan pesan kustom
│           |—— ScreenShareUsage  // Berbagi layar
│           |—— StreamMonitoring // Pemantauan kualitas aliran selama panggilan
            |—— PlayAudioFiles    // Memutar iringan audio dan efek suara
        |—— AdvancedUsage // Modul fitur lanjutan
            |—— ProcessAudioRawData // Pemrosesan data audio mentah
            |—— ProcessVideoRawData // Pemrosesan data video mentah
            |—— CustomAudioCaptureAndRender // Capture dan rendering audio kustom
            |—— CustomVideoCaptureAndRender // Capture dan rendering video kustom
            |—— PreJoinChannelTest // Uji kualitas perangkat dan jaringan sebelum bergabung ke channel
            |—— PictureInPicture // Picture-in-Picture
            |—— H265 // Kodek H.265         
            |—— IntelligentDenoise // Reduksi noise cerdas            
            |—— LocalRecord     // Perekaman lokal           
│       ├── build.gradle  
│       └── settings.gradle

Langkah 2: Konfigurasikan proyek demo

Buka direktori Android/ARTCExample di Android Studio.
Konfigurasikan AppID dan AppKey proyek: Navigasikan ke file Android/ARTCExample/KeyCenter/src/main/java/com/aliyun/artc/api/keycenter/ARTCTokenHelper.java dan masukkan AppID dan AppKey yang diperoleh dari konsol ApsaraVideo Live.

// ARTCTokenHelper.java
// AppID dari aplikasi ARTC Anda
private static String AppId = "<AppID>";
// AppKey dari aplikasi ARTC Anda
private static String AppKey = "<AppKey>";

Langkah 3: Kompilasi dan jalankan proyek demo

Aktifkan Opsi Pengembang di perangkat uji Android Anda dan sambungkan ke perangkat lokal Anda. Pilih perangkat Anda dari daftar perangkat yang tersedia di Android Studio.

Di Android Studio, klik Sinkronkan Proyek dengan File Gradle.
Setelah sinkronisasi berhasil, klik Jalankan 'app' untuk mengkompilasi proyek. Saat pembuatan selesai, aplikasi ARTCExample akan terinstal di perangkat Anda.

Di perangkat uji, buka aplikasi dan ketuk Video Call untuk menguji fitur ini.

Untuk menguji panggilan video, gunakan ID saluran yang sama untuk bergabung dalam panggilan di dua perangkat.

Panggilan dimulai, dan Anda dapat melihat aliran video dari kedua perangkat.