基于Mac（类Unix系统）获取Xreal Air USB-C 3DOF头动追踪信息的最简方案

1. 识别连接的Xreal Air设备 #

先确认设备已通过USB-C连接Mac，用系统自带命令定位设备的HID标识：

# 查找USB设备中的Xreal设备
ioreg -c IOUSBDevice | grep -i "Nreal"
# 或直接查询HID设备列表
hidutil list | grep -i "Nreal"

执行后会得到设备的Vendor ID（VID）和Product ID（PID），Xreal Air的典型值为VID: 0x3318、PID: 0x0424（固件版本不同可能有变化，以实际输出为准）。

2. 实时读取HID原始追踪数据 #

Xreal Air通过HID报告传输3DOF数据，优先用Mac自带的hidutil工具实现：

步骤1：创建HID监听配置文件 #

新建xreal_hid.plist文件，填入以下内容（替换VID和PID为你的设备十进制值，比如0x3318对应十进制8984，0x0424对应1060）：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Device</key>
    <dict>
        <key>VendorID</key>
        <integer>8984</integer>
        <key>ProductID</key>
        <integer>1060</integer>
    </dict>
    <key>ReportTypes</key>
    <array>
        <string>Input</string>
    </array>
</dict>
</plist>

步骤2：启动HID数据监听 #

执行命令实时获取设备的HID输入报告：

hidutil monitor -c xreal_hid.plist

输出会包含原始十六进制字节流，其中就包含头部俯仰（Pitch）、翻滚（Roll）、偏航（Yaw）的原始数据。

3. 解析原始数据为3DOF角度 #

以下是一个Shell脚本示例，用于自动监听并解析HID数据为可读的角度值：

#!/bin/bash

# 监听HID报告并解析3DOF数据
hidutil monitor -c xreal_hid.plist | while read -r line; do
    # 提取原始字节数据（过滤无效行）
    raw_data=$(echo "$line" | grep -oE "([0-9A-Fa-f]{2} )+")
    if [ -n "$raw_data" ]; then
        # 提取Pitch、Roll、Yaw对应字节（偏移需根据实际设备报告格式调整）
        pitch_bytes=$(echo "$raw_data" | cut -d' ' -f5-6)
        roll_bytes=$(echo "$raw_data" | cut -d' ' -f7-8)
        yaw_bytes=$(echo "$raw_data" | cut -d' ' -f9-10)
        
        # 转换为16位有符号整数
        pitch=$((0x$(echo "$pitch_bytes" | tr -d ' ')))
        roll=$((0x$(echo "$roll_bytes" | tr -d ' ')))
        yaw=$((0x$(echo "$yaw_bytes" | tr -d ' ')))
        
        # 转换为角度（比例因子以实际设备为准，示例为1单位=0.01度）
        pitch_deg=$(echo "scale=2; $pitch / 100" | bc)
        roll_deg=$(echo "scale=2; $roll / 100" | bc)
        yaw_deg=$(echo "scale=2; $yaw / 100" | bc)
        
        echo "Pitch: $pitch_deg°, Roll: $roll_deg°, Yaw: $yaw_deg°"
    fi
done

注意：字节偏移和比例因子可能随固件版本变化，若解析结果异常，可通过hidutil report -v 0x3318 -p 0x0424查看设备的HID报告描述符，确认数据格式。

4. 常见问题排查 #

• 设备无法识别：检查USB-C线缆是否支持数据传输（部分充电线无数据通道），或重启设备与Mac。
• 无数据输出：确保设备已激活追踪模式（通常连接后自动触发，部分场景需打开Xreal官方App唤醒）。
• 解析错误：对比官方文档或逆向分析HID报告格式，调整脚本中的字节偏移和转换规则。

内容的提问来源于stack exchange，提问作者Imsa