Информация об адаптере WebGPU и конфиденциальность пользователя
Узнайте, что означает адаптер WebGPU, когда он недоступен и как выбрать графический резерв без профилирования устройства.
BotBrowser Team
Нужна структурированная документация по теме Отпечатки?
Эта статья относится к редакционной библиотеке. Для пошаговой настройки, справки и постоянных обновлений переходите сразу в соответствующий раздел docs.
WebGPU позволяет приложению запросить графический адаптер, способный создать устройство WebGPU. Адаптер описывает возможность выполнить задачу, а не личность пользователя. Доступность зависит от браузера, операционной системы, графического стека, политики и текущих ресурсов. Приложение, учитывающее конфиденциальность, запрашивает только нужное для выбора режима и предлагает понятный резервный путь при ошибке. BotBrowser может согласованно представлять сведения об адаптере WebGPU одного профиля в контролируемом контексте, но не может заставить оборудование или драйвер поддерживать функции, которых у них нет.
TL;DR
navigator.gpu.requestAdapter()может вернутьnull; это ветка совместимости, а не сбой, который нужно сообщать.- Проверяйте только то, что требует выбранный режим -
adapter.features.has('timestamp-query'),adapter.limits.maxTextureDimension2D- а не все поля подряд. requestDevice({ requiredFeatures, requiredLimits })завершается ошибкой, если запрошенная функция или предел не поддерживается, поэтому запрашивайте минимум для режима.- Держите данные о возможностях в рамках сессии: не копируйте лимиты адаптера в метки аналитики, URL, записи аккаунта или тикеты поддержки.
- Выводите обязательный контент и элементы управления обычным HTML, а сокращённую сцену, статическое изображение или таблицу данных делайте документированным запасным путём.
Содержание
- Что означает адаптер
- Доступность и границы разрешений
- Решения с учётом конфиденциальности
- Резервный путь и доступное восстановление
- Планируйте запрос вокруг результата
- Храните данные возможностей временно
- Считайте сбои поведением продукта
- Итоги
Что означает адаптер
Спецификация WebGPU W3C описывает адаптер как объект, представляющий физическую или программную графическую реализацию, на основе которой можно создать устройство. Приложение запрашивает адаптер, затем устройство с нужными ограничениями и функциями. Браузер может не вернуть адаптер, а его наличие не гарантирует успешное создание устройства.
Адаптер не является инвентарём рендерера. Сначала определите видимую цель: интерактивную сцену, вычисление или упрощённый режим. Справочник WebGPU на MDN описывает открытый API, но не обещает поддержку во всех браузерах. Разницу между проверкой возможностей и отслеживанием объясняет руководство о возможностях WebGL и конфиденциальности.
Доступность и границы разрешений
navigator.gpu появляется только там, где браузер реализует и разрешает WebGPU в текущем контексте. Запрос адаптера может завершиться ошибкой или без результата. Запрос устройства тоже может не выполниться, если недоступны нужные функции, ограничения или ресурсы. Это обычные ветви совместимости, а не сведения о человеке или уникальном компьютере.
Спецификация W3C задаёт контракт API, а документация браузера описывает ограничения конкретных версий. Не утверждайте, что WebGPU доступен везде, и не обещайте обязательное окно или стабильный набор полей. Укажите проверенный диапазон браузеров и сохраните полезный путь для неподдерживаемого контекста.
Решения с учётом конфиденциальности
Используйте минимальное решение, выбирающее режим. Если достаточно знать, запускается ли устройство, сохраните только этот результат и принятие нужных функций. Не храните полное описание адаптера, не объединяйте графические сведения с данными аккаунта или сети и не превращайте различия возможностей в постоянный идентификатор. Обычно хватает решения в рамках сеанса; сохранённое качество должно быть понятным выбором пользователя, а не выводом о его устройстве.
Диагностика имеет отдельную цель. Если службе поддержки нужны дополнительные данные, объясните сбор, ограничьте доступ и задайте срок хранения. Не просите инвентарь адаптера по умолчанию. Руководство о конфиденциальности между поверхностями показывает последствия объединения сигналов.
Резервный путь и доступное восстановление
Оставляйте основной контент и элементы управления вне графической поверхности. При сбое адаптера или устройства предложите упрощённую сцену, изображение, таблицу или другое представление той же задачи. Сохраняйте фильтры и ввод, сообщайте об изменении и не оставляйте пустой холст или бесконечные повторы.
Проверьте успешный путь, отсутствие адаптера, отказ устройства, нехватку ресурсов и последующую потерю контекста. Нужен рабочий результат, а не подробное объяснение оборудования. Имена, состояния, клавиатурные команды и эквивалентные сведения размещайте в обычном HTML. Обзор WebGPU-фингерпринтинга посвящён отслеживанию; здесь рассматриваются обычные решения о возможностях.
Планируйте запрос вокруг результата
Определите владельца запроса и результат, который должен увидеть человек. Просмотрщику могут требоваться вращение и выбор, но не тени; научному инструменту нужны график и подписи, а анимация лишь улучшает вид. Видеоэффект может требовать определённую текстуру, но при сбое всё равно показать неподвижное изображение. Не запускайте WebGPU только из-за загрузки страницы: ждите открытия функции, а навигацию, аккаунт, покупки, согласие и помощь оставляйте обычным HTML.
Считайте запрос короткой операцией совместимости: подготовьте интерфейс, запросите адаптер, проверьте только функции и ограничения выбранного режима, запросите устройство и сообщите один из немногих результатов: стандартный, упрощённый, статический или недоступный с инструкцией поддержки. Если обязательная функция отсутствует, объясните недоступную пользовательскую возможность и выберите документированный нижний режим. Не исследуйте поля без продуктового вопроса и отделяйте этот случай от сетевого сбоя.
Храните данные возможностей временно
Определите срок жизни данных. Результат можно держать в памяти текущего посещения, выбрать сцену и удалить в конце сеанса. Если пользователь хочет запомнить качество, сохраняйте его явный выбор, например «упрощённые эффекты», а не набор фактов адаптера. Не копируйте объекты и списки функций в аналитику, аккаунты, URL, снимки или тикеты. Событию поддержки обычно достаточно сообщения о сбое стандартной сцены, обезличенной стадии и версии приложения.
Графические возможности не доказывают личность, местоположение, доход, инвалидность, намерение или владение устройством. Не объединяйте их с сигналами аккаунта, сети, шрифтов, хранилища или времени для построения профиля. Проверьте сторонние движки и наблюдаемость: отправляют ли они детали на сервер, необходима ли передача для отрисовки и как долго данные хранятся. Основной графический путь должен работать при отключённой необязательной телеметрии.
Считайте сбои поведением продукта
Ниже приведён пример, который проверяет только запуск пути WebGPU-устройства. Он не создаёт нагрузку рендеринга и не читает графический вывод. Замените два блока реальными представлениями; startGraphics принимает тестовый объект, поэтому случай нулевого адаптера проверяется на любой машине.
<p id="graphics-status" role="status" aria-live="polite">Подготовка графики…</p>
<section id="gpu-view" hidden>Путь WebGPU готов; пример ничего не рисует.</section>
<section id="html-view">Обычное содержимое и элементы управления доступны.</section>
<script>
const status = document.querySelector('#graphics-status');
const gpuView = document.querySelector('#gpu-view');
const htmlView = document.querySelector('#html-view');
function showFallback() {
gpuView.hidden = true;
htmlView.hidden = false;
status.textContent = 'Расширенная графика недоступна. Обычное содержимое готово.';
}
async function startGraphics(gpu = navigator.gpu) {
try {
if (!gpu) throw new Error('unavailable');
const adapter = await gpu.requestAdapter();
if (!adapter) throw new Error('unavailable');
const device = await adapter.requestDevice();
gpuView.hidden = false;
htmlView.hidden = true;
status.textContent = 'Путь WebGPU-устройства готов.';
device.lost.then(showFallback);
} catch {
showFallback();
}
}
void startGraphics();
// Тест: HTML-представление остаётся видимым, автоматической повтора нет.
// void startGraphics({ requestAdapter: async () => null });
</script>
Закомментированный тест заставляет requestAdapter() вернуть null; включите его вместо обычного вызова. Отклонённое обещание адаптера или устройства приводит к тому же резервному пути. Храните фильтры, выбор и несохранённую работу вне GPU-устройства.
| Наблюдение | Результат для пользователя | Сохранить для текущей задачи |
|---|---|---|
Нет navigator.gpu | Оставить доступным обычный HTML-интерфейс | Никаких данных адаптера |
Запрос адаптера вернул null или отклонён | Использовать описанную статическую или упрощённую замену | Максимум выбранный режим в памяти |
| Запрос устройства отклонён | Сохранить состояние и показать тот же резерв | Стадию сбоя только при необходимости поддержки |
| Созданное устройство потеряно | Вернуться к резерву и предложить осознанный повтор | Никаких объектов адаптера или устройства |
| Устройство создано | Запустить только запрошенную нагрузку | Удалить ссылку на адаптер, когда она не нужна |
Проверьте отсутствие API, нулевой или отклонённый адаптер, отклонённое устройство и потерю устройства. Проверяйте необязательную функцию только если она нужна реальной задаче; не перечисляйте функции для классификации среды. Критерий: работоспособное состояние, а не подробный отчёт об оборудовании. Внедряйте gpu и проверяйте видимый статус, не значения конкретного браузера.
Каждое состояние должно быть доступным: назовите визуальный блок по назначению, держите инструкции, цены, правовые тексты, статус и важные значения в HTML, а сброс, паузу, выбор и резерв сделайте клавиатурными элементами. Учитывайте уменьшение движения и показывайте стабильный вид. Резерв обязан использовать те же фильтры и данные, иначе два успешно отображённых представления будут противоречить друг другу.
Ограничьте восстановление. Один повтор после временной потери ресурса может быть оправдан, но бесконечные запросы задерживают пользователя и засоряют журналы. После лимита сообщите о простой сцене и оставьте страницу активной. Зафиксируйте проверенный диапазон браузеров, поколение WebGPU, функции каждого режима, резерв и ответственного. Обновление браузера является наблюдением совместимости, а не основанием для постоянного профиля.
Вычислительные задачи подчиняются тому же правилу: заранее определите результат, допустимое ожидание и не-GPU-представление. Назначьте владельцев требований, доступности, хранения и раскрытия. Для выбора, сохранённого сервисным воркером или кэшем, задайте назначение и срок действия; после очистки данных решение должно вычисляться заново. Соблюдайте административные политики и отдельно объясняйте сетевые ошибки.
Сохраняйте только операционные события с действующим владельцем: режим, стадию, грубую версию и обычную временную метку. Удаляйте объекты адаптера, полные массивы функций, идентификаторы аккаунта и посторонние сигналы. Проектируйте резерв на этапе ревью с той же иерархией и действиями. Если улучшенная графика необязательна, пусть пользователь открывает её явно и легко возвращается к стандартной странице.
Перед публикацией сверяйте утверждения с W3C и MDN. Контракт API не гарантирует результат для каждого браузера, системы или политики. Делайте обещания уже доказательств и записывайте дату, диапазон, видимый результат и владельца. При удалении функции вместе убирайте проверки адаптера, кэшированные решения, аналитические поля и инструкции поддержки.
Интерфейс должен подготовить видимое состояние до обращения к API.
Решение о возможности не разрешает идентифицировать компьютер.
Отсутствие адаптера может зависеть от текущего контекста.
Созданное устройство может потеряться после успешного запроса.
Резервный путь должен работать с клавиатурой и экранным диктором.
Короткое сообщение полезнее списка технических ограничений.
Требования сцены следует хранить вместе с описанием резервного режима.
Необязательные функции не должны незаметно становиться обязательными.
Телеметрия требует ясной цели и ограниченного доступа.
Временные данные не должны превращаться в поля аккаунта.
Политика администратора может объяснить сбой без полного отчёта о среде.
После очистки сайта решение о возможности должно вычисляться заново.
Удалённый ресурс может не загрузиться при готовом локальном адаптере.
Записывайте только стадию, нужную для ответа службе поддержки.
Проверка доступности включает и состояние ошибки.
Ограничение повторов предотвращает ожидание и шумную диагностику.
Документация должна отличать проверенное поведение от гарантии продукта.
Ответственный за резерв пересматривает его после обновлений браузера.
BotBrowser поддерживает режимы WebGPU по профилю, реальные и отключённые, чтобы согласовать поведение адаптера с выбранным профилем, но не гарантирует доступность WebGPU или одинаковые возможности адаптера на всех backend и хостах.
Источники
Итоги
Выпускайте четыре именованных результата - стандартный режим, сокращённый режим, статическая альтернатива и недоступно с инструкцией - и делайте каждый достижимым в тесте без конкретного GPU. Потерю устройства (причина destroyed или unknown) считайте восстановимым состоянием, при котором HTML-представление остаётся рабочим.
Записывайте версию браузера, графический путь хоста и профиль вместе с каждой принятой строкой и повторяйте замер после смены драйвера, браузера или образа хоста. Режим, который запускается на одной машине, - доказательство для этой строки, а не обещание для другого хоста.
Эта статья входит в руководство: Что такое отпечаток браузера?
Похожие статьи
Снятие отпечатков WebGPU: следующее поколение отслеживания GPU
ОтпечаткиWebGL: возможности, конфиденциальность и применение
ОтпечаткиПроверка приватности в разных графических backend
ОтпечаткиРазрешения Web Bluetooth, выбор устройства и конфиденциальность
ОтпечаткиПрограммный рендеринг WebGL, откат возможностей и приватность
ПлатформаВосстановление после потери устройства WebGPU
Выполните ту же проверку в BotBrowser
Загрузите профиль, сохраните внутри браузера те сигналы, о которых только что прочитали, и подтвердите результат на своей машине до раскатки.