1. Web
  2. Web API
  3. XRFrame

XRFrame

Limited availability

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.

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

Đối tượng XRFrame của WebXR Device API được truyền vào hàm callback của requestAnimationFrame() và cung cấp quyền truy cập thông tin cần thiết để kết xuất một khung hoạt ảnh cho một XRSession mô tả cảnh VR hoặc AR. Các sự kiện thông báo trạng thái theo dõi của các đối tượng cũng cung cấp tham chiếu XRFrame như một phần cấu trúc của chúng.

Ngoài việc cung cấp tham chiếu đến XRSession mà khung này được kết xuất, phương thức getViewerPose() được cung cấp để lấy XRViewerPose mô tả vị trí và hướng của người xem trong không gian, và getPose() có thể được dùng để tạo một XRPose mô tả vị trí tương đối của một XRSpace so với không gian khác.

Thuộc tính phiên bản

session Read only

XRSession mà XRFrame này mô tả thông tin theo dõi cho tất cả các đối tượng. Thông tin về một đối tượng cụ thể có thể được lấy bằng cách gọi một trong các phương thức trên đối tượng đó.

trackedAnchors Read only

Một XRAnchorSet chứa tất cả các neo vẫn còn được theo dõi trong khung.

Phương thức phiên bản

createAnchor()

Trả về một Promise được giải quyết thành một đối tượng XRAnchor nổi tự do.

fillJointRadii()

Điền một Float32Array với bán kính cho danh sách các không gian khớp tay. Trả về true nếu thành công cho tất cả các không gian.

fillPoses()

Điền một Float32Array với các ma trận tư thế, tương đối với không gian cơ sở cho trước. Trả về true nếu tất cả các không gian có tư thế hợp lệ.

getDepthInformation()

Trả về một đối tượng XRCPUDepthInformation chứa thông tin độ sâu CPU cho khung.

getHitTestResults()

Trả về một mảng các đối tượng XRHitTestResult chứa kết quả kiểm tra va chạm cho một XRHitTestSource cho trước.

getHitTestResultsForTransientInput()

Trả về một mảng các đối tượng XRTransientInputHitTestResult chứa kết quả kiểm tra va chạm cho một XRTransientInputHitTestSource cho trước.

getJointPose()

Trả về một đối tượng XRJointPose cung cấp tư thế của một khớp tay (xem XRHand) tương đối với không gian cơ sở cho trước.

getLightEstimate()

Trả về một đối tượng XRLightEstimate chứa các giá trị ánh sáng ước tính cho một XRLightProbe.

getPose()

Trả về một đối tượng XRPose đại diện cho quan hệ không gian giữa hai đối tượng XRSpace được chỉ định.

getViewerPose()

Trả về một XRViewerPose mô tả vị trí và hướng của người xem trong một XRReferenceSpace cho trước.

Thông số kỹ thuật

Specification
WebXR Device API
# xrframe-interface

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

Xem thêm

Help improve MDN

Learn how to contribute

This page was last modified on by MDN contributors.

View this page on GitHub • Report a problem with this content