Tous les produits
Search
Centre de documentation

ApsaraVideo Live:iOS

Dernière mise à jour :Aug 20, 2026

Exécutez rapidement le projet d'exemple ARTC pour découvrir les fonctionnalités audio et vidéo en temps réel.

Télécharger le code source de l'exemple

Alibaba Cloud met à disposition un projet d'exemple open source qui illustre l'utilisation des API du SDK ARTC, afin de vous aider à comprendre et à intégrer les fonctionnalités du SDK. Consultez le dépôt du projet d'exemple iOS.

Prérequis

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

  • Outil de développement : Xcode 14.0 ou version ultérieure. Utilisez de préférence la dernière version stable.

  • Configuration recommandée : CocoaPods 1.9.3 ou version ultérieure.

  • Appareil de test : Un appareil iOS physique exécutant iOS 9.0 ou version ultérieure.

Remarque

Effectuez les tests sur un appareil physique. Les simulateurs peuvent ne pas prendre en charge certaines fonctionnalités.

  • Réseau : Une connexion réseau stable est requise.

  • Configuration de l'application : Obtenez l'AppID et l'AppKey de votre application ApsaraVideo Real-time Communication. Pour plus d'informations, consultez Créer une application.

Procédure

Étape 1 : Obtenir le projet d'exemple

Clonez le projet d'exemple ARTC sur votre machine locale :

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

Ce dépôt contient des projets d'exemples pour plusieurs plateformes natives utilisant le SDK ARTC. Le projet d'exemple iOS se trouve dans le dossier iOS/.

Le projet d'exemple inclut du code côté client pour générer des jetons, ce qui facilite les tests.

La structure de fichiers du projet iOS/ARTCExample est présentée ci-dessous.

├── 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

Étape 2 : Configurer le projet d'exemple

  1. Après avoir téléchargé le code source, ouvrez le dossier iOS.

  2. Dans le dossier iOS, exécutez la commande « pod install --repo-update » pour installer automatiquement les dépendances SDK requises.

  3. Ouvrez le fichier de projet ARTCExample.xcworkspace.

  4. Configurez l'AppID et l'AppKey de votre application ApsaraVideo Real-time Communication.

    Ouvrez le fichier iOS/ARTCExample/Common/ARTCTokenHelper.swift et saisissez l'AppID et l'AppKey obtenus depuis la 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>"
    
    ...
}

Étape 3 : Compiler et exécuter le projet d'exemple

  • Sélectionnez la cible « ARTCExample », connectez un appareil physique et compilez le projet.

  • Exécutez l'application pour tester les exemples d'API.

Exécutez la démo sur un appareil physique et cliquez sur Implement video callImplement video call.

Faites rejoindre le même canal par deux appareils.

Saisissez le même ChannelID (par exemple, 111) dans l'interface de l'application et cliquez sur Enter room.

Démarrez l'appel audio et vidéo en temps réel.

Étapes suivantes

Pour intégrer le SDK ARTC à votre propre projet, consultez Implémenter des appels vidéo sur iOS.