権限

navigator.mediaDevices.getUserMedia()、Geolocation API、または Notifications API を呼び出す Web コンテンツでは、ホストアプリケーションがそれらの要求を許可または拒否する必要があります。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,
    },
})

そのウィンドウの Web コンテンツからのカメラとマイクへのアクセス要求は、ブラウザーのプロンプトを表示せずに許可されます。

権限の種類

PermissionType（uint8）は、Web コンテンツが要求できる機能を識別します。

権限の値

Permission（uint8）は、指定した種類に適用されるポリシーです。

PermissionDefault はゼロ値であるため、マップに設定されていないエントリはデフォルトとして動作します。

プラットフォームごとの動作

基盤となる WebView のネイティブ動作が異なるため、各プラットフォームでは PermissionDefault の処理方法も異なります。

Linux（WebKitGTK）

WebKitGTK にはネイティブの権限プロンプトがありません。ハンドラーが設定されていない場合、すべての要求が通知なしに拒否されます。このため、この機能が追加される前は getUserMedia が常に NotAllowedError を返していました。

現在、Wails は Linux 上でカメラとマイクへのアクセス要求を処理します。位置情報、通知、クリップボードの読み取りはまだ接続されていないため、設定したポリシーにかかわらず拒否されます。

Windows（WebView2）

WebView2 には、ネイティブの権限プロンプトと、種類ごとの権限 API があります。5 種類の機能すべてが完全にサポートされています。

重要：この機能が導入される前は、Wails は無条件に SetGlobalPermission(Allow) を呼び出し、すべての機能を通知なしに許可していました。現在は、Permissions にエントリが 1 つでも存在すると、その一括許可は設定されません。設定されていない機能は、自動的に許可されるのではなく、WebView2 のネイティブプロンプトに委ねられます。

つまり、Windows で Permissions を少しでも構成すると、明示的に指定していない機能は通知なしに許可されず、プロンプトが表示されます。必要な機能を明示的に設定してください。

macOS (WKWebView + TCC)

macOS では 2 つの層で許可が必要です。WKWebView はキャプチャ開始前にアプリケーションへ確認し、その要求に Permissions マップが応答します。その下ではプライバシーフレームワーク TCC がデバイス自体へのアクセスを制御します。アプリが実際にカメラやマイクへ初めてアクセスすると OS の確認が表示され、選択はアプリごとに「システム設定」→「プライバシーとセキュリティ」に記憶されます。

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 にエントリが1つでも存在すると、Wails は一括許可の Allow を設定しなくなります。リストに含めていない機能については、WebView2 のネイティブプロンプトが表示されます。アプリで使用するすべての機能について、明示的な PermissionAllow エントリを追加してください。

macOS のアクセス許可が機能しない

Permissions は macOS 12 以降のカメラとマイクに対応します。位置情報、通知、クリップボードの読み取りは未接続でポリシーを無視します。TCC は引き続きデバイスを制御し、PermissionAllow が省略するのは WebKit の確認であってシステムの確認ではありません。Info.plist の NSMicrophoneUsageDescription と NSCameraUsageDescription、および「システム設定」→「プライバシーとセキュリティ」の許可を確認してください。

Web コンテンツがカメラやマイクを要求すると macOS アプリが終了する

アプリが要求する各デバイスについて、Info.plist に NSCameraUsageDescription または NSMicrophoneUsageDescription が含まれているか確認してください。説明がないと要求が拒否される場合があり、必須の説明なしで AVFoundation にアクセスするとアプリが終了する場合があります。PermissionDeny は WebKit の判断を制御するもので、これらのキーの代わりにはなりません。

Linux で位置情報／通知／クリップボードが機能しない

現在、Linux で処理されるのはカメラとマイクのみです。その他の機能タイプへの対応はまだ実装されていません。設定したポリシーにかかわらず、これらは拒否されたままになります。