跳转到内容
WebView AllWebView All
这是 1.2.x 版本的文档,最新接口请切换至 latest。

权限

Web 内容权限有两层:

  1. 宿主应用必须拥有系统权限。
  2. WebView 必须批准网页请求。
final controller = WebViewController(
onPermissionRequest: (WebViewPermissionRequest request) async {
if (request.types.contains(WebViewPermissionResourceType.camera)) {
await request.grant();
} else {
await request.deny();
}
},
);

同一个 request 只应调用一次 grant() 或 deny()。

类型含义
WebViewPermissionResourceType.camera摄像头。
WebViewPermissionResourceType.microphone麦克风。
平台类型含义
AndroidAndroidWebViewPermissionResourceType.midiSysexMIDI sysex。
AndroidAndroidWebViewPermissionResourceType.protectedMediaId受保护媒体 ID。
OHOSOhosWebViewPermissionResourceType.midiSysexMIDI sysex。
OHOSOhosWebViewPermissionResourceType.protectedMediaId受保护媒体 ID。

Android 和 OHOS 提供 geolocation prompt 回调:

await (controller.platform as AndroidWebViewController)
.setGeolocationPermissionsPromptCallbacks(
onShowPrompt: (request) async {
return const GeolocationPermissionsResponse(
allow: true,
retain: false,
);
},
);

现代 WebView 通常要求定位请求来自 https 等安全 origin。

Android 和 OHOS 支持 <input type="file">:

await (controller.platform as OhosWebViewController)
.setOnShowFileSelector((FileSelectorParams params) async {
return <String>['/data/storage/el2/base/files/upload.png'];
});

FileSelectorParams 包含 isCaptureEnabled、acceptTypes、filenameHint 和 mode。

Android 和 OHOS 可以把视频等全屏内容交给应用展示:

await (controller.platform as OhosWebViewController)
.setCustomWidgetCallbacks(
onShowCustomWidget: (Widget widget, VoidCallback onHidden) {
Navigator.of(context).push(
MaterialPageRoute<void>(
fullscreenDialog: true,
builder: (_) => widget,
),
);
},
onHideCustomWidget: () {
Navigator.of(context).pop();
},
);

Web 实现会在同源 iframe 中包装 navigator.mediaDevices.getUserMedia,并把 camera/microphone 请求转发给 onPermissionRequest。即使应用调用 grant(),浏览器仍可能继续显示自己的权限提示。