Documentation
Single Host
Console 官网 Community Technical support
English
search-icon

Run the Sample Project

Last updated 2022/04/02 02:04:38

Introduction

Agora provides an open-source Agora Live sample project on GitHub. This sample project demonstrates how to use the Agora RTC SDK, Agora RTM SDK, and third-party image enhancement SDK to implement the following interactive live streaming scenarios:

  • Single Host
  • Multiple Hosts
  • Virtual Host
  • PK Host
  • Live-stream Shopping

This document introduces how to run this project and experience interactive live video streaming in each scenario.

Prerequisites

  • Xcode 10.0 or later.
  • CocoaPods. You can refer to the installation guide in Getting Started with CocoaPods.
  • A mobile device running iOS 9.0 or later. Agora recommends you run this sample project on a physical mobile device, as some simulators may not support the full features of this project.

Procedure

Download the sample project

Go to GitHub, and download or clone the AgoraLive repository.

Import FaceUnity bundle files

Download the FaceUnity bundle files from Agora, extract the files from the downloaded package, and then copy the Faceunity folder to AgoraLive-iOS/Resource.

Import the FaceUnity certificate file

Contact FaceUnity for a certificate file named authpack.java, and then move this file to AgoraLive/iOS/Resource/Faceunity.

Install dependencies

Go to AgoraLive-iOS/AgoraLive, and then run the following command to link dependencies.

pod install

If you get stuck in linking the dependencies, you can replace the source url in AgoraLive-iOS/AgoraLive/Podfile as follows, save the change, and then run pod install again.

// Before replacing
source 'https://github.com/CocoaPods/Specs.git'
// After replacing
source 'https://cdn.cocoapods.org/'

Run the project

  1. Open the AgoraLive-iOS/AgoraLive/AgoraLive.xcworkspace folder with Xcode.
  2. Connect your iOS device to your computer using a USB cable.
  3. Click Build and run in Xcode. You should see the Agora Live app installed on your iOS device after a while.
  4. Launch the app, and select whichever scenario you prefer to start interactive live streaming.

Common issues

If Xcode reports "Error: Multiple commands produce", you can troubleshoot as follows:

  1. Click File > Workspace Settings in Xcode.
  2. In the pop-up panel, click Build System in Shared Workspace Settings, and then replace New Build System (Default) with Legacy Build System.
  3. Click Build and run. The app should run on your device.