drukscode-v2/docs/zh/guide/app-actions/edit-common-config/special-settings.md

特殊设置

兼容性 polyfill、桥接和其他专门开关。这张卡片汇集了专门的 WebViewConfig 选项。

位置:编辑通用配置编辑器中的 特殊设置 卡片。

Polyfill 与桥接

• 剪贴板 polyfill —— enableClipboardPolyfill。
• 通知 polyfill —— Web Notification 支持(enableNotificationPolyfill)。
• 方向 polyfill —— enableOrientationPolyfill。
• 兼容 polyfill —— 一组兼容 shim(enableCompatPolyfills)。
• 原生桥 —— 暴露带能力门控的原生桥(enableNativeBridge、nativeBridgeCapabilities)。
• 打印桥 —— 拦截 window.print() 和 PDF 输出到 Android 打印框架(enablePrintBridge)。
• 媒体会话桥 —— 把网页媒体接入系统媒体通知和锁屏控制,支持蓝牙耳机和 Android Auto(enableMediaSession)。
• 分享桥 —— enableShareBridge。
• 缩放 polyfill —— enableZoomPolyfill。

媒体与内容

• 媒体自动播放 —— 带范围(mediaAutoplayEnabled、mediaAutoplayScope:仅视频……)。
• 图片修复 —— 修复损坏的图片(enableImageRepair)。
• 滚动记忆 —— 记住滚动位置(enableScrollMemory)。
• 返回状态保留 —— enableBackStatePreservation。
• Blob 下载拦截 —— 带范围和大小阈值(enableBlobDownloadInterception、blobInterceptThresholdMb)。

JavaScript 与窗口

• JS 可打开窗口 —— 带策略(javaScriptCanOpenWindows、jsOpenWindowsPolicy)。
• 预置用户激活 —— 合成用户手势,带模式和时机(primeUserActivation、primeUserActivationMode、primeUserActivationTiming)。
• Base64 深度链接 —— 解码 base64 深度链接,仅手势或总是(decodeBase64DeepLinks、decodeBase64Mode)。

安全与其他

• 跨源隔离 —— enableCrossOriginIsolation。
• 防截屏 —— 阻止屏幕截取(antiCapture)。
• 视频全屏时隐藏状态栏 —— 网页视频进入 HTML5 全屏播放时强制隐藏状态栏,退出全屏后恢复(hideStatusBarInVideoFullscreen,默认开启)。视频全屏期间优先于全屏模式中的"全屏显示状态栏"选项。
• 文件 URL 的文件访问 —— allowFileAccessFromFileURLs、allowUniversalAccessFromFileURLs。
• 错误页 —— 自定义错误页配置(errorPageConfig)。
• 性能优化 —— performanceOptimization。
• PWA 离线 —— 离线缓存策略(pwaOfflineEnabled、pwaOfflineStrategy)。
• 浮动返回按钮 —— showFloatingBackButton。
• 键盘调整模式 —— keyboardAdjustMode(resize……)。在 Android 10 及以下,RESIZE 模式走经典窗口缩放路径(窗口非 edge-to-edge),键盘可可靠地压缩内容。
• 全屏视频方向 —— 全屏视频如何转向(fullscreenVideoOrientation),如自动传感器横屏。
• 隐藏 URL 预览 —— hideUrlPreview。

说明

• 这些是高级用户开关;大多数应用保持默认即可。
• 默认值:以下安全体验特性对新应用默认开启——剪贴板/方向/兼容 polyfill、媒体会话、分享、缩放与打印桥、图片修复、滚动记忆、返回状态保留、Blob 拦截、JS 窗口、用户激活预置、Base64 深链、私网桥和原生桥。刻意保持关闭:通知 polyfill(否则每个导出包都会弹通知权限)、定位、混合内容、第三方 Cookie、自动播放和弹窗拦截。