Разрешения

Веб-контенту, который вызывает navigator.mediaDevices.getUserMedia(), API геолокации или API уведомлений, требуется, чтобы основное приложение разрешало или отклоняло эти запросы. Wails предоставляет кроссплатформенную карту Permissions в WebviewWindowOptions, которая позволяет управлять этим декларативно — без платформозависимого кода.

Быстрый старт

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 — нулевое значение, поэтому отсутствующие в карте записи обрабатываются по умолчанию.

Поведение на разных платформах

Каждая платформа обрабатывает PermissionDefault по-своему, поскольку лежащие в их основе веб-представления имеют разное встроенное поведение.

Linux (WebKitGTK)

В 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 разрешает запрос веб-представления, а не доступ к устройству. Системная авторизация действует независимо: приложение, которому отказано в системных настройках, остаётся без доступа. Пропускается только собственный запрос 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, но не системный. Проверьте ключи NSMicrophoneUsageDescription и NSCameraUsageDescription в Info.plist и разрешение в «Системные настройки» → «Конфиденциальность и безопасность».

Приложение macOS завершается, когда веб-контент запрашивает камеру или микрофон

Убедитесь, что Info.plist содержит NSCameraUsageDescription или NSMicrophoneUsageDescription для каждого запрашиваемого устройства. Отсутствие описания может привести к отклонению запроса; обращение к AVFoundation без обязательного описания может завершить приложение. PermissionDeny управляет решением WebKit и не заменяет эти ключи.

Геолокация, уведомления и буфер обмена не работают в Linux

В настоящее время в Linux обрабатывается только доступ к камере и микрофону. Поддержка других типов возможностей ещё не реализована — они остаются запрещёнными независимо от заданной политики.