# NOTICE This SDK repo has been archieved for a new repo. Please go to [this URL for the latest Agora Unreal SDK](https://github.com/AgoraIO-Community/Agora-Unreal-SDK). # AgoraVideoCall Sample App The Agora Video Call is a demo app that will help you integrate Real Time Engagement directly into your Unreal Engine applications using the AgoraPlugin, that wraps Agora Video SDK. With this sample app, you can: - Join / leave channel - Mute / unmute audio - Enable / disable video - Switch camera - Setup resolution and frame rate Developed with Unreal Engine 4.23 There are two implementations of Agora Video Call demo application: 1) C++ based. 2) Blueprints based. ## Supported Platforms Windows 64-bit Mac iOS ## Getting Started *IMPORTANT* ### If you are starting with a blank project, start with C++ template Agora plugin is implemented as separate module. [Download the plugin .zip file here](https://apprtcio-my.sharepoint.com/:f:/g/personal/joel_agora_io/ElB8ya6XEXNEt742um20rAQBrbSvIo_biLgTIKI8ddrc4w?e=42QaST) and add the AgoraPlugin folder to the "Plugins" folder inside your Unreal project. You can simply unzip and drop the entire AgoraPlugin folder inside of Plugins, and you're good to go! The folder structure should like like /Plugins/AgoraPlugin/ ## Building and Running the App Open AgoraVideoCall.uproject with Unreal Editor 4.23-4.25. To test Agora functionality, you have to package the project and run as a standalone build, or if testing on iOS use Unreal's "Launch" feature. To package the project: ### Windows File->Package Project->Windows->Windows(64-bit) then select a folder where you want to package and wait for result. ![Alt text](https://github.com/AgoraIO-Community/Agora-Unreal-SDK-CPP/raw/master/ReadMeImages/HowToPackageProject.png?raw=true "PackageProject") ## Mac File -> Package Project -> Mac ![Alt text](https://github.com/AgoraIO-Community/Agora-Unreal-SDK-CPP/raw/master/ReadMeImages/HowToPackageProjectMac.png?raw=true "PackageProject") ### Add the following permissions in the info.plist file for device access: 1. Right click .app file - select "Show Package Contents" 2. Go to "Contents->Info.plist" 3. Click the plus next to "Information Property List" and add: Privacy - Camera Usage Description Privacy - Microphone Usage Description ### Add AgoraRtcKit.framework to your newly built project 1. Package the project from Unreal 2. From inside the Plugins folder of the project, copy the file: **AgoraRtcKit.framework** from **Plugins/AgoraPlugin/Source/ThirdParty/Agora/Mac/Release** to 3. Paste file into your newly built project folder **(Packaged project dir)/MacNoEditor/[project_name]/Contents/MacOS/** ## iOS Packaging To package the project for iOS, you need to have a **Signing Certificate** and **Provisioning Profile** and add it to your project. I would *highly recommend* going to Project Settings > Platforms > iOS > Build > and check "Automatic Signing" - this saves me a lot of headache. ![iOS settings](https://github.com/AgoraIO-Community/Agora-Unreal-SDK-CPP/raw/master/ReadMeImages/iOSSettings.png) If you don't have one: follow the instructions from UE4 documentation: [iOS Provisioning](https://docs.unrealengine.com/en-US/Platforms/Mobile/iOS/Provisioning/index.html) Go to the **Edit->Project Settings->Platforms: iOS**, then select the certificate and provisioning profile you created. If you don't see one of them in the table, click **Import Certificate** or **Import Provision**, chose the right file in Finder and click **Open**. Then enter a Bundle Identifier: it must be the Bundle Id you used during certificate creation. ### iOS Testing To test your Agora project on your iOS device: 1. Connect your phone to your computer via USB 2. Make sure your signing certificates are all up to date and working 3. In the Unreal "Toolbar" (Save, Compile, Source Control, etc.) click the "Launch" button (to the right of Play) with your device selected in the dropdown ## iOS permissions In the iOS you also need the following permissions: Privacy - Camera Usage Description Privacy - Microphone Usage Description To add them in the info.plist go to the **Edit->Project Settings->Platforms: iOS** and enter the following line to Additional Plist Data: `NSCameraUsageDescriptionAgoraVideoCall NSMicrophoneUsageDescriptionAgoraVideoCall` Now you are ready to package your project for iOS or launch it on iOS device. ## Plugin Dependencies 1. Copy the plugin to [your_project]/Plugins 2. Add plugin dependency into [your_project]/Source/[project_name]/[project_name].Build.cs, Private Dependencies section `PrivateDependencyModuleNames.AddRange(new string[] { "AgoraPlugin", "AgoraBlueprintable" });` If the version of your Unreal Editor is 4.24 or higher add the following into [your_project]/Source/[project_name]Editor.Target.cs `DefaultBuildSettings = BuildSettingsVersion.V2;` 3. Open Unreal Project, go to **Edit->Plugins**. Find category **Project->Other** and make sure plugin is enabled. ![Enable Plugin](https://github.com/AgoraIO-Community/Agora-Unreal-SDK-CPP/raw/master/ReadMeImages/2020-03-12_13-26-59.png) ## Connect With Us - You can find full API document at [Document Center](https://docs.agora.io/en/)