Cảnh tạo dạng duy trì biểu đồ cảnh, một tổ chức phân cấp của nội dung của cảnh. Một cảnh có thể có không hoặc nhiều nút con và mỗi nút có thể có không hoặc nhiều nút con.
Cảnh cũng cung cấp kiểm thử lượt truy cập, một cách để phát hiện nút nào được chạm vào bằng MotionEvent hoặc Ray.
Các lớp học lồng ghép
| giao diện | Scene.OnPeekTouchListener | Định nghĩa giao diện cho lệnh gọi lại được gọi khi một sự kiện chạm được gửi đến một cảnh. | |
| giao diện | Scene.OnTouchListener | Định nghĩa giao diện cho lệnh gọi lại được gọi khi một sự kiện chạm được gửi đến một cảnh. | |
| giao diện | Scene.OnUpdateListener | Định nghĩa giao diện cho lệnh gọi lại được gọi một lần cho mỗi khung ngay trước khi cảnh được cập nhật. | |
Các trường
| public static final EnvironmentalHdrParameters | DEFAULT_HDR_INFORMATIONS |
Xây dựng công cộng
Phương thức công khai
| void |
addOnPeekTouchListener(Scene.OnPeekTouchListener trênPeekTouchListener)
Thêm trình nghe sẽ được gọi trước khi gọi
Scene.OnTouchListener. |
| void |
addOnUpdateListener(Scene.OnUpdateListener trênUpdateListener)
Thêm trình nghe sẽ được gọi một lần trên mỗi khung ngay trước khi Cảnh được cập nhật.
|
| Máy ảnh |
getCamera()
Sử dụng máy ảnh dùng để kết xuất cảnh.
|
| Nút |
getSunlight()
Lấy nút ánh sáng mặt trời mặc định.
|
| Chế độ xem cảnh báo |
getView()
Trả về SceneView dùng để tạo cảnh.
|
| Kết quả HitTest |
hitTest(MotionEvent MotionEvent)
Các thử nghiệm để xem liệu một sự kiện chuyển động có đang chạm vào bất kỳ nút nào trong cảnh hay không, dựa trên một bài kiểm tra lượt truy cập
có nguồn gốc là vị trí màn hình của sự kiện chuyển động, và xuất ra một TestTestResult chứa
nút gần màn hình nhất.
|
| Kết quả HitTest | |
| ArrayList<HitTestResult> |
hitTestAll(Ray)
Kiểm tra xem liệu một tia có đang nhấn vào bất kỳ nút nào trong cảnh hay không và trả về danh sách các HitTestResult chứa tất cả các nút đã được truy cập, được sắp xếp theo khoảng cách.
|
| ArrayList<HitTestResult> |
hitTestAll(MotionEvent MotionEvent)
Kiểm tra xem một sự kiện chuyển động có đang chạm vào bất kỳ nút nào trong cảnh hay không và trả về danh sách các
HitTestResult chứa tất cả các nút đã được truy cập, được sắp xếp theo khoảng cách.
|
| void |
onAddChild(Nút con)
|
| void |
onRemoveChild(Nút con)
|
| Nút |
overlapTest(Nút nút)
Kiểm tra xem hình dạng va chạm của nút đã cho có trùng lặp với hình dạng va chạm của bất kỳ nút nào khác trong cảnh hay không bằng cách sử dụng
getCollisionShape(). |
| ArrayList<Nút> |
overlapTestAll(Nút nút)
Kiểm tra xem một nút có trùng lặp với bất kỳ nút nào khác trong cảnh bằng cách sử dụng
getCollisionShape() hay không. |
| void |
removeOnPeekTouchListener(Scene.OnPeekTouchListener trênPeekTouchListener)
Xoá một trình nghe sẽ được gọi trước khi gọi
Scene.OnTouchListener. |
| void |
removeOnUpdateListener(Scene.OnUpdateListener trênUpdateListener)
Xoá một trình nghe sẽ được gọi một lần trên mỗi khung hình ngay trước khi Cảnh được cập nhật.
|
| void |
setLightƯớc tính(Màu màu, float pixelIntensity)
Đặt ước tính ánh sáng để điều chỉnh ánh sáng và cường độ cảnh.
|
| void |
setOnTouchListener(Scene.OnTouchListener onTouchListener)
Đăng ký một lệnh gọi lại được gọi khi chạm vào cảnh.
|
Các phương thức kế thừa
Các trường
public static final EnvironmentalHdrParameters DEFAULT_HDR_INFORMATIONS
Xây dựng công cộng
Phương thức công khai
public void addOnPeekTouchListener (Scene.OnPeekTouchListener onPeekTouchListener)
Thêm trình nghe sẽ được gọi trước khi gọi Scene.OnTouchListener. Lệnh này được gọi ngay cả khi cử chỉ đã được sử dụng, giúp bạn có thể quan sát tất cả các sự kiện chuyển động được gửi đến cảnh. Lệnh này được gọi ngay cả khi thao tác chạm không nằm trên một nút. Trong trường hợp này, getNode() sẽ rỗng. Trình nghe sẽ được gọi theo thứ tự thêm vào.
Các tham số
| onPeekTouchListener | trình nghe bằng cách chạm vào để thêm |
|---|
public void addOnUpdateListener (Scene.OnUpdateListener onUpdateListener)
Thêm trình nghe sẽ được gọi một lần trên mỗi khung ngay trước khi Cảnh được cập nhật. Trình nghe này sẽ được gọi theo thứ tự thêm vào.
Các tham số
| onUpdateListener | trình nghe cập nhật cần thêm |
|---|
công khai Máy ảnh getCamera ()
Sử dụng máy ảnh dùng để kết xuất cảnh. Máy ảnh là một loại nút.
Trả về
- máy ảnh dùng để kết xuất cảnh
public Nút getSunlight ()
Lấy nút ánh sáng mặt trời mặc định.
Trả về
- nút ánh sáng mặt trời dùng để chiếu sáng cảnh
public HitTestResult hitTest (MotionEvent MotionEvent)
Các thử nghiệm để xem liệu một sự kiện chuyển động có đang chạm vào bất kỳ nút nào trong cảnh hay không, dựa trên một bài kiểm tra lượt truy cập có nguồn gốc là vị trí màn hình của sự kiện chuyển động, và xuất ra một TestTestResult chứa nút gần màn hình nhất.
Các tham số
| Sự kiện chuyển động | sự kiện chuyển động mà bạn nên sử dụng để kiểm thử |
|---|
Trả về
- kết quả bao gồm nút đầu tiên bị sự kiện chuyển động nhấn (có thể có giá trị rỗng) và thông tin về nơi sự kiện chuyển động nhấn nút trong không gian thế giới
public HitTestResult hitTest (Ray tia)
Kiểm tra xem liệu một tia có đang nhấn vào bất kỳ nút nào trong cảnh và xuất ra một TestTestResult chứa nút gần với điểm gốc giao cắt với tia đó hay không.
Các tham số
| ray | tia dùng để kiểm thử |
|---|
Trả về
- kết quả bao gồm nút đầu tiên bị nhấn bởi tia (có thể có giá trị rỗng) và thông tin về vị trí tia gặp nút trong không gian thế giới
Xem thêm
public ArrayList<HitTestResult> hitTestAll (Ray tia)
Kiểm tra xem liệu một tia có đang nhấn vào bất kỳ nút nào trong cảnh hay không và trả về danh sách các HitTestResult chứa tất cả các nút đã được truy cập, được sắp xếp theo khoảng cách.
Các tham số
| ray | tia để sử dụng cho kiểm thử. |
|---|
Trả về
- Được điền sẵn bằng HitTestResult cho mỗi nút đã được truy cập được sắp xếp theo khoảng cách. Trống nếu không có nút nào được nhấn.
Xem thêm
public ArrayList<HitTestResult> hitTestAll (MotionEvent MotionEvent)
Kiểm tra xem một sự kiện chuyển động có đang chạm vào bất kỳ nút nào trong cảnh hay không và trả về danh sách các HitTestResult chứa tất cả các nút đã được truy cập, được sắp xếp theo khoảng cách.
Các tham số
| Sự kiện chuyển động | Sự kiện chuyển động cần dùng cho kiểm thử. |
|---|
Trả về
- Được điền sẵn bằng HitTestResult cho mỗi nút đã được truy cập được sắp xếp theo khoảng cách. Trống nếu không có nút nào được nhấn.
công khai Nút overlapTest (NodeNode)
Kiểm tra xem hình dạng va chạm của nút đã cho có trùng lặp với hình dạng va chạm của bất kỳ nút nào khác trong cảnh hay không bằng cách sử dụng getCollisionShape(). Nút dùng để kiểm thử không cần phải hoạt động.
Các tham số
| nút | Nút dùng cho kiểm thử. |
|---|
Trả về
- Một nút chồng lên nút kiểm thử. Nếu không có nút nào chồng lên nút kiểm thử, thì giá trị này sẽ rỗng. Nếu có nhiều nút chồng lên nút kiểm thử, thì có thể là bất kỳ nút nào trong số đó.
Xem thêm
public ArrayList<Node> overlapTestAll (Nút)
Kiểm tra xem một nút có trùng lặp với bất kỳ nút nào khác trong cảnh bằng cách sử dụng getCollisionShape() hay không. Nút dùng để kiểm thử không cần phải hoạt động.
Các tham số
| nút | Nút dùng cho kiểm thử. |
|---|
Trả về
- Danh sách tất cả các nút đang trùng lặp nút thử nghiệm. Nếu không có nút nào chồng lên nút kiểm thử, thì danh sách sẽ trống.
Xem thêm
public void removeOnPeekTouchListener (Scene.OnPeekTouchListener onPeekTouchListener)
Xoá một trình nghe sẽ được gọi trước khi gọi Scene.OnTouchListener.
Lệnh này được gọi ngay cả khi cử chỉ đã được sử dụng, giúp bạn có thể quan sát tất cả các sự kiện chuyển động được gửi đến cảnh. Lệnh này được gọi ngay cả khi thao tác chạm không nằm trên một nút. Trong trường hợp này, getNode() sẽ là rỗng.
Các tham số
| onPeekTouchListener | trình nghe bằng cách chạm vào để xóa |
|---|
public void removeOnUpdateListener (Scene.OnUpdateListener onUpdateListener)
Xoá một trình nghe sẽ được gọi một lần trên mỗi khung hình ngay trước khi Cảnh được cập nhật.
Các tham số
| onUpdateListener | trình nghe bản cập nhật cần xoá |
|---|
public void setLightEstimated (Màu colorcorrection, float pixelIntensity)
Đặt ước tính ánh sáng để điều chỉnh ánh sáng và cường độ cảnh. Ánh sáng kết xuất sẽ sử dụng kết hợp những giá trị này, màu sắc và cường độ của đèn. Giá trị của colorwhiteion và pixelIntensity màu trắng có nghĩa là không có thay đổi nào đối với chế độ cài đặt ánh sáng.
Tính năng này được các cảnh quay AR sử dụng nội bộ để điều chỉnh độ sáng dựa trên giá trị từ ARCore. Cảnh thực tế tăng cường sẽ tự động gọi cảnh này và có thể ghi đè các chế độ cài đặt khác. Trong hầu hết trường hợp, bạn không cần phải gọi loại này một cách rõ ràng.
Các tham số
| Chỉnh màu | điều chỉnh màu ánh sáng của cảnh. |
|---|---|
| Cường độ pixel | điều chỉnh cường độ ánh sáng của cảnh. |
public void setOnTouchListener (Scene.OnTouchListener onTouchListener)
Đăng ký một lệnh gọi lại được gọi khi chạm vào cảnh. Lệnh gọi lại sẽ được gọi sau khi sự kiện nhấn được gửi đến các nút trong cảnh nếu không có nút nào sử dụng sự kiện. Phương thức này được gọi ngay cả khi thao tác chạm không nằm trên một nút. Trong trường hợp này, getNode() sẽ là rỗng.
Các tham số
| onTouchListener | trình nghe thao tác chạm để đính kèm |
|---|