Tous les produits
Search
Centre de documentation

ApsaraVideo Live:Android

Dernière mise à jour :Aug 20, 2026

Exécutez le projet de démonstration ARTC pour tester les fonctionnalités d'ApsaraVideo Real-time Communication (ARTC).

Code source de la démo

Alibaba Cloud propose un projet de démonstration open source qui illustre l'utilisation des API du SDK ARTC et facilite l'intégration des fonctionnalités du SDK. Téléchargez le projet depuis le dépôt du projet de démonstration Android.

Prérequis

Avant d'exécuter le projet de démonstration, vérifiez que votre environnement de développement répond aux exigences suivantes :

  • Outil de développement : Android Studio 2020.3.1 ou version ultérieure.

    • Configuration recommandée : Android Studio 2024.1.2 ou version ultérieure, Android Gradle Plugin (AGP) 8.6.0, Gradle 8.7 et JDK 17.

      Remarque

      Les versions antérieures d'Android Studio peuvent présenter des problèmes de compatibilité avec AGP. En cas d'échec de la compilation, rétrogradez les versions d'AGP, de Gradle et de JDK. Pour plus d'informations, consultez la page Compatibilité entre Android Studio et AGP.

  • Appareil de test : Un appareil exécutant Android 5.0 (niveau d'API SDK 21) ou version ultérieure.

    Remarque

    Nous vous recommandons d'effectuer les tests sur un appareil physique. Un émulateur peut ne pas prendre en charge toutes les fonctionnalités.

  • Environnement réseau : Une connexion Internet stable.

  • Préparation de l'application : Obtenez un AppID et une AppKey pour votre application ApsaraVideo Real-time Communication. Pour plus d'informations, consultez la rubrique Créer une application.

Procédure

Étape 1 : Obtenir le projet de démonstration

Clonez le projet de démonstration ARTC sur votre machine locale :

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

Ce dépôt contient des projets de démonstration pour le SDK ARTC sur plusieurs plateformes natives. Le projet de démonstration Android se trouve dans le répertoire Android/ARTCExample.

Le projet de démonstration inclut du code de génération de jeton côté client à des fins de test.

La section suivante décrit la structure des fichiers du projet Android/ARTCExample.

├── Android       		       // Root directory of the Android project
│   ├── ARTCExample            // API Example project directory
│       ├── app                // Demo entry point
│       ├── KeyCenter          // AppID, AppKey, and other information
│           ├── keycenter      // Set AppID, AppKey, and other information
│       ├── quickstart         // Quick start module
│           ├── TokenGenerate  // Token generation and joining a channel
│           ├── VideoCall      // Quickly implement an audio and video call
│           ├── VoiceChat      // Quickly implement a voice chat room
│       ├── BasicUsage          // Basic features module
│           ├── AudioBasicUsage  // Common audio operations and configuration
│           ├── VideoBasicUsage // Common video operations and configuration
│           |—— CameraCommonControl // Common camera configuration
│           |—— SEIUsage         // SEI message sending and receiving
│           |—— DataChannelMessage // Custom message sending and receiving
│           |—— ScreenShare  // Screen sharing
│           |—— StreamMonitoring // In-call stream quality monitoring  
            |—— PlayAudioFiles    // Play background music and sound effects
        |—— AdvancedUsage // Advanced features module
            |—— ProcessAudioRawData // Raw audio data
            |—— ProcessVideoRawData // Raw video data
            |—— CustomAudioCaptureAndRender // Custom audio capture and rendering
            |—— CustomVideoCaptureAndRender // Custom video capture and rendering
            |—— PreJoinChannelTest // Pre-join channel test (device + network)
            |—— PictureInPicture // Picture-in-Picture
            |—— H265 // H.265 encoding
            |—— IntelligentDenoise // Intelligent noise reduction
            |—— LocalRecord     // Local recording
│       ├── build.gradle  
│       └── settings.gradle

Étape 2 : Configurer le projet de démonstration

  1. Ouvrez le dossier Android/ARTCExample dans Android Studio.

  2. Configurez l'AppID et l'AppKey du projet : ouvrez le fichier Android/ARTCExample/KeyCenter/src/main/java/com/aliyun/artc/api/keycenter/ARTCTokenHelper.java, puis saisissez l'AppID et l'AppKey obtenus depuis la console.

// ARTCTokenHelper.java
// ApsaraVideo Real-time Communication AppID
private static String AppId = "<Your AppID>";
// ApsaraVideo Real-time Communication AppKey
private static String AppKey = "<Your AppKey>";

Étape 3 : Compiler et exécuter le projet de démonstration

Activez les options pour les développeurs sur votre appareil de test Android, connectez l'appareil à votre ordinateur et sélectionnez-le dans Android Studio.

  1. Dans Android Studio, cliquez sur Sync Project with Gradle Files.

  2. Une fois la synchronisation réussie, cliquez sur Run 'app'. L'application ARTCExample s'installe alors sur votre appareil.

Exécutez la démo sur un appareil physique, puis appuyez sur Video Call.

Rejoignez le même canal sur deux appareils.

Dans le champ ChannelID, saisissez le même ID de canal (par exemple, 666), puis appuyez sur JOIN CHANNEL.

L'appel audio et vidéo en temps réel commence.

image

Étapes suivantes

Intégrez le SDK ARTC à votre projet. Pour plus d'informations, consultez la rubrique Implémenter un appel audio et vidéo sur Android.