XRSession: метод requestLightProbe()

Метод requestLightProbe() интерфейса XRSession возвращает Promise, который разрешается объектом XRLightProbe, оценивающим информацию об освещении в заданной точке среды пользователя.

options Необязательно

Объект, содержащий параметры конфигурации, а именно:

reflectionFormat

Внутренний формат отражения, указывающий, как представлены данные текстуры, либо srgba8 (значение по умолчанию), либо rgba16f. См. также XRSession.preferredReflectionFormat.

A Promise, разрешаемый объектом XRLightProbe.

Вместо генерации истинных исключений, requestLightProbe() отклоняет возвращённую промисс с DOMException, а именно, одним из следующих:

NotSupportedError DOMException

Генерируется, если lighting-estimation не является включенной функцией в XRSystem.requestSession() или если reflectionFormat не соответствует srgb8 или preferredReflectionFormat.

InvalidStateError DOMException

Генерируется, если сессия уже завершена.

Формат по умолчанию — srgb8, однако некоторые движки рендеринга могут использовать другие форматы (с высокой динамической широтой). Вы можете запросить зонд освещения с помощью XRSession.preferredReflectionFormat, который сообщает о предпочтительном внутреннем формате.

const lightProbe = await xrSession.requestLightProbe({
  reflectionFormat: xrSession.preferredReflectionFormat,
});

• XRSession.preferredReflectionFormat