Flutter集成Scandit AR时BarcodeTrackingAdvancedOverlay无显示问题求助

这个问题是Scandit Data Capture Flutter SDK 6.18及更早版本与Flutter 3.10+版本的兼容性缺陷，和你的业务代码无关，运行官方示例也能复现的现象可以直接验证这一点。

报错根因 #

Scandit SDK在实现自定义AR视图渲染时，会把你传入的Flutter Widget转换为base64格式的图片传递给原生层渲染，这一逻辑用到了独立的BuildOwner实例。而Flutter 3.10版本对全局键盘事件处理逻辑做了调整，默认绑定了全局RawKeyboard.keyEventHandler，创建新的BuildOwner时会触发对应断言检查，导致报错，自定义视图无法正常渲染。

解决方法 #

优先方案 #

升级Scandit Flutter SDK到6.19.0及以上版本，官方已经在该版本修复了这个兼容性问题，替换了Widget转图片的实现逻辑，不再触发该断言错误，升级后你的现有代码无需修改即可正常运行。

临时方案1 #

如果暂时无法升级SDK，可以将Flutter版本降级到3.7.x系列，该版本没有引入键盘事件相关的调整，不会触发该报错。

临时方案2 #

如果既不能升级SDK也不能降级Flutter，可以在设置AR Widget的逻辑前后临时修改全局键盘事件配置，规避断言检查，代码示例如下：

_updateView(TrackedBarcode trackedBarcode, Quadrilateral viewLocation) {
  // 先保存原有键盘事件处理逻辑
  final originalKeyboardHandler = RawKeyboard.instance.keyEventHandler;
  // 临时置空规避断言
  RawKeyboard.instance.keyEventHandler = null;

  // 原有逻辑不变
  var shouldBeShown = viewLocation.width() > MediaQuery.of(context).size.width * 0.1;
  if (!shouldBeShown) {
    overlay.setWidgetForTrackedBarcode(null, trackedBarcode);
  } else {
    var bubble = ARWidget(data: trackedBarcode.barcode.data ?? '');
    overlay.setWidgetForTrackedBarcode(bubble, trackedBarcode);
  }

  // 下一帧恢复原有键盘事件处理，避免影响其他功能
  WidgetsBinding.instance.addPostFrameCallback((_) {
    RawKeyboard.instance.keyEventHandler = originalKeyboardHandler;
  });
}

如果用的是BarcodeTrackingAdvancedOverlayListener的widgetForTrackedBarcode回调返回Widget，可以在回调方法里套用同样的临时处理逻辑。

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