Назад в Центр знаний
Отпечатки

Информация об адаптере WebGPU и конфиденциальность пользователя

Узнайте, что означает адаптер WebGPU, когда он недоступен и как выбрать графический резерв без профилирования устройства.

BotBrowser Team

Документация

Нужна структурированная документация по теме Отпечатки?

Эта статья относится к редакционной библиотеке. Для пошаговой настройки, справки и постоянных обновлений переходите сразу в соответствующий раздел docs.

WebGPU позволяет приложению запросить графический адаптер, способный создать устройство WebGPU. Адаптер описывает возможность выполнить задачу, а не личность пользователя. Доступность зависит от браузера, операционной системы, графического стека, политики и текущих ресурсов. Приложение, учитывающее конфиденциальность, запрашивает только нужное для выбора режима и предлагает понятный резервный путь при ошибке. BotBrowser может согласованно представлять сведения об адаптере WebGPU одного профиля в контролируемом контексте, но не может заставить оборудование или драйвер поддерживать функции, которых у них нет.

Поток запроса адаптера 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#Адаптер#Конфиденциальность#Возможности#Резервный Режим

Эта статья входит в руководство: Что такое отпечаток браузера?

Выполните ту же проверку в BotBrowser

Загрузите профиль, сохраните внутри браузера те сигналы, о которых только что прочитали, и подтвердите результат на своей машине до раскатки.