Agora UIKit for iOS and macOS
Instantly integrate Agora in your own application or prototype using iOS or macOS.
- Either an iOS device with 12.0 or later
- Or a macOS computer with 10.14 or later
- Xcode 11 or later
- An Agora developer account
Once you have an Agora developer account and an App ID, you're ready to use this pod.
In your iOS or macOS project, add this pod to your repository by adding a file named
Podfile, with contents similar to this:
# Uncomment the next line to define a global platform for your project # platform :ios, '12.0' target 'Agora-UIKit-Example' do # Comment the next line if you don't want to use dynamic frameworks use_frameworks! # Uncomment the next line if you want to install for iOS # pod 'AgoraUIKit_iOS', '~> 1.0' # Uncomment the next line if you want to install for macOS # pod 'AgoraUIKit_macOS', '~> 1.0' end
And then install the pods using
pod install --repo-update
If any of these steps are unclear, look at "Using Cocoapods" on cocoapods.org. The installation will change slightly once this pod is out of pre-release.
Once installed, open your application
Decide where you want to add your
AgoraVideoViewer, and in the same file import
Agora_AppKit for iOS and macOS respectively.
Next, create an
AgoraVideoViewer object and frame it in your scene like you would any other
AgoraVideoViewer object must be provided
AgoraConnectionData and a UIViewController/NSViewController on creation.
AgoraConnectionData has two values for initialising. These are appId and appToken.
AgoraVideoViewer can be created like this:
import AgoraUIKit_iOS let agoraView = AgoraVideoViewer( connectionData: AgoraConnectionData( appId: "my-app-id">, appToken: "my-channel-token" ), style: .grid, delegate: self )
An alternative style is
.floating, as seen in the image above.
To join a channel, simply call:
agoraView.join(channel: "test", as: .broadcaster)
For full documentation, see our AgoraUIKit documentation page.