Program Adaptation Requirements

LarkSR supports the following 4 types:

1. **SR (3D Shared Mode - Parallel Cloud Solution)**: This type restricts applications to pure 3D simulation programs, and a server can run multiple such applications simultaneously.

2. **SR (2D Shared Mode - Parallel Cloud Solution)**: This mode is suitable for applications with both 2D and 3D elements, mainly addressing the multi-instance requirements of applications with 2D elements. Compared to 3D shared mode, the concurrency is lower, but it can replace exclusive mode in many scenarios. This mode supports pre-launch functionality, audio output, data channels, interactive mode, but does not support client adjustment of resolution, microphone, camera, and other device pass-through. Important notes include: 1) The system will automatically create users, and there may be remnants of user directories in user directories; 2) Normal usernames should not start with \_LARKXR\_; 3) RDP services are required, and it is recommended to modify the default RDP port; 4) In strict security reviews, 2D application sharing mode can be disabled in the configuration file (modify the management node configuration file: pxy.render-server.remote-desktop.enable=false); 5) Each 2D application shared connection will consume a certain amount of local bandwidth, but the impact is not significant; 6) Entry into applications is slightly slower than 3D shared mode; 7) Resource scheduling for single-machine multi-card is based on the operating system's polling allocation of multiple GPU resources.

3. **SR (Exclusive Mode)**: For some locally installed applications with user directories, applications that may have cross-user access permission issues, and multi-screen scenarios, it is recommended to use exclusive mode. In this mode, a server can only run one simulation application.**In version V3.3.3.0,this type is removed by default.If you need to enable it,please add the following configuration item in`larkxr-center/application.properties`**
    ```
    pxy.dispatch-policy.enable-exclude-mode=true
    ```

## Requirements for Applications in 3D Shared Mode

1. Supported engines include: Unreal, Unity3D, DirectX9, DirectX10, DirectX11, DirectX12, OpenGL, Enscape, etc.

2. It is recommended to start the application with the resolution expected for actual use as the benchmark, and it should be started in maximized window mode, not in full-screen exclusive mode.

- Full-screen exclusive mode will cause the server to run only one application, and when the application resolution does not match the server's resolution, the server's resolution will be changed.

- Taking a Unity application as an example, **do not** choose the option in the red box:

![](https://docs.paraverse.cc/media/202504/0ae45c8c88be4842aa6194717cb8e76a5408.png)

3. The application must be pure 3D and single-process, paying attention to the following points:

- Only applications with single-process windows are supported, such as those developed using Unreal, Unity3D.

- Windows pop-ups are not supported; pop-ups need to use graphic rendering selection.

- If developing OpenGL programs using QT, replace QT controls with OpenGL/Widget to render together in the scene; otherwise, QT controls will not be captured.

- Applications should not open external documents like Word, PDF, Excel through APIs.

4. For applications developed using the Unreal Engine, when specifying the path during application upload, do not fill in the exe program at the root directory. The correct directory should be at the same level -> project name directory -> Binaries -> Win64 -> xxx.exe. If there are startup parameters, add them to the background startup parameter text box. Reference link: [Reference Link](https://www.pingxingyun.com/contribute/detail?topicId=10107&categoryId=3).