权限

调用navigator.mediaDevices.getUserMedia()、Geolocation API 或 Notifications API 的网页内容需要宿主应用授予或拒绝这些请求。Wails 在WebviewWindowOptions上公开了跨平台的Permissions映射，让你能够以声明方式进行控制，无需编写平台特定代码。

快速入门

window := app.Window.NewWithOptions(application.WebviewWindowOptions{
    Title: "My App",
    Permissions: map[application.PermissionType]application.Permission{
        application.PermissionMicrophone: application.PermissionAllow,
        application.PermissionCamera:     application.PermissionAllow,
    },
})

来自该窗口网页内容的摄像头和麦克风请求将直接获得授权，不会显示浏览器提示。

权限类型

PermissionType（uint8）标识网页内容可以请求的功能。

权限值

Permission（uint8）是应用于指定类型的策略。

PermissionDefault是零值，因此映射中未设置的条目会按默认方式处理。

平台行为

由于底层 WebView 的原生行为不同，各平台对PermissionDefault的处理方式也不同。

Linux（WebKitGTK）

WebKitGTK没有原生权限提示。如果未附加处理程序，它会静默拒绝所有请求——这就是添加此功能之前getUserMedia始终返回NotAllowedError的原因。

Wails 目前可在 Linux 上处理摄像头和麦克风请求。地理位置、通知和剪贴板读取功能尚未接入，因此无论你设置什么策略，这些请求仍会被拒绝。

Windows（WebView2）

WebView2 提供原生权限提示和按类型设置权限的 API。它完全支持所有五种功能类型。

重要：在此功能推出之前，Wails 会无条件调用SetGlobalPermission(Allow)，静默授予所有功能。现在，只要Permissions中存在任何条目，就不会设置这种全局授权。未设置的功能将交由 WebView2 显示原生提示，而不是自动获得授权。

这意味着，只要你在 Windows 上配置了Permissions，任何未明确列出的功能都会显示提示，而不会被静默允许。请明确设置所需的功能。

macOS (WKWebView + TCC)

macOS 上需要两层授权。WKWebView 在启动采集会话前询问应用，由 Permissions 映射回答该请求。在其下层，系统隐私框架 TCC 控制设备本身：应用首次实际访问摄像头或麦克风时会显示系统提示，用户选择按应用保存在“系统设置 → 隐私与安全性”中。

Wails 在 macOS 12 及更高版本上处理摄像头和麦克风请求。地理位置、通知和剪贴板读取没有对应的 WKUIDelegate 接口，因此尚未接入，仍交由 TCC 处理。与 Linux 一样，为这些功能设置的策略没有效果。

PermissionAllow 允许的是 WebView 请求，而不是设备访问。系统授权仍独立生效，在系统设置中被拒绝的应用仍无法访问设备。省略的只是 WebKit 自己的提示。

macOS 12 之前不存在此委托方法，因此会忽略映射，所有请求都回退到 WebKit 提示。

请确保你的Info.plist包含相应的用途说明键：

<key>NSMicrophoneUsageDescription</key>
<string>Used for voice input</string>
<key>NSCameraUsageDescription</key>
<string>Used for video calls</string>

常见模式

媒体采集应用

在所有平台上授予摄像头和麦克风权限：

Permissions: map[application.PermissionType]application.Permission{
    application.PermissionMicrophone: application.PermissionAllow,
    application.PermissionCamera:     application.PermissionAllow,
},

在Linux上，这会明确允许使用这两个设备；其他功能仍被拒绝。 在Windows上，这会允许使用这两个设备；任何未列出的其他功能都会显示原生提示。 在 macOS 上，这会在 WebKit 层允许两者，不显示浏览器提示。首次使用时，TCC 仍会询问设备本身的访问权限，且 Info.plist 必须包含两个用途说明键。

在 Linux 上拒绝媒体采集

Linux 默认允许使用摄像头和麦克风。要停用此行为：

Permissions: map[application.PermissionType]application.Permission{
    application.PermissionMicrophone: application.PermissionDeny,
    application.PermissionCamera:     application.PermissionDeny,
},

在 Windows 上允许所有功能

要在不提示的情况下授予所有功能权限：

Permissions: map[application.PermissionType]application.Permission{
    application.PermissionMicrophone:    application.PermissionAllow,
    application.PermissionCamera:        application.PermissionAllow,
    application.PermissionGeolocation:   application.PermissionAllow,
    application.PermissionNotifications: application.PermissionAllow,
    application.PermissionClipboardRead: application.PermissionAllow,
},

按窗口设置策略

不同窗口可以使用不同的策略：

// Main app window — full media access
mainWindow := app.Window.NewWithOptions(application.WebviewWindowOptions{
    Title: "App",
    Permissions: map[application.PermissionType]application.Permission{
        application.PermissionMicrophone: application.PermissionAllow,
        application.PermissionCamera:     application.PermissionAllow,
    },
})

// Settings window — no special capabilities
settingsWindow := app.Window.NewWithOptions(application.WebviewWindowOptions{
    Title: "Settings",
    // No Permissions entry — uses platform defaults
})

// Embedded content window — deny media capture
embeddedWindow := app.Window.NewWithOptions(application.WebviewWindowOptions{
    Title: "Embedded",
    Permissions: map[application.PermissionType]application.Permission{
        application.PermissionMicrophone: application.PermissionDeny,
        application.PermissionCamera:     application.PermissionDeny,
    },
})

Windows 专用覆盖设置

按窗口设置的Windows.Permissions字段（map[CoreWebView2PermissionKind]CoreWebView2PermissionState）仍然有效，并可在应用跨平台映射后覆盖各项功能的设置。当你需要访问没有跨平台对应项的 WebView2 权限类型（例如CoreWebView2PermissionKindOtherSensors）时，请使用此字段。

Windows: application.WindowsWindow{
    Permissions: map[application.CoreWebView2PermissionKind]application.CoreWebView2PermissionState{
        application.CoreWebView2PermissionKindOtherSensors: application.CoreWebView2PermissionStateAllow,
    },
},

Windows 上的求值顺序如下：

1. 跨平台Permissions映射（通过SetPermission设置各类型的状态）
2. Windows.Permissions映射（覆盖各个类型）
3. 对于两个映射均未涵盖的类型：如果配置了策略，则显示 WebView2 的原生提示；如果未配置策略，则自动允许（旧版行为）

平台支持矩阵

macOS 列为 ✅ 时，策略回答 WebKit 请求，TCC 仍在其上控制设备。为 ❌ 时，该功能仅交由 TCC 处理。

故障排除

getUserMedia升级后在 Linux 上仍然失败

请确认你没有显式设置PermissionMicrophone: PermissionDeny或PermissionCamera: PermissionDeny。默认情况下（未设置），Linux 允许媒体采集。

Windows 正在提示授予我未配置的权限

一旦Permissions中存在任何条目，Wails 就不再设置统一的Allow授权。未列出的功能将显示 WebView2 的原生提示。请为应用使用的每项功能添加明确的PermissionAllow条目。

macOS 权限不起作用

Permissions 支持 macOS 12 及更高版本的摄像头和麦克风；地理位置、通知和剪贴板读取尚未接入，会忽略策略。TCC 仍控制设备：PermissionAllow 只移除 WebKit 提示，不移除系统提示。请检查 Info.plist 中的 NSMicrophoneUsageDescription、NSCameraUsageDescription，以及“系统设置 → 隐私与安全性”中的授权。

网页内容请求摄像头或麦克风时，macOS 应用退出

请检查 Info.plist 是否为应用请求的每种设备包含 NSCameraUsageDescription 或 NSMicrophoneUsageDescription。缺少用途说明可能导致请求被拒绝；在缺少必需说明的情况下访问 AVFoundation 可能导致应用终止。PermissionDeny 控制的是 WebKit 的决定，不能代替这些键。

地理位置、通知和剪贴板策略在 Linux 上不起作用

Linux 目前仅处理摄像头和麦克风权限。其他功能类型尚未实现支持——无论你设置何种策略，它们都仍会被拒绝。