XRInputSource

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

gamepad Read only

Một đối tượng Gamepad mô tả trạng thái của các nút và trục trên nguồn đầu vào XR, nếu đó là gamepad hoặc thiết bị tương tự. Nếu thiết bị không phải là thiết bị giống gamepad, giá trị của thuộc tính này là null.

gripSpace Read only

Một XRSpace có gốc bản địa theo dõi tư thế dùng để kết xuất các đối tượng ảo sao cho chúng trông như được cầm trong tay được chỉ ra bởi handedness. Hướng của không gian này cho biết góc mà tay đang cầm đối tượng. Đọc thêm trong bài viết chính về gripSpace để biết thêm chi tiết về cách sử dụng không gian này.

hand Read only

Một đối tượng XRHand cung cấp quyền truy cập vào thiết bị theo dõi tay cơ bản.

handedness Read only

Một chuỗi cho biết tay nào của người dùng đang dùng thiết bị được đại diện bởi XRInputSource này, nếu có. Giá trị sẽ là left, right hoặc none.

profiles Read only

Một mảng các chuỗi, mỗi chuỗi chỉ định tên của một hồ sơ đầu vào mô tả cách trình bày trực quan và hành vi ưa thích của nguồn đầu vào này.

targetRayMode Read only

Một chuỗi cho biết phương pháp được sử dụng để tạo tia mục tiêu: gaze, tracked-pointer hoặc screen.

targetRaySpace Read only

Một đối tượng XRSpace xác định gốc của tia mục tiêu và hướng nó mở rộng. Không gian này được thiết lập bằng phương pháp được định nghĩa bởi targetRayMode.

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

Giao diện XRInputSource không định nghĩa phương thức nào.

Ghi chú sử dụng

Hành động và tia mục tiêu

Nếu thiết bị cung cấp chỉ báo về hướng nó đang nhắm, điều này được thực hiện bằng tia mục tiêu. Đây là tia mở rộng từ vị trí của thiết bị ra ngoài theo hướng nó đang nhắm.

Tia mục tiêu phát ra từ bộ điều khiển tay.

Nếu thiết bị bao gồm cò súng hoặc đầu vào có thể bóp khác, chẳng hạn như thiết bị cử chỉ tay nhận biết khi người dùng nắm chặt tay, hành động đó được gọi là hành động bóp chính. Hành động bóp chính nên tương ứng với một hành động cầm nắm trong thực tế, chẳng hạn như cầm một đối tượng hoặc nhấn cò súng trên một công cụ hoặc vũ khí. Khi hành động bóp bắt đầu, như khi người dùng nhấn cò hoặc siết chặt tay, sự kiện squeezestart được gửi đến XRSession. Khi hành động hoàn thành và người dùng đã nhả cò hoặc nắm tay, sự kiện squeeze được gửi. Tiếp theo là squeezeend, cũng được gửi nếu hành động bị hủy bỏ thay vì hoàn thành.

Nếu thiết bị có nút hoặc điều khiển đầu vào có thể nhấn khác, đó là nguồn đầu vào chính và nút này là hành động chính. Hành động chính có thể xảy ra khi người dùng nhấn nút, nhấp trên touchpad hoặc nút đầu cần joystick, hoặc sử dụng cử chỉ tay hoặc lệnh giọng nói gọi ra hành động giống nút. Khi hành động chính bắt đầu, sự kiện selectstart được gửi đến XRSession. Khi hành động hoàn thành (chẳng hạn khi người dùng nhả nút), sự kiện select được gửi. Cuối cùng, sau khi hoàn thành hoặc nếu người dùng hủy bỏ hành động, sự kiện selectend được gửi đến đối tượng session.

Hành động có thể bị hủy bỏ bởi người dùng theo cách dành riêng cho thiết bị hoặc nếu thiết bị đầu vào bị ngắt kết nối trước khi hành động hoàn thành.

Hệ tọa độ cục bộ

Mỗi nguồn đầu vào có hệ tọa độ cục bộ riêng, được mô tả bởi thuộc tính gripSpace, là một XRSpace dùng để ánh xạ hệ tọa độ đầu vào vào hệ tọa độ thế giới. Hệ tọa độ của không gian grip sau đó có thể được sử dụng để kết xuất các đối tượng sao cho chúng trông như được cầm trong tay người dùng.

Để biết thêm chi tiết về hệ tọa độ của nguồn đầu vào, xem bài viết đề cập chi tiết thuộc tính gripSpace.

Thông số kỹ thuật

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

Xem thêm

• WebXR Device API
• Đầu vào và nguồn đầu vào
• XRInputSourceArray
• XRSpace