Intégration du SDK Agora dans iOS

Mar 16 2023

Synchronisez les applications en temps réel pour la vidéo, le chat et plus encore avec le réseau mondial d'Agora.

Dans ce didacticiel, vous apprendrez à créer une application en temps réel où des groupes de personnes peuvent se connecter via un appel vidéo et même discuter. L'idée est de montrer comment la messagerie en temps réel avec Agora RTM peut être utilisée comme couche d'orchestration pour connecter les utilisateurs via de petits canaux de dérivation, où les utilisateurs peuvent créer ou rejoindre un appel vidéo existant à l'aide du moteur de communication en temps réel Agora.

Flux d'application

Le flux de l'application se déroule comme suit :

Appuyez sur un bouton "Rejoindre"
Ensuite, vous verrez plusieurs utilisateurs diffuser leurs vidéos sur la chaîne.
Appuyez maintenant sur "Hébergeur" en haut de l'écran pour être un diffuseur.
À ce stade, l'autorisation de la caméra et du microphone apparaîtra.
Retourner la caméra (entre caméra avant/arrière)
Activer/désactiver la caméra
Activer/désactiver le microphone
Activez le filtre d'embellissement, ce qui rend l'image plus fluide et rend également la voix du diffuseur plus claire.

SDK vidéo
SDK audio

Photo par Agora

Compte développeur Agora
Xcode 11.0 ou version ultérieure
Appareil iOS avec 13.0 ou version ultérieure
Une compréhension de base du développement iOS
Cosses De Cacao

Installation

Commencez par cliquer sur créer un projet iOS ou macOS dans Xcode.

Xcode a des problèmes pour télécharger de grandes bibliothèques telles que le SDK Agora. Si des erreurs s'affichent, vous pouvez ajouter un package rapide comme celui-ci . Dans Xcode, sélectionnez File > Swift Packages > Reset Package Caches .

Cosses De Cacao

Pour installer le CocoaPod, écrivez-le dans votre fichier pod AgoraUIKit_iOS avec la dernière version publiée, et votre Podfile devrait ressembler à ceci :

target 'Agora-UIKit-Project' do
  pod 'AgoraUIKit_iOS', '~> 4.0.3'
end

Exécutez pod installet ouvrez le fichier .xcworkspace pour commencer.

Ajoutez l'autorisation pour l'application d'utiliser la caméra et le microphone. Pour cela, ouvrez le fichier Info.plist à la racine de votre projet Xcode puis ajoutez NSCameraUsageDescription avec NSMicrophoneUsageDescription .

Pour plus d'informations sur la demande d'autorisation de capture multimédia, consultez cet article d'Apple .

Voyons comment ça se passe :

Ajout de flux vidéo

Si vous voulez un AgoraViewController, chargez simplement un flux ci-dessous dans votre contrôleur et l'ensemble du ViewController ressemblera à ceci :

Disposition en grille à gauche, disposition flottante à droite

Photo par Agora

C'est tout ce dont nous avons besoin lorsque nous utilisons Agora UIKit de manière basique. Cependant, les jetons ne sont pas pris en compte, et les jetons sont également requis dans les applications de production pour des raisons de sécurité.

Intégration de jeton

Plusieurs blogs et référentiels sont disponibles pour comprendre les jetons ; y compris un guide de configuration en 2 clics , un serveur de jetons prédéfini dans Golang et des informations sur la récupération d'un jeton dans votre application Swift .

Vous devrez définir un objet AgoraSettings. Attribuez ensuite la valeur dans l'URL du jeton, puis appliquez l'objet de paramètres lors de la création de votre objet AgoraVideoViewer.

Maintenant, chaque fois que vous vous connectez à un nouveau canal, il vous demandera une fetchTokenvaleur booléenne et la définira sur true :

Résumé

Créer une application de production à l'aide du réseau d'Agora pour les appels vidéo et le chat en temps réel est désormais plus facile que jamais. Les mêmes classes et méthodes fonctionneront également pour une application macOS.

En vous rendant sur le blog Advanced Agora UIKit , vous pouvez libérer tout le potentiel d'Agora UIKit pour iOS et macOS. De nombreuses autres personnalisations et améliorations peuvent être apportées à l'aide de cette bibliothèque.