如何在Flutter中通过flutter_inappwebview自动播放Vimeo视频？

安全阿岳

2026-7-23

在Flutter中使用flutter_inappwebview实现Vimeo视频自动播放

核心实现代码

对应你提到的Android原生设置mWebView.getSettings().setMediaPlaybackRequiresUserGesture(false);，在flutter_inappwebview里可以通过InAppWebViewSettings直接配置，结合Vimeo嵌入链接的自动播放参数，就能实现自动播放：

import 'package:flutter_inappwebview/flutter_inappwebview.dart';

// 在你的Widget中使用
InAppWebView(
  initialUrlRequest: URLRequest(
    // 替换成你的Vimeo视频ID，必须添加autoplay和muted参数
    url: Uri.parse('https://player.vimeo.com/video/123456789?autoplay=1&muted=1'),
  ),
  initialSettings: InAppWebViewSettings(
    // 关闭媒体播放需要用户手势的限制
    mediaPlaybackRequiresUserGesture: false,
    // 必须开启JS，Vimeo播放器依赖JavaScript
    javaScriptEnabled: true,
    // 可选：允许内联媒体播放，适配移动端布局
    allowsInlineMediaPlayback: true,
  ),
)

关键注意事项

Vimeo链接参数必须加：现代浏览器和WebView的安全策略要求，非用户触发的媒体播放必须静音才能自动执行，所以必须在Vimeo嵌入链接后追加autoplay=1&muted=1，否则即使关闭了手势限制也无法自动播放。如果需要自动播放带声音的视频，部分平台（比如iOS）可能仍然不允许，这是系统级限制。
Android端：确保使用的flutter_inappwebview版本在5.0以上（最新版本都支持这个配置），无需额外修改AndroidManifest.xml。
iOS端：除了上述代码配置，还需要在Info.plist中添加以下配置（如果尚未添加），避免播放限制：
```
<key>NSAppTransportSecurity</key>
<dict>
  <key>NSAllowsArbitraryLoads</key>
  <true/>
</dict>
```
另外，iOS的WebKit框架对自动播放的限制更严格，静音+关闭手势要求是最稳妥的方案。