XRFrame: метод getDepthInformation()
Ограниченная доступность
Эта функция не относится к Baseline, так как она не работает во всех широко используемых браузерах.
Экспериментальная: Это экспериментальная технология
Перед использованием в рабочей среде внимательно проверьте таблицу совместимости браузеров.
Безопасный контекст: Эта функция доступна только в безопасных контекстах (HTTPS) в некоторых или во всех поддерживающих браузерах.
Метод getDepthInformation() интерфейса XRFrame возвращает объект XRCPUDepthInformation, содержащий информацию о глубине, рассчитанной процессором, для активного и анимированного кадра.
Синтаксис
getDepthInformation(view)
Параметры
Возвращаемое значение
Объект XRCPUDepthInformation.
Исключения
-
NotSupportedErrorDOMException -
Выбрасывается, если
"depth-sensing"не входит в список разрешенных функций для даннойXRSession. -
InvalidStateErrorDOMException -
Выбрасывается, если:
- данный
XRFrameне активен и не анимирован. Получение информации о глубине допустимо только внутри обратного вызоваrequestAnimationFrame(). - параметр
depthUsageсессии не"cpu-optimized".
- данный
Примеры
Получение информации о глубине, рассчитанной процессором
// Make sure to request a session with depth-sensing enabled
const session = navigator.xr.requestSession("immersive-ar", {
requiredFeatures: ["depth-sensing"],
depthSensing: {
usagePreference: ["cpu-optimized", "gpu-optimized"],
formatPreference: ["luminance-alpha", "float32"],
},
});
// …
// Obtain depth information in an active and animated frame
function rafCallback(time, frame) {
session.requestAnimationFrame(rafCallback);
const pose = frame.getViewerPose(referenceSpace);
if (pose) {
for (const view of pose.views) {
const depthInformation = frame.getDepthInformation(view);
if (depthInformation) {
// Do something with the depth information
renderDepth(depthInformation);
}
}
}
}
Спецификации
Совместимость браузеров
| Рабочие столы | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на iOS | Samsung Internet | WebView Android | |
getDepthInformation |
90 | 90 | Нет | 76 | Нет | 90 | Нет | 64 | Нет | 15.0 | Нет |
© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/XRFrame/getDepthInformation