Agora SDK Integrazione in iOS

Mar 16 2023

Sincronizza le applicazioni in tempo reale per video, chat e altro con la rete globale di Agora.

In questo tutorial imparerai come creare un'applicazione in tempo reale in cui gruppi di persone possono connettersi tramite una videochiamata e persino chattare. L'idea è mostrare come la messaggistica in tempo reale con Agora RTM può essere utilizzata come livello di orchestrazione per connettere gli utenti attraverso piccoli canali di breakout, in cui gli utenti possono creare o partecipare a una videochiamata esistente utilizzando il motore di comunicazione in tempo reale Agora.

Flusso dell'app

Il flusso dell'app è il seguente:

Tocca un pulsante "Partecipa".
Successivamente, vedrai più utenti che trasmettono i loro video sul canale.
Ora tocca "Host" nella parte superiore dello schermo per essere un emittente.
A questo punto compariranno i permessi per fotocamera e microfono.
Flip camera (tra fotocamera anteriore/posteriore)
Attiva/disattiva la fotocamera
Attiva/disattiva il microfono
Attiva o disattiva il filtro di abbellimento, che rende l'immagine più fluida e rende anche più chiara la voce dell'emittente.

SDK video
SDK audio

Foto di Agorà

Account sviluppatore Agorà
Xcode 11.0 o successivo
Dispositivo iOS con 13.0 o successivo
Una conoscenza di base dello sviluppo iOS
Cialde Di Cacao

Impostare

Inizia facendo clic sulla creazione di un progetto iOS o macOS in Xcode.

Xcode ha problemi a scaricare librerie di grandi dimensioni come Agora SDK. Se vengono visualizzati errori, puoi aggiungere un pacchetto swift come questo . In Xcode selezionare File > Swift Packages > Reset Package Caches .

Cialde Di Cacao

Per installare CocoaPod, scrivilo nel tuo file pod AgoraUIKit_iOS con l'ultima versione rilasciata e il tuo Podfile dovrebbe assomigliare a questo:

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

Esegui pod installe apri il file .xcworkspace per iniziare.

Aggiungi l'autorizzazione all'app per l'utilizzo della fotocamera e del microfono. Per questo, apri il file Info.plist nella radice del tuo progetto Xcode e quindi aggiungi NSCameraUsageDescription con NSMicrophoneUsageDescription .

Per ulteriori informazioni sulla richiesta di autorizzazione per l'acquisizione di contenuti multimediali, consulta questo articolo di Apple .

Vediamo come va:

Aggiunta dello streaming video

Se vuoi un AgoraViewController, carica semplicemente un feed sottostante nel tuo controller e l'intero ViewController avrà questo aspetto:

Layout a griglia a sinistra, layout mobile a destra

Foto di Agorà

Questo è tutto ciò che è richiesto quando usiamo Agora UIKit in modo basilare. Tuttavia, questo non viene preso in considerazione dai token e anche i token sono richiesti nelle app di produzione per motivi di sicurezza.

Integrazione token

Sono disponibili diversi blog e repository per comprendere i token; inclusa una guida all'installazione in 2 clic , un server di token predefinito in Golang e informazioni sul recupero di un token nella tua app Swift .

Dovrai definire un oggetto AgoraSettings. Quindi assegna il valore nell'URL del token e quindi applica l'oggetto delle impostazioni durante la creazione dell'oggetto AgoraVideoViewer.

Ora, ogni volta che ti connetti a un nuovo canale, chiederà un fetchTokenvalore booleano e lo imposterà su true:

Riepilogo

La creazione di un'applicazione di produzione utilizzando la rete di Agora per le videochiamate e la chat in tempo reale è ora più facile che mai. Le stesse classi e metodi funzioneranno anche per un'applicazione macOS.

Andando al blog Advanced Agora UIKit , puoi sbloccare tutto il potenziale di Agora UIKit per iOS e macOS. Molte altre personalizzazioni e miglioramenti possono essere apportati utilizzando questa libreria.