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:

js
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:

js
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.angularVelocity Read only

Một DOMPointReadOnly mô tả vận tốc góc tính bằng radian trên giây tương đối với XRSpace cơ sở.

XRPose.emulatedPosition Read only

Giá trị Boolean là false nếu vị trí và hướng được cung cấp bởi transform đượ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ủa transform đượ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.linearVelocity Read only

Một DOMPointReadOnly mô tả vận tốc tuyến tính tính bằng mét trên giây tương đối với XRSpace cơ sở.

XRPose.transform Read only

Một XRRigidTransform cung cấp vị trí và hướng của pose tương đối với XRSpace cơ sở.

Thông số kỹ thuật

Thông số kỹ thuật
WebXR Device API
# xrpose-interface

Tương thích trình duyệt

Xem thêm