Unity使用Vuforia与ZXing.NET时设置帧格式失败问题求助

问题原因分析 #

你遇到的Failed to set frame format错误，大概率是两个原因导致的：一是RGB565格式并不是当前设备或你的Vuforia版本所支持的像素格式，Vuforia对不同设备的像素格式支持有差异，不能直接默认RGB565一定可用；二是你可能在相机已经启动运行后才尝试修改格式，这时候Vuforia不允许变更格式。

解决方案步骤 #

1. 先获取设备支持的像素格式列表 #

在盲目设置格式前，先打印出当前设备支持的所有像素格式，这样就能精准选择可用格式：

void Start()
{
    // 绑定Vuforia初始化完成的回调，确保在相机启动前操作
    VuforiaARController.Instance.RegisterVuforiaStartedCallback(OnVuforiaReady);
}

void OnVuforiaReady()
{
    CameraDevice cameraDevice = CameraDevice.Instance;
    IList<Image.PIXEL_FORMAT> supportedFormats = cameraDevice.GetSupportedPixelFormats();
    
    // 控制台打印所有支持的格式
    foreach (var format in supportedFormats)
    {
        Debug.Log("当前设备支持的像素格式：" + format.ToString());
    }
}

运行后查看控制台输出，从中挑选一个可用格式（比如RGB888或GRAYSCALE，ZXing对灰度图的处理效率更高）。

2. 在相机启动前设置像素格式 #

一定要在Vuforia相机初始化完成但尚未启动的时机设置格式，同时做好暂停恢复时的格式重置：

private Image.PIXEL_FORMAT targetFormat = Image.PIXEL_FORMAT.RGB888; // 替换为你查到的支持格式

void Start()
{
    VuforiaARController.Instance.RegisterVuforiaStartedCallback(OnVuforiaReady);
    VuforiaARController.Instance.RegisterOnPauseCallback(OnVuforiaPause);
}

void OnVuforiaReady()
{
    CameraDevice cameraDevice = CameraDevice.Instance;
    
    // 尝试设置格式并启用
    if (cameraDevice.SetFrameFormat(targetFormat, true))
    {
        Debug.Log("成功设置像素格式：" + targetFormat);
    }
    else
    {
        Debug.LogError("当前设备不支持该格式：" + targetFormat);
    }
}

// 应用暂停恢复时，重新设置格式避免异常
void OnVuforiaPause(bool paused)
{
    if (!paused)
    {
        CameraDevice.Instance.SetFrameFormat(targetFormat, true);
    }
}

3. 适配ZXing的图像处理逻辑 #

拿到相机图像后，转换成ZXing能处理的格式，这里以RGB888为例：

void ProcessQrCode()
{
    CameraDevice cameraDevice = CameraDevice.Instance;
    Image cameraImage = cameraDevice.GetCameraImage(targetFormat);
    
    if (cameraImage != null)
    {
        byte[] pixelData = cameraImage.Pixels;
        int width = cameraImage.Width;
        int height = cameraImage.Height;
        
        // 生成ZXing需要的亮度源
        var luminanceSource = new RGBLuminanceSource(width, height, pixelData);
        var bitmap = new BinaryBitmap(new HybridBinarizer(luminanceSource));
        
        // 解码二维码
        var reader = new MultiFormatReader();
        try
        {
            Result result = reader.decode(bitmap);
            Debug.Log("二维码解码结果：" + result.Text);
        }
        catch (NotFoundException)
        {
            // 未识别到二维码时的处理逻辑
        }
    }
}

额外注意事项 #

• 你的Unity版本是2017.3.1p1，建议搭配Vuforia 7.x系列版本（该版本专门适配Unity 2017），避免版本兼容问题。
• 如果不需要彩色图像，优先选择GRAYSCALE格式，既能提升ZXing的解码速度，也能减少内存占用。

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