MediaPipe Tasks-Vision 在 iOS 17+ Web Workers 中的兼容性问题解析

背景介绍

MediaPipe 是 Google 开源的一个跨平台多媒体处理框架，其中的 Tasks-Vision 模块提供了多种计算机视觉任务的解决方案。在 Web 端，开发者通常会使用 Web Workers 来运行这些计算密集型任务以避免阻塞主线程。

问题现象

在 iOS 17+ 系统中，当尝试在 Web Worker 中使用 MediaPipe Tasks-Vision 时，会出现 "Can't find variable: document" 的错误。这是因为 Tasks-Vision 在 Web Worker 中错误地尝试创建常规 DOM Canvas 元素，而非使用 Web Worker 环境支持的 OffscreenCanvas。

技术分析

Web Worker 的限制

Web Workers 是浏览器提供的多线程解决方案，但它们与主线程有以下关键区别：

1. 无法访问 DOM
2. 没有 document 对象
3. 只能使用 OffscreenCanvas 而非常规 Canvas

iOS 17+ 的新特性

iOS 17 及更高版本的 Safari 浏览器已经完整支持：

1. WebGL2 在 OffscreenCanvas 中的使用
2. 完整的 gl.FLOAT 支持

MediaPipe 的兼容性检查

MediaPipe 原有的兼容性检查逻辑存在问题：

1. 在 graph_runner.ts 和 vision_task_runner.ts 中，错误地排除了 WebKit 内核浏览器
2. 在 mask.ts 中对 iOS 的特殊处理可能已不再必要

解决方案

Google 团队在 MediaPipe 0.10.13 版本中修复了此问题，主要变更包括：

1. 更新了 OffscreenCanvas 支持检查逻辑，现在会正确识别 Safari 17+ 的支持
2. 优化了 WebGL2 功能检测机制

开发者建议

对于需要在 Web Worker 中使用 MediaPipe Tasks-Vision 的开发者：

1. 确保使用 MediaPipe 0.10.13 或更高版本
2. 对于 iOS 17+ 设备，不再需要特殊处理
3. 如果遇到性能问题，可以检查是否仍有不必要的 iOS 特定代码路径

总结

随着浏览器技术的进步，MediaPipe 等框架需要持续更新其兼容性策略。iOS 17+ 对 Web Worker 和 WebGL2 的完整支持为移动端 Web 应用带来了新的可能性，开发者现在可以更自由地在后台线程中运行复杂的计算机视觉任务。