Chuỗi tên
XR_ANDROID_mouse_interaction
Loại phần mở rộng
Tiện ích thực thể
Số điện thoại mở rộng đã đăng ký
705
Bản sửa đổi
1
Phần mở rộng và phần phụ thuộc phiên bản
Ngày sửa đổi gần đây nhất
2024-09-06
Trạng thái IP
Không có thông báo xác nhận quyền sở hữu đối với tài sản trí tuệ nào.
Cộng tác viên
Sharayu Shenoy, Google
Chiara Coetzee, Google
Levana Chen, Google
Spencer Quin, Google
Tổng quan
Tiện ích này cung cấp XrPath để nhận dữ liệu đầu vào từ chuột và xác định một tư thế hành động thường dùng cho hồ sơ chuột của người dùng, bao gồm cả thiết bị chuột và thiết bị bàn di chuột.
Tiện ích này cũng giới thiệu một hồ sơ tương tác mới được thiết kế riêng cho các thiết bị chuột để nhập thông qua hệ thống hành động OpenXR.
Tư thế hành động để tương tác bằng chuột
Tư thế hành động sau đây (tức là "nhắm mục tiêu") cho phép tia con trỏ 3D, cho dù đầu vào theo dõi do thiết bị chuột hay thiết bị bàn di chuột cung cấp.
Đường dẫn phụ của hành động …/input/aim/pose sẽ được hỗ trợ trên tất cả hồ sơ tương tác hợp lệ cho đường dẫn người dùng /user/mouse, bao gồm cả những hồ sơ tương tác được bật thông qua các tiện ích.
Tư thế nhắm
…/input/aim/pose được thiết kế để tương tác với các đối tượng thông qua con trỏ chuột trong không gian 3D. Ví dụ: việc sử dụng con trỏ laser ảo để nhắm vào một nút ảo trên tường là một hoạt động tương tác phù hợp với tư thế "nhắm".
Đây cũng là tư thế "nhắm" được xác định trong Giá trị nhận dạng tư thế chuẩn. Mọi hồ sơ tay điều khiển được theo dõi đều hỗ trợ tư thế này.
Vị trí
Vị trí của tư thế "nhắm" thường là đầu của người dùng, tức là cùng vị trí của đầu khi phát hiện thấy chuyển động của chuột. Tư thế nhắm mục tiêu cho chuột được tính toán khi có chuyển động của chuột. Vị trí nhắm mục tiêu đã biết gần đây nhất sẽ được giữ nguyên cho đến lần di chuyển chuột tiếp theo.
Hướng
Hướng của tư thế "nhắm" có thể được dùng để kết xuất tia con trỏ 3D để tương tác với một đối tượng ảo, chẳng hạn như nhấp vào nút trình đơn trên tường.
Tư thế nhắm mục tiêu cho chuột được tính toán khi có chuyển động của chuột. Hướng nhắm mục tiêu được biết gần đây nhất sẽ được giữ nguyên cho đến lần di chuyển chuột tiếp theo.
Hướng -Z là hướng về phía trước của cử chỉ nhắm, tức là nơi tia nhắm đang trỏ đến.
Chuyển động X,Y tương đối của chuột được dùng để tính toán chuyển động tương đối của chuột dọc theo một hình cầu xung quanh đầu người dùng.
Hoạt động di chuyển theo chiều sâu sẽ được hỗ trợ bằng thao tác nhấp và cuộn chính. Khi một thao tác di chuyển theo chiều sâu đang diễn ra, vị trí sẽ được bù từ vị trí đầu theo hướng Z dương hoặc âm dọc theo tia, tuỳ thuộc vào giá trị cuộn dương hoặc âm. Hệ thống sẽ ổn định chuyển động chiều sâu trong hình cầu xung quanh đầu người dùng.
Hồ sơ tương tác cho thiết bị chuột
Hồ sơ tương tác bằng chuột được thiết kế cho các môi trường thời gian chạy cung cấp dữ liệu đầu vào bằng chuột thông qua các thiết bị chuột hoặc thiết bị bàn di chuột có nút và cuộn. Điều này cho phép các thiết bị chuột và thiết bị bàn di chuột cung cấp các thao tác nhấp, cuộn và tư thế hành động thường dùng cho hệ thống hành động OpenXR.
Đường dẫn hồ sơ tương tác:
- /interaction_profiles/android/mouse_interaction
Có hiệu lực đối với đường dẫn người dùng cấp cao nhất:
- /user/mouse
Đường dẫn thành phần được hỗ trợ:
- …/input/aim/pose
- …/input/select/click
- …/input/secondary/click
- …/input/tertiary/click
- …/input/scroll/value
Hồ sơ tương tác này hỗ trợ tư thế hành động được mô tả trong phần này, cũng như hai nhóm dữ liệu đầu vào hành động sau.
Hành động nhấp
Hồ sơ tương tác này hỗ trợ các thao tác …/input/select/click, …/input/secondary/click và /input/tertiary/click.
…/input/select/click là một dữ liệu đầu vào boolean, trong đó giá trị XR_TRUE cho biết nút chính trên chuột hoặc bàn di chuột đã được nhấn.
…/input/secondary/click là một dữ liệu đầu vào boolean, trong đó giá trị XR_TRUE cho biết nút phụ trên chuột hoặc bàn di chuột đã được nhấn.
…/input/tertiary/click là một đầu vào boolean, trong đó giá trị XR_TRUE cho biết rằng bạn đã nhấn nút cuộn chuột hoặc nút phụ.
Thao tác cuộn
Hồ sơ tương tác này hỗ trợ các thao tác …/input/scroll/value.
…/input/scroll/value là một thành phần đầu vào 2D thay đổi từ -1 đến 1 để liên kết với thao tác cuộn xuống và cuộn lên.
Các loại đối tượng mới
Các loại cờ mới
Hằng số enum mới
Enum mới
Cấu trúc mới
Hàm mới
Vấn đề
Nhật ký phiên bản
- Bản sửa đổi 1, ngày 29 tháng 8 năm 2024 (Levana Chen)
- Nội dung mô tả ban đầu của tiện ích