End-to-End Example#

This example demonstrates how to establish a CloudXR connection between a server and a client using the CloudXR LÖVR plugin and the CloudXR Generic Viewer. Learn more about these samples from their respective GitHub repositories.

Download the samples#

Server Setup#

Windows

  1. Make sure Visual Studio 2022 is installed with CMake individual components.

  2. Add firewall rules to allow CloudXR connection from Apple Vision Pro. Refer to Ports and Firewalls for more details. In Windows Defender Firewall -> Advanced settings, add the following two inbound rules:

    1. Allow UDP connections to local ports 47998, 47999, 48000, 48002, 48005.

    2. Allow TCP connections to local port 48010, 49100.

  3. Start Developer PowerShell for VS 2022 or Developer Command Prompt for VS 2022 (Non-administrator).

  4. Build the LÖVR plugin. Navigate to the directory cloudxr-lovr-sample and enter this command:

    .\build.bat

  5. Run the LÖVR plugin:

    .\run.bat

Linux

  1. Install the following dependencies as outlined in https://lovr.org/docs/Compiling#linux:

sudo apt install make cmake xorg-dev libcurl4-openssl-dev libxcb-glx0-dev libx11-xcb-dev python3-minimal

  1. Open up required firewall ports for CloudXR. Refer to Ports and Firewalls for more details.

sudo ufw allow 47995/udp
sudo ufw allow 47998/udp
sudo ufw allow 47999/udp
sudo ufw allow 48000/udp
sudo ufw allow 48001/udp
sudo ufw allow 48002/udp
sudo ufw allow 48005/udp
sudo ufw allow 48008/udp
sudo ufw allow 48012/udp
sudo ufw allow 48010/tcp
sudo ufw allow 49100/tcp
sudo ufw reload

  1. Build the LÖVR plugin: navigate to the directory cloudxr-lovr-sample and enter the command:

./build.sh

  1. Run the LÖVR plugin:

./run.sh

Client Setup#

  1. Open CloudXRViewer.xcodeproj with Xcode 26.

  2. Add CloudXR Framework as a package dependency in the project.

  3. Select CloudXRViewer-visionOS target to build for visionOS.

Connection and Testing#

  1. Make sure the server is running on the same network as the client.

  2. In the client:

    1. Set the Manual IP Address for Select Zone.

    2. Under IP Address, input the server IP address.

    3. Enable hand tracking.

    4. Click Connect.

  3. You should now see the following on the headset:

    1. Text: Received: no data

    2. Blue cubes tracking your finger joints

    3. Windows only: Pinching index and thumb produces an audio tone emanating from the server to within the headset.

  4. Next, test the opaque data channels:

    1. Click the Server Actions tab.

    2. Select the only channel available.

    3. After you connect to the channel, you can toggle between clicking the Action 1 and Action 2 buttons. Notice that the text updates according to the button pressed.

    4. Under Last message received, the LÖVR server app echoes back the message it receives from the button press.

On this page