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.
NotaVersõ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.
NotaRecomendamos 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
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
Abra a pasta
Android/ARTCExampleno Android Studio.Configure o AppID e a AppKey do projeto: abra o arquivo
Android/ARTCExample/KeyCenter/src/main/java/com/aliyun/artc/api/keycenter/ARTCTokenHelper.javae 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.
No Android Studio, clique em Sync Project with Gradle Files.
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, |
A chamada de áudio e vídeo em tempo real é iniciada.
|
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.
