How to use the New Ant Media Server Unity WebRTC SDK?

Ant Media provides a Unity WebRTC SDK built on top of the WebRTC for Unity packages developed by the Unity team. This SDK enables developers to publish and play ultra-low-latency WebRTC streams directly from Unity applications using Ant Media Server.

The SDK is distributed as a GitHub project and includes a sample Unity application that demonstrates publishing, playback, and peer-to-peer streaming scenarios. It is designed for developers who want direct access to the source code and greater control over integration.

This guide walks through setting up the Unity WebRTC SDK project, configuring Ant Media Server connectivity, building the application for multiple platforms, and running the included sample application.

Setup The Project

This section explains how to download, open, and configure the Unity WebRTC SDK project.

Clone the SDK Repository

Clone the Unity WebRTC SDK from the official GitHub repository:

git clone https://github.com/ant-media/WebRTC-Unity-SDK.git

Open the Project in Unity

1. Launch Unity Hub.
2. Click Open and select the folder where you cloned the repository.
3. Wait for Unity to import and open the project.

Open the Sample Scene

1. In the Project window, navigate to: Assets/AntMedia/Samples
2. Open the AMSStreamingSample scene.

Configure Ant Media Server Settings

In the same directory, open the script AMSStreamingSamples.cs and update the WebSocket URL to match your Ant Media Server configuration:

string websocketUrl = "ws://localhost:5080/LiveApp/websocket";

Note: Use wss:// and port 5443 if SSL is enabled on Ant Media Server.

Set the stream ID by passing it as the first parameter to the WebRTCClient constructor. This stream ID will be used for publishing and playback in the sample application.

Build The Project

Unity projects can be built for multiple platforms. This section covers building the Unity WebRTC SDK sample application for Windows and Android.

Windows Build

1. Navigate to File → Build Settings
2. Select Windows as the platform
3. Click Build and select the folder where you want to create the executable file

Android Build

1. Navigate to File → Build Settings
2. Select Android as the platform and click Switch Platform
3. Click Player Settings
4. Expand Publisher Settings
5. Create a Keystore via Keystore Manager
6. Select the created keystore as Custom Keystore and set the password

7. Expand Other Settings:
   • Set Scripting Backend to IL2CPP
   • Check ARM64 checkbox

8. Go back to the Build window:
   • Choose the device you want to install and run the application on
   • Check Development Build
   • Click Build and Run and select the folder for the APK file

Run The Project

After building and running the Unity WebRTC SDK sample application, the main sample interface will be displayed. The sample application supports three different modes, which can be selected from the dropdown menu. Each mode demonstrates a different WebRTC streaming scenario.

Publish Mode

In Publish Mode, the sample application captures video from the local camera and publishes it to Ant Media Server as a WebRTC stream.

• The local camera preview is displayed in the first player
• The stream is published using the stream ID configured in the SDK

You can watch the published stream using the Ant Media Server WebRTC player:

https://{AMS_URL}:5443/WebRTCAppEE/play.html?streamId={STREAM_ID_YOU_SET}

Play Mode

In Play Mode, the sample application plays an existing WebRTC stream from Ant Media Server. To use this mode:

1. Create or publish a stream on Ant Media Server using the same stream ID configured in the SDK
2. Select Play Mode in the sample application
3. Click Start

The stream will be rendered in the second player.

Peer Mode

In Peer Mode, the sample application both publishes and plays WebRTC streams simultaneously.

• The local camera stream appears in the first player
• The application waits for a second peer to join

To add another peer, open the following URL in a browser:

https://{AMS_URL}:5443/WebRTCAppEE/peer.html

Enter the same stream ID used in the sample application. Once connected, the second peer’s stream will appear in the second player.

Codec Note

The sample application currently uses the VP8 codec. Make sure that Ant Media Server is configured to support VP8 before testing the sample application.

Frequently Asked Questions

Conclusion

The Ant Media Unity WebRTC SDK provides a flexible and source-accessible way to integrate ultra-low-latency WebRTC streaming into Unity applications. Built on top of Unity’s official WebRTC packages, the SDK allows developers to publish, play, and test real-time streams using Ant Media Server with full control over the integration.

This guide covered setting up the SDK project from GitHub, configuring Ant Media Server connectivity, building the application for Windows and Android, and running the included sample application in different streaming modes. Developers implementing production applications should review WebRTC stream publishing workflows including advanced configuration options for bitrate control, resolution adaptation, and error handling mechanisms that extend beyond the basic sample implementation provided in the Unity SDK. By using the provided sample scenes and source code, developers can quickly adapt the SDK to their own real-time use cases.

With WebRTC support and Unity’s cross-platform capabilities, the Ant Media Unity WebRTC SDK offers a solid foundation for building real-time applications such as interactive media, live collaboration tools, and streaming-enabled games. Developers targeting Android platforms exclusively may also consider native Android WebRTC SDK implementation which provides direct Java/Kotlin integration without Unity framework overhead, offering optimized performance for mobile applications requiring minimal APK size and maximum battery efficiency.