Magic Leap

Agora Video SDK for Magic Leap allows you to integrate real-time Video Calling features into your Magic Leap app. You can enhance the overall user experience and add new possibilities for collaboration and interaction within Magic Leap environments.

This page shows the minimum code you need to integrate high-quality, low-latency Video Calling features into your Magic Leap project using Video SDK.

Understand the tech

This section explains how you can integrate Video Calling features into your Magic Leap project using Video SDK.

To start a session, implement the following steps in your app:

Retrieve a token: A token is a computer-generated string that authenticates a user when your app joins a channel. In a test or production environment, your app retrieves tokens from a server in your security infrastructure.
Join a channel: Call methods to create and join a channel. Apps that pass the same channel name join the same channel.
Send and receive video and audio: All users in the channel can send and receive real-time audio and video streams.

Prerequisites

To test the code used on this page, you need:

An Agora account and project
A computer with Internet access
A network environment where no firewall blocks required communication
The SDK quickstart implemented in your project
ML Hub
Unity Hub
Install and configure the Unity Editor required to develop for Magic Leap 2

Project setup

To integrate Video Calling into your Magic Leap project, do the following:

Create a Magic Leap project for Unity

Create a project for your Agora Magic Leap app
Configure your app settings

Configure your project

In Unity Editor:

Click Edit > Project settings.
In XR Plug-in Management, enable Magic Leap.
In XR Plug-in Management > Magic Leap Settings, enable Use ML Audio.
In Player settings > Android > Publishing settings, enable Custom Main Manifest.
In Magic Leap > Permissions, enable android.permission.CAMERA and android.permission.RECORD_AUDIO.

You are now ready to add Video Calling features to your Magic Leap project.

Integrate the Video Calling demo

When a user opens the app, you initialize the Agora Engine. When the user taps a button, the app joins or leaves a channel. When another user joins the same channel, their video and audio are rendered in the app. This simple workflow lets you focus on implementing Agora features instead of surrounding UI complexity.

This section shows how to integrate the Video SDK to implement the Video Calling demo in your Magic Leap project:

Download the latest version of Video SDK for Magic Leap to a local folder.
Double-click the downloaded package.

The Import dialog opens automatically in Unity Editor.

Click Import.

In Project > Assets, you see Agora-RTC-Plugin and Agora_MagicLeap2_Plugin.

Test your implementation

Agora recommends that you run this project on a physical device, because some simulators may not support the full feature set.

To verify the integration:

Obtain an App ID with token enabled.
Generate a temporary token in Agora Console.
In your browser, open the Agora web demo and update App ID, Channel, and Token with the same values used for this project, then click Join.
In Unity Editor, double-click Agora_MagicLeap2_Plugin > AgoraEngine > ML2Support > Demo.
In Project, open Agora_MagicLeap2_Plugin > AgoraEngine > ML2Support > Scripts > Agora Controller.
Update APP_ID, TOKEN, and CHANNEL_NAME with the same values you used for the web demo.
Connect an ML2 device, then click Build and Run.
Click Connect Camera.

Video from your ML2 is streamed to the channel and is visible in the web demo. You also see the remote video stream from the web demo.

Reference

Manual install shows how to install Video SDK manually
To ensure communication security in test or production environments, best practice is to use a token server. See Use tokens