iOS - ApsaraVideo Live: Central de Documentação do Alibaba Cloud

Execute rapidamente o projeto de exemplo do ARTC para experimentar os recursos de áudio e vídeo em tempo real.

Baixe o código-fonte de exemplo

A Alibaba Cloud disponibiliza um projeto de exemplo open source que demonstra o uso da API do ARTC SDK para facilitar o entendimento e a integração dos recursos do SDK. Consulte o repositório do projeto de exemplo para iOS.

Pré-requisitos

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

Ferramenta de desenvolvimento: Xcode 14.0 ou superior. Sempre que possível, utilize a versão estável mais recente.
Configuração recomendada: CocoaPods 1.9.3 ou superior.
Dispositivo de teste: dispositivo físico iOS com iOS 9.0 ou superior.

Nota

Utilize um dispositivo físico para testes. Simuladores podem não oferecer suporte a determinados recursos.

Rede: conexão de rede estável.
Configuração do aplicativo: obtenha o AppID e a AppKey do seu aplicativo ApsaraVideo Real-time Communication. Para mais informações, consulte Criar aplicativo.

Procedimento

Etapa 1: Obter o projeto de exemplo

Clone o projeto de exemplo do ARTC para sua máquina local:

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

Nota

Este repositório contém projetos de exemplo para diversas plataformas nativas que utilizam o ARTC SDK. O projeto de exemplo para iOS está na pasta iOS/.

O projeto de exemplo inclui código client-side para geração de tokens e facilitar seus testes.

A estrutura de arquivos do projeto iOS/ARTCExample é descrita abaixo.

├── iOS                         // Root directory of the iOS project
│   ├── ARTCExample                // API example source code
│       ├── Common                      // Common modules
│           ├── ARTCTokenHelper.swift       // Set AppId, AppKey, and other info
│           ├── ...                         // Other files
│       ├── QuickStart                  // Quick-start modules
│           ├── TokenGenerate               // Token generation and channel join
│           ├── VideoCall                   // Quick implementation of video calls
│           ├── VoiceChat                   // Quick implementation of chat rooms
│       ├── BasicUsage                  // Basic features
│           ├── AudioBasicUsage             // Common audio operations and settings
│           ├── VideoBasicUsage             // Common video operations and settings
│           ├── CameraCommonSetting         // Standard camera settings
│           ├── SEIUsage                    // Send and receive SEI messages
│           ├── DataChannelMessage          // Send and receive custom messages
│           ├── ScreenShare                 // Screen sharing
│           ├── StreamMonitoring            // Monitor stream quality during calls
│           ├── PlayAudioFiles              // Play background music and sound effects
│       ├── AdvancedUsage               // Advanced features
│           ├── ProcessAudioRawData         // Raw audio data
│           ├── ProcessVideoRawData         // Raw video data
|           |—— CustomAudioCapture          // Custom audio capture
|           |—— CustomAudioRender           // Custom audio playback
|           |—— CustomVideoCapture          // Custom video capture
|           |—— CustomVideoRender           // Custom video rendering
│           ├── CustomVideoProcess          // Custom video processing
|           |—— PreJoinChannelTest          // Network and device detection before joining
|           |—— PictureInPicture            // Picture-in-Picture (PiP)
|           |—— H265                        // H.265 encoding
|           |—— IntelligentDenoise          // Smart noise reduction
|           |—— LocalRecord                 // Local recording
│       ├── Setting                     // Settings module
│       ├── ...                         // Other project files
│   ├── ARTCExample.xcodeproj        // Demo project file
│   ├── ARTCExample.xcworkspace      // Demo workspace file
│   ├── Podfile                      // Demo Podfile

Etapa 2: Configurar o projeto de exemplo

Após baixar o código-fonte, abra a pasta iOS.
Na pasta iOS, execute o comando “pod install --repo-update” para instalar automaticamente as dependências necessárias do SDK.
Abra o arquivo de projeto ARTCExample.xcworkspace.
Configure o AppID e a AppKey do ApsaraVideo Real-time Communication.

Abra o arquivo iOS/ARTCExample/Common/ARTCTokenHelper.swift e insira o AppID e a AppKey obtidos no console.

// ARTCTokenHelper.swift
class ARTCTokenHelper: NSObject {
    /**
     * RTC AppId
     */
    public static let AppId = "<ApsaraVideo Real-time Communication AppID>"
    /**
     * RTC AppKey
     */
    public static let AppKey = "<ApsaraVideo Real-time Communication AppKey>"
    
    ...
}

Etapa 3: Compilar e executar o projeto de exemplo

Selecione o target "ARTCExample", conecte um dispositivo físico e compile o projeto.
Execute o aplicativo para testar os exemplos de API.

Execute o demo em um dispositivo físico e clique em Implement video call.

Conecte dois dispositivos ao mesmo canal.

Insira o mesmo ChannelID (por exemplo, 111) na interface do aplicativo e clique em Enter room.

Inicie a chamada de áudio e vídeo em tempo real.

Próximas etapas

Para integrar o ARTC SDK ao seu próprio projeto, consulte Implementar chamadas de vídeo no iOS.