markdown-body entry-content container-lg" itemprop="text">

Agora Video UI Kit for iOS

Instantly integrate Agora in your own application or prototype using iOS. For macOS, see VideoUIKit-macOS.

More information available on this repo's Wiki

To see full documentation for other packages in this repo, such as AgoraBroadcastExtensionHelper, AgoraAppGroupDataHelper or AgoraRtmControl, check them out here:

Requirements

iOS 13.0+ or a macOS 10.15 or later
Xcode 12.3 or later
CocoaPods (if installing with CocoaPods)
An Agora developer account

Once you have an Agora developer account and an App ID, you're ready to use this package.

Installation

Swift Package Manager and CocoaPods are both available offered for installation methods.

The Pod for this package is called AgoraUIKit_iOS and AgoraUIKit_macOS for the two available platforms.

See the Installation wiki page for more information on installing the package.

Usage

Once installed, open your application .xcodeproj file. Or .xcworkspace if using CocoaPods.

The main view for Agora UIKit is AgoraVideoViewer. This is an example of a minimal creation that gives you a view similar to the one at the top of this README:

import AgoraRtcKit
import AgoraUIKit

let agoraView = AgoraVideoViewer(
    connectionData: AgoraConnectionData(
        appId: "<#my-app-id#>",
        rtcToken: "<#my-channel-token#>",
        rtmToken: "<#my-channel-rtm-token#>"
    ), delegate: self
)

Frame your newly created AgoraVideoViewer in the app scene, then join a channel by calling:

agoraView.join(channel: "test", as: .broadcaster)

More examples available on the wiki

Screen Sharing

For an example for screen sharing with Agora Video UI Kit and AgoraBroadcastExtensionHelper Quickstart, check out the example project here:

https://github.com/AgoraIO-Community/Video-UI-Kit-ScreenShare

Documentation

For full documentation, see our AgoraUIKit documentation page.

For other libraries in this package:

Error Handling and Troubleshooting

For tips on how to overcome some common errors, see the wiki page.

Roadmap

Muting/Unmuting a remote member
Usernames (Settable value, not currently rendered)
Promoting an audience member to a broadcaster role.
Layout for Voice Calls
Cloud recording

UIKits

The plan is to grow this library and have similar offerings across all supported platforms. There are already similar libraries for Android, React Native, Flutter and Web React so be sure to check them out.

UML Diagrams

AgoraUIKit

AgoraRtmControl

generated with swiftplantuml classdiagram Sources

License

AgoraIO-Community/VideoUIKit-iOS

About

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases 64

Packages 0

Contributors 2

Languages

Packages