Agora SDK-Integration in iOS

Mar 16 2023

Synchronisieren Sie Echtzeitanwendungen für Video, Chat und mehr mit dem globalen Netzwerk von Agora.

In diesem Tutorial erfahren Sie, wie Sie eine Echtzeitanwendung erstellen, in der Gruppen von Personen über einen Videoanruf miteinander in Kontakt treten und sogar chatten können. Die Idee besteht darin, zu zeigen, wie Echtzeit-Messaging mit Agora RTM als Orchestrierungsebene verwendet werden kann, um Benutzer über kleine Breakout-Kanäle zu verbinden, in denen Benutzer mithilfe der Agora-Echtzeit-Kommunikations-Engine einen Videoanruf erstellen oder daran teilnehmen können.

App-Flow

Der App-Ablauf läuft wie folgt ab:

Tippen Sie auf die Schaltfläche „Beitreten“.
Als Nächstes sehen Sie mehrere Benutzer, die ihre Videos auf dem Kanal übertragen.
Tippen Sie nun oben auf dem Bildschirm auf „Host“, um ein Sender zu werden.
An diesem Punkt werden die Kamera- und Mikrofonberechtigungen angezeigt.
Flip-Kamera (zwischen Vorder-/Rückkamera)
Schalten Sie die Kamera ein/aus
Schalten Sie das Mikrofon ein/aus
Schalten Sie den Verschönerungsfilter um, der das Bild glatter macht und auch die Stimme des Senders klarer macht.

Video-SDK
Audio-SDK

Foto von Agora

Agora-Entwicklerkonto
Xcode 11.0 oder höher
iOS-Gerät mit 13.0 oder höher
Ein grundlegendes Verständnis der iOS-Entwicklung
Kakaoschoten

Aufstellen

Klicken Sie zunächst auf „Erstellen eines iOS- oder macOS-Projekts in Xcode“.

Xcode hat Probleme beim Herunterladen großer Bibliotheken wie dem Agora SDK. Wenn Fehler angezeigt werden, können Sie ein Swift-Paket wie dieses hinzufügen. Wählen Sie in Xcode File > Swift Packages > Reset Package Caches aus .

Kakaoschoten

Um den CocoaPod zu installieren, schreiben Sie ihn mit der neuesten veröffentlichten Version in Ihre Pod-Datei AgoraUIKit_iOS . Ihre Pod-Datei sollte so aussehen:

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

Führen Sie aus pod installund öffnen Sie die .xcworkspace-Datei, um zu beginnen.

Fügen Sie der App die Berechtigung zur Nutzung der Kamera und des Mikrofons hinzu. Öffnen Sie dazu die Datei Info.plist im Stammverzeichnis Ihres Xcode-Projekts und fügen Sie dann NSCameraUsageDescription mit NSMicrophoneUsageDescription hinzu .

Weitere Informationen zum Anfordern einer Autorisierung für die Medienerfassung finden Sie in diesem Artikel von Apple .

Mal sehen, wie es weitergeht:

Video-Streaming hinzufügen

Wenn Sie einen AgoraViewController möchten, laden Sie einfach den folgenden Feed in Ihren Controller und der gesamte ViewController sieht folgendermaßen aus:

Rasterlayout links, schwebendes Layout rechts

Foto von Agora

Das ist alles, was erforderlich ist, wenn wir Agora UIKit auf einfache Weise verwenden. Dies wird jedoch nicht berücksichtigt, da Token aus Sicherheitsgründen auch in Produktionsanwendungen erforderlich sind.

Token-Integration

Zum Verständnis von Token stehen mehrere Blogs und Repositories zur Verfügung; einschließlich einer 2-Klick-Einrichtungsanleitung , eines vorgefertigten Token-Servers in Golang und Informationen zum Abrufen eines Tokens in Ihre Swift-App .

Sie müssen ein AgoraSettings-Objekt definieren. Weisen Sie dann den Wert in der Token-URL zu und wenden Sie dann das Einstellungsobjekt an, während Sie Ihr AgoraVideoViewer-Objekt erstellen.

Wenn Sie nun eine Verbindung zu einem neuen Kanal herstellen, werden Sie nach einem booleschen fetchTokenWert gefragt und dieser wird auf „true“ gesetzt:

Zusammenfassung

Das Erstellen einer Produktionsanwendung mithilfe des Agora-Netzwerks für Videoanrufe und Echtzeit-Chat ist jetzt einfacher als je zuvor. Dieselben Klassen und Methoden funktionieren auch für eine macOS-Anwendung.

Wenn Sie zum Advanced Agora UIKit-Blog gehen , können Sie das volle Potenzial von Agora UIKit für iOS und macOS ausschöpfen. Mit dieser Bibliothek können viele weitere Anpassungen und Verbesserungen vorgenommen werden.