Skip to content

Mesiontech OpenXR

PC Platform

πŸ“Ž Forum: XR Version Posts | Firmware

Versions

Version Notes Forum Link
v1.0.16 VST toggle (CARINA_VST_ON env var) View
v1.0.15 addDriverToSteamVr.bat fix View
v1.0.14 Initial release View

Installation

  1. Run yyss_openxr_setup.exe
  2. Run setup_env_release.bat to set environment variables
  3. Connect device, run monado-service.exe
  4. SteamVR: move steamvr-monado to SteamVR drivers directory

Configuration

Edit steamvr-monado/bin/win64/custom_config.yaml.

Windows Unity SDK

Windows Unity SDK published by module manufacturer (Ranling):

  • Download: com.yysx.xrmodule.windows.rar (Baidu Netdisk, code: yysx)
  • Link: https://pan.baidu.com/s/1oVODwWNAAwNPnZbR8WE33g?pwd=yysx

Steps:

  1. Import the SDK
  2. Import YYSX Module Demo
  3. Open the Demo scene
  4. Connect the module via USB and run in Unity Editor

Note: This is a third-party SDK from the module manufacturer, not officially from Mesiontech.

Android Platform

πŸ“Ž Forum: XR Version Posts | Firmware

UnityXRSDK Installation

Recommended method (via PackageManager):

https://gitee.com/wangchaoqun_yaoyu/yyss_unitysdk.git

Add the Git URL above in Unity PackageManager.

SDK Compatible Versions

Recommended Unity 2020.3.37f1 or higher:

  • Unity 2020.3.37f1
  • Unity 2021.3.26f1c1
  • Unity 2022.3.2f1c1

SDK usage documentation at com.unity.xr.yysx\Mesiontech Unity Readme.doc.

Map Settings

SetMapOption.cs provides methods for:

  • Save map
  • Load map
  • Reset map
  • No map mode
  • Cloud map

Unity Native API

Getting Grayscale Camera Data

std::vector<uint8_t *> data;  // data[0] left, data[1] right
float twb[16];                 // pose matrix
double ts;                     // timestamp
int cam_w, cam_h;

get_camera_frame(data, cam_w, cam_h, twb, ts);

Add enable_get_camera_frame: true to render.yaml.

Getting Camera Intrinsics & Extrinsics

static std::string configstring = "";
command(Command_ID::GetCameraConfig, "", configstring);

Sample output:

cam0:
  T_cam_imu: [4x4 matrix]
  camera_model: pinhole
  distortion_model: fov
  intrinsics: [224.39, 223.97, 316.04, 233.34]
  resolution: [640, 480]
cam1:
  T_cam_imu: [4x4 matrix]
  T_cn_cnm1: [4x4 matrix]

Getting Hand Tracking Data

struct yyss_hand_pose_info {
    int state;           // -1 invalid, 0 valid
    int left_right;      // 0 left, 1 right
    int landmarkNum;
    float landmarks[3 * 26];
    float rotations[4 * 26];
    float scale;
    int transformflag;
};

API calls:

// Start hand tracking
std::string res;
command(Command_ID::StartHand, "", res);

// Get hand data
void get_hands(double &dt, std::vector<yyss_hand_pose_info> &hands, ...);

// Stop hand tracking
command(Command_ID::StopHand, "", res);

Gaze Mode Switching

  1. Remove ArticulatedHand from ShellHandRayPointer in MRTK Input settings
  2. Switch input device controller to Hand in code

Custom Gestures

  1. Import YYSX Unity SDK
  2. Import Mesiontech gesture interaction MRTK framework
  3. Modify YYSXArticulatedHand.cs
  4. Reference YYSX_IsPinching logic for custom gestures

RGB Camera

Supported resolutions and frame rates:

Resolution Frame Rate
1280x720 60fps
640x480 60fps
800x600 60fps
1920x1080 60fps
2592x1944 20fps

Use Android standard UVC protocol, or contact Mesiontech for Unity plugin examples.

Unity Android Speech Recognition SDK

  • Download: https://pan.baidu.com/s/14gvpjKU-P_zt_fwHohD1DQ (code: yysx)
  • Dependency: com.unity.xr.yysx 0.0.6
  • Sample scene included in the package

Getting A1088 Data on Android

  • Environment: Android 10+
  • Supported devices: FT62, FT63 modules with A1088 chip
  • Note: USB authorization required
  • Download: https://pan.baidu.com/s/1GzZOyIwSSZl1rTLbDOR_sA (code: 3776)

Streaming & Screen Mirroring

ALVR Streaming

  1. Connect PC and computing box to the same WiFi
  2. Open "ALVR YYSS" on the headset, note the IP
  3. Run ALVR Dashboard YYSS.exe on PC
  4. Add device IP and click Launch Steam VR

Requirements

  • Windows 11 + Steam + Steam VR
  • Computing box system β‰₯ SW_YYSS_V1.01.115

Troubleshooting

Q: SteamVR keeps searching, cannot connect, headset appears in standby?

A: Check that the ALVR Dashboard YYSS.exe path does not contain Chinese characters. Use a pure English path!

System & Computing Box

Computing Box Versions

Version Date Key Updates Forum Link
SW_YYSS_V1.01.119 2025-03 New UI, voice recognition View
SW_YYSS_V1.01.115 2024 SteamVR streaming optimization, 3dof update View
SW_YYSS_V1.01.105 2024 Video/voice call fix View

Launcher Versions

  • v1.30.218: UTC time saving, pose callback euler, 2D/3D interfaces
  • v1.28.201: Bug fixes
  • v1.27.195: SteamVR pose jitter fix, cloud map init fix

System Update

  1. Download update.zip to the computing box root directory
  2. Click "System Update"
  3. Click "Local Update"
  4. Reboot when prompted

Flashing