Agora provides an open-source OpenLive-iOS-Swift sample project on GitHub. This document introduces how to run this project and experience a live video streaming implemented by the Agora SDK.

Prerequisites

• Xcode 9.0 or later
• An iOS device running iOS 8.0 or later.
• A valid Agora account.

Procedures

1. Create an Agora project

Create a project in Agora Console, as follows:

1. Log in to Console, and click in the left navigation menu to enter the Project Management page.

2. Click Create.

   

3. Enter your project name, and select Secure mode: APP ID + Token for the authentication mechanism in the pop-up window.

4. Click Submit. You can see the created project on the Project Management page.

2. Get an App ID

Agora automatically assigns each project an App ID as a unique identifier.

To copy this App ID, find your project on the Project Management page in Agora Console, and click the eye icon to the right of the App ID.

3. Generate a temporary token

To ensure communication security, Agora uses tokens (dynamic keys) to authenticate users joining a channel.

Agora Console supports generating temporary tokens for testing purposes.

1. On the Project Management page, find your project, and click to open the Token page.

   

2. Enter a channel name, and click Generate Temp Token to get a temporary token. When joining the channel, ensure that the channel name is the same with the one that you use to generate the temporary token.

   

4. Configure the sample project

1. Download the Basic-Video-Broadcasting repository, and find the OpenLive-iOS sample project.

2. Fill in the OpenLive/KeyCenter.swift file with the App ID and temporary token generated in Agora Console.

   struct KeyCenter {
    // Replace #Your App Id# with your App ID, and add quotation marks around it, such as "xxxxxx"
    static let AppId: String = <#Your App Id#>    
   
    // Replace #Temp Access Token# with your temporary Token, and add quotation marks around it, such as "xxxxxx"
   
    static var Token: String? = <#Temp Access Token#>
   
   }

5. Integrate the Agora SDK

Integrate the Agora iOS SDK into the sample project, as follows:

1. Download the latest Agora iOS SDK and extract the files.
2. Copy all files from the libs folder to the OpenLive folder.

6. Compile and run the sample project

1. Connect your computer to an iOS device, open the sample project on Xcode, and then compile and run the project.
2. Enter the channel name you use to generate the temporary token, such as test, and click Start Live Broadcast. You will see the following screen on the iOS device:
   
3. Choose your role as host or audience.

Now you can experience an interactive live video streaming. You can also use the Agora Web sample app to interact with your iOS device. Ensure that you enter the same App ID, channel name, and temporary token in the Agora Web sample app.

Sample project structure

The following table lists the structure of the sample project for your reference:

Relevant links

Apart from Swift, Agora provides an additional OpenLive-iOS-Objective-C sample project in Objective-C.