XRPose
Khả dụng hạn chế
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
XRPose là giao diện của WebXR API biểu diễn vị trí và hướng trong không gian 3D, tương đối với XRSpace mà nó tồn tại trong đó. XRSpace (có thể là XRReferenceSpace hoặc XRBoundedReferenceSpace) xác định hệ tọa độ được sử dụng cho pose và, trong trường hợp của XRViewerPose, các khung nhìn cơ sở của nó.
Để lấy XRPose cho XRSpace được sử dụng làm hệ tọa độ cục bộ của một đối tượng, hãy gọi XRFrame.getPose(), chỉ định XRSpace cục bộ đó và không gian mà bạn muốn chuyển đổi sang:
thePose = xrFrame.getPose(localSpace, baseSpace);
Pose của người xem (hoặc camera) được biểu diễn bằng lớp con XRViewerPose của XRPose. Lớp này được lấy bằng cách sử dụng XRFrame.getViewerPose() thay vì getPose(), chỉ định một không gian tham chiếu đã được điều chỉnh để định vị và định hướng nút nhằm cung cấp vị trí và góc nhìn mong muốn:
viewerPose = xrFrame.getViewerPose(adjReferenceSpace);
Ở đây, adjReferenceSpace là không gian tham chiếu đã được cập nhật bằng khung tham chiếu cơ sở cho khung hình và các điều chỉnh cần thiết để định vị người xem dựa trên chuyển động hoặc xoay được cung cấp từ nguồn khác ngoài thiết bị XR, chẳng hạn như đầu vào từ bàn phím hoặc chuột.
Xem bài viết Chuyển động, hướng và chuyển động để biết thêm chi tiết và ví dụ với giải thích đầy đủ.
Thuộc tính phiên bản
XRPose.angularVelocityRead only-
Một
DOMPointReadOnlymô tả vận tốc góc tính bằng radian trên giây tương đối vớiXRSpacecơ sở. XRPose.emulatedPositionRead only-
Giá trị Boolean là
falsenếu vị trí và hướng được cung cấp bởitransformđược lấy trực tiếp từ thiết bị XR sáu bậc tự do (6DoF) hoàn chỉnh (tức là thiết bị theo dõi không chỉ pitch, yaw và roll của đầu mà còn cả chuyển động tiến, lùi và sang ngang của người xem). Nếu bất kỳ thành phần nào củatransformđược tính toán hoặc tạo ra nhân tạo (chẳng hạn bằng cách sử dụng điều khiển chuột hoặc bàn phím để di chuyển trong không gian), giá trị này làtrue. XRPose.linearVelocityRead only-
Một
DOMPointReadOnlymô tả vận tốc tuyến tính tính bằng mét trên giây tương đối vớiXRSpacecơ sở. XRPose.transformRead only-
Một
XRRigidTransformcung cấp vị trí và hướng của pose tương đối vớiXRSpacecơ sở.
Thông số kỹ thuật
| Thông số kỹ thuật |
|---|
| WebXR Device API> # xrpose-interface> |