Todos os produtos
Search
Central de documentação

ApsaraVideo Live:Android

Última atualização: Jun 30, 2026

Execute o projeto de demonstração do ARTC para experimentar os recursos do ApsaraVideo Real-time Communication (ARTC).

Código-fonte da demonstração

A Alibaba Cloud disponibiliza um projeto de demonstração open source que ilustra o uso da API do SDK do ARTC e facilita a integração dos seus recursos. Baixe o projeto no repositório do projeto de demonstração para Android.

Pré-requisitos

Antes de executar o projeto de demonstração, verifique se o seu ambiente de desenvolvimento atende aos seguintes requisitos:

  • Ferramenta de desenvolvimento: Android Studio 2020.3.1 ou superior.

    • Configuração recomendada: Android Studio 2024.1.2 ou superior, Android Gradle Plugin (AGP) 8.6.0, Gradle 8.7 e JDK 17.

      Nota

      Versões anteriores do Android Studio podem apresentar problemas de compatibilidade com o AGP. Caso enfrente falhas de build, faça o downgrade das versões do AGP, Gradle e JDK conforme necessário. Para mais informações, consulte Compatibilidade entre Android Studio e AGP.

  • Dispositivo de teste: Um dispositivo de teste com Android 5.0 (SDK API Level 21) ou superior.

    Nota

    Recomendamos testar em um dispositivo físico. O emulador pode não oferecer suporte a todos os recursos.

  • Ambiente de rede: Uma conexão estável com a internet.

  • Preparação do aplicativo: Obtenha um AppID e uma AppKey para o seu aplicativo ApsaraVideo Real-time Communication. Para mais informações, consulte Criar um aplicativo.

Procedimento

Etapa 1: Obter o projeto de demonstração

Clone o projeto de demonstração do ARTC para sua máquina local:

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

Este repositório contém projetos de demonstração do SDK do ARTC para diversas plataformas nativas. O projeto de demonstração para Android está localizado no diretório Android/ARTCExample.

O projeto de demonstração inclui código de geração de token no lado do cliente para fins de teste.

A seção a seguir descreve a estrutura de arquivos do projeto 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

Etapa 2: Configurar o projeto de demonstração

  1. Abra a pasta Android/ARTCExample no Android Studio.

  2. Configure o AppID e a AppKey do projeto: abra o arquivo Android/ARTCExample/KeyCenter/src/main/java/com/aliyun/artc/api/keycenter/ARTCTokenHelper.java e insira o AppID e a AppKey obtidos no 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>";

Etapa 3: Compilar e executar o projeto de demonstração

Ative as Opções do Desenvolvedor no seu dispositivo de teste Android, conecte-o ao computador e selecione o dispositivo no Android Studio.

  1. No Android Studio, clique em Sync Project with Gradle Files.

  2. Após a sincronização bem-sucedida, clique em Run 'app'. Quando o build for concluído com sucesso, o aplicativo ARTCExample será instalado no seu dispositivo.

Execute a demonstração em um dispositivo físico e toque em Video Call.

Entre no mesmo canal em dois dispositivos.

No campo ChannelID, insira o mesmo ID de canal (por exemplo, 666) e toque em JOIN CHANNEL.

A chamada de áudio e vídeo em tempo real é iniciada.

image

Próximas etapas

Integre o SDK do ARTC ao seu projeto. Para mais informações, consulte Implementar uma chamada de áudio e vídeo no Android.