權限

呼叫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 僅處理攝影機和麥克風。其他功能類型尚未實作支援；無論設定何種原則，這些功能仍會遭到拒絕。