Máy ảnh

lớp công khai Máy ảnh

Tượng trưng cho máy ảnh ảo, giúp xác định góc nhìn của cảnh đó.

Nếu máy ảnh thuộc ArSceneView, thì máy ảnh sẽ tự động theo dõi tư thế máy ảnh từ ARCore. Ngoài ra, các phương thức sau sẽ gửi UnsupportedOperationException khi được gọi:

• setParent(NodeParent) – Không thể thay đổi chế độ cài đặt của cha mẹ vì camera luôn là cảnh.
• setLocalPosition(Vector3) – Vị trí của máy ảnh không thể thay đổi do máy ảnh ARCore kiểm soát.
• setLocalRotation(Quaternion) – Bạn không thể thay đổi chế độ xoay của máy ảnh. Chế độ này chịu sự kiểm soát của tư thế máy ảnh ARCore.
• setWorldPosition(Vector3) – Vị trí của máy ảnh không thể thay đổi do máy ảnh ARCore kiểm soát.
• setWorldRotation(Quaternion) – Bạn không thể thay đổi chế độ xoay của máy ảnh. Chế độ này chịu sự kiểm soát của tư thế máy ảnh ARCore.

Mọi chức năng khác trong Node đều được hỗ trợ. Bạn có thể truy cập vào vị trí và chế độ xoay của máy ảnh, chỉ định hình dạng xung đột cho máy ảnh hoặc thêm trẻ em vào máy ảnh. Khi bạn tắt máy ảnh, tính năng kết xuất sẽ bị tắt.

Phương thức công khai

số thực dấu phẩy động	getFarClipPlane()
số thực dấu phẩy động	getNearClipPlane()
số thực dấu phẩy động	getVerticalFovdegrees() Lấy trường nhìn dọc của máy ảnh.
Ray	screenPointToRay(float x, float y) Tính toán một tia trong không gian thế giới đi từ mặt phẳng gần của máy ảnh và đi qua một điểm trong không gian màn hình.
void	setLocalPosition(vị trí Vector3) Đặt vị trí của máy ảnh.
void	setLocalRotation(Xoay Quaternion) Đặt chế độ xoay của máy ảnh.
void	setParent(Phần tử mẹ của NodeParent) Hoạt động không được hỗ trợ.
void	setVerticalFovDegrees(float verticalFov) Đặt trường nhìn dọc cho máy ảnh không phải máy ảnh theo độ.
void	setWorldPosition(Vị trí vectơ3) Đặt vị trí của máy ảnh.
void	setWorldRotation(Quaternion xoay) Đặt chế độ xoay của máy ảnh.
Vector3	worldToScreenPoint(Điểm vectơ 3) Chuyển đổi một điểm từ không gian thế giới thành không gian màn hình.

Các phương thức kế thừa

Từ lớp com.google.ar.sceneform.Node

void	addLifecycleListener(Node.LifecycleListener lifecycleListener) Thêm trình nghe sẽ được gọi khi các sự kiện trong vòng đời của nút xảy ra.
void	addTransformChangedListener(Node.TransformChangedListener conversionChangedListener) Thêm trình nghe sẽ được gọi khi lượt chuyển đổi của nút thay đổi.
void	callOnHierarchy(Người tiêu dùng<Nút> người tiêu dùng) Truyền tải hệ phân cấp và gọi một phương thức trên mỗi nút (bao gồm cả nút này).
boolean cuối cùng	canAddChild(Phần tử con Node, StringBuilder lỗi)
Nút	findInHierarchy(Predicate<Node> điều kiện) Truyền tải hệ phân cấp để tìm nút đầu tiên (bao gồm nút này) đáp ứng điều kiện.
Final Vector3	getBack() Lấy vectơ không gian thế giới (+z) của nút này.
CollisionShape	getCollisionShape() Nhận hình dạng để sử dụng cho các xung đột với nút này.
Final Vector3	getDown() Lấy vectơ không gian thế giới (-y) của nút này.
Final Vector3	getforward() Lấy vectơ chuyển tiếp không gian thế giới (-z) của nút này.
Final Vector3	getLeft() Lấy vectơ không gian bên trái thế giới (-x) của nút này.
Sáng	getLight() Nhận ánh sáng hiện tại có thể thay đổi.
Final Vector3	getLocalPosition () Nhận bản sao của các vị trí nút liên quan đến mạng gốc (không gian cục bộ).
Cuối cùng	getLocalRotation () Nhận bản sao của chế độ xoay vòng các nút liên quan đến mạng mẹ (địa phương-không gian).
Final Vector3	getLocalScale() Nhận bản sao của các thang điểm tương ứng với phần tử mẹ (không gian cục bộ).
String (Chuỗi) cuối cùng	getName() Trả về tên của nút.
Node cuối cùng	getParent() Trả về cha mẹ của nút này.
Hiển thị	getRenderable() Hiển thị nội dung có thể kết xuất để hiển thị cho nút này.
Final Vector3	getRight () Lấy vectơ không gian thế giới (+x) của nút này.
Cuối cùng Cảnh	getScene() Trả về cảnh mà nút này thuộc, rỗng nếu nút này không phải là một phần của bất kỳ cảnh nào.
Final Vector3	getUp() Lấy vectơ không gian thế giới (+y) của nút này.
Final Vector3	getWorldPosition () Nhận bản sao của các nút không gian thế giới-không gian.
Cuối cùng	getWorldRotation () Nhận bản sao của các nút xoay không gian thế giới của các nút.
Final Vector3	getWorldScale() Nhận bản sao của các nút không gian thế giới của quy mô nút.
boolean cuối cùng	isActive() Trả về true nếu nút này đang hoạt động.
boolean cuối cùng	isDescendantOf(tổ chức NodeParent) Kiểm tra xem lớp mẹ nút đã cho có phải là đối tượng cấp trên của nút này một cách định kỳ hay không.
boolean cuối cùng	isEnabled() Nhận trạng thái bật của nút này.
boolean	isTopLevel() Trả về true nếu nút này ở cấp cao nhất.
Final Vector3	localToWorldDirection(hướng Vector3) Chuyển đổi hướng từ không gian cục bộ của nút này sang không gian thế giới.
Final Vector3	localToWorldPoint(Điểm vectơ 3) Chuyển đổi một điểm trong không gian cục bộ của không gian này thành nút không gian.
void	onActivate() Xử lý khi nút này hoạt động.
khoảng trống cuối cùng	onAddChild(Nút con)
void	onDisable() Xử lý khi nút này bị vô hiệu hoá.
khoảng trống cuối cùng	onRemoveChild(Nút con)
boolean	onTouchEvent(HitTestResult HitTestResult, MotionEvent MotionEvent) Xử lý khi nút này được chạm vào.
void	onTransformChange(Nút nativeNode) Xử lý khi việc chuyển đổi nút này thay đổi.
void	onUpdate(FrameTime frameTime) Xử lý khi nút này được cập nhật.
void	removeLifecycleListener(Node.LifecycleListener lifecycleListener) Xoá một trình nghe sẽ được gọi khi các sự kiện trong vòng đời của nút xảy ra.
void	removeTransformChangedListener(Node.TransformChangedListener conversionChangedListener) Xoá một trình nghe sẽ được gọi khi lượt chuyển đổi của nút thay đổi.
void	setCollisionShape(CollisionShape xung đột) Đặt hình dạng dùng để phát hiện xung đột cho Node này.
khoảng trống cuối cùng	setEnabled(bật boolean) Đặt trạng thái bật của nút này.
void	setLight(Thiết bị sáng) Đặt Light để hiển thị.
void	setLocalPosition(vị trí Vector3) Đặt vị trí của nút này so với nút mẹ (địa phương-không gian).
void	setLocalRotation (Xoay Quaternion) Đặt chế độ xoay trên nút này so với nút mẹ (địa phương-không gian).
void	setLocalScale(tỷ lệ Vector3) Đặt tỷ lệ của nút này so với nút mẹ (địa phương-không gian).
khoảng trống cuối cùng	setLookDirection(Vector3 LookDirection) Đặt hướng mà nút đang xem trong không gian thế giới.
khoảng trống cuối cùng	setLookDirection(Vector3 LookDirection, Vector3 upDirection) Đặt hướng mà nút đang xem trong không gian thế giới.
khoảng trống cuối cùng	setName (Tên) Đặt tên cho nút này.
void	setOnTapListener(Node.OnTapListener onTapListener) Đăng ký một lệnh gọi lại được gọi khi nhấn vào nút này.
void	setOnTouchListener(Node.OnTouchListener onTouchListener) Đăng ký một lệnh gọi lại được gọi khi một sự kiện chạm được gửi đến nút này.
void	setParent(Phần tử mẹ của NodeParent) Thay đổi nút mẹ của nút này.
void	setRenderable (Có thể kết xuất Renderable) Đặt Renderable để hiển thị cho nút này.
void	setWorldPosition(Vị trí vectơ3) Đặt vị trí không gian thế giới của nút này.
void	setWorldRotation(Quaternion xoay) Đặt xoay vòng không gian thế giới của nút này.
void	setWorldscale(tỷ lệ Vector3) Đặt quy mô thế giới không gian của nút này.
Chuỗi	toString()
Final Vector3	worldToLocalDirection(hướng Vector3) Chuyển đổi hướng từ không gian thế giới sang không gian địa phương của nút này.
Final Vector3	worldToLocalPoint(Điểm vectơ 3) Chuyển đổi một điểm trong không gian thế giới thành không gian cục bộ của nút này.

Từ lớp com.google.ar.sceneform.NodeParent

khoảng trống cuối cùng	addChild(Node con) Thêm một nút làm phần tử con của NodeParent này.
void	callOnHierarchy(Người tiêu dùng<Nút> người tiêu dùng) Truyền tải hệ phân cấp và gọi một phương thức trên mỗi nút.
boolean	canAddChild(Phần tử con Node, StringBuilder lỗi)
Nút	findByName(Chuỗi tên) Truyền tải hệ phân cấp để tìm nút đầu tiên có tên.
Nút	findInHierarchy(Predicate<Node> điều kiện) Truyền tải hệ phân cấp để tìm nút đầu tiên đáp ứng một điều kiện.
List<Node>	getChildren() Trả về danh sách không thể thay đổi của các phần tử con này.
void	onAddChild(Nút con)
void	onRemoveChild(Nút con)
khoảng trống cuối cùng	removeCon(Nút con) Xoá một nút khỏi phần tử con của NodeParent này.

Từ lớp java.lang.Object

Đối tượng	clone()
boolean	equals(Đối tượng arg0)
void	finalize()
Final Class<?>	getClass()
int	hashCode()
khoảng trống cuối cùng	notifications()
khoảng trống cuối cùng	notifyAll()
Chuỗi	toString()
khoảng trống cuối cùng	wait(long arg0, int arg1)
khoảng trống cuối cùng	wait (args dài)
khoảng trống cuối cùng	wait()

Phương thức công khai

float nổi getFarClipPlane ()

float float getNearClipPlane ()

công khai nổi getVerticalFovDegrees ()

Lấy trường nhìn dọc của máy ảnh.

Nếu đây là máy ảnh thực tế tăng cường, thì máy ảnh được tính dựa trên thông tin máy ảnh từ ARCore và có thể khác nhau giữa các thiết bị. Nó không thể được tính cho đến khi khung đầu tiên sau khi phiên ARCore được tiếp tục, trong trường hợp đó là IllegalStateException được gửi.

Nếu không, giá trị này sẽ trả về giá trị do setVerticalFovDegrees(float) đặt, theo mặc định là 90 độ.

Gửi

IllegalStateException	nếu được gọi trước khung đầu tiên sau khi ARCore được tiếp tục

công khai Ray screenPointToRay (float x, float y)

Tính toán một tia trong không gian thế giới đi từ mặt phẳng gần của máy ảnh và đi qua một điểm trong không gian màn hình. Không gian màn hình ở toạ độ màn hình thiết bị Android: TopLeft = (0, 0) BottomRight = (Screen Width, Screen Height) Không gian toạ độ của thiết bị không bị ảnh hưởng bởi hướng của thiết bị.

Các tham số

lần	Vị trí x trong toạ độ màn hình thiết bị.
y	Vị trí Y trong tọa độ màn hình của thiết bị.

public void setLocalPosition (Vị trí vectơ 3)

Đặt vị trí của máy ảnh. Máy ảnh luôn isTopLevel(), do đó tính năng này hoạt động giống như setWorldPosition(Vector3).

Nếu máy ảnh này thuộc ArSceneView, thì đây là thao tác không được hỗ trợ. Vị trí máy ảnh không thể thay đổi được, nó bị kiểm soát bởi tư thế máy ảnh ARCore.

Các tham số

position	Vị trí đăng ký.

public void setLocalRotation (Quaternion xoay)

Đặt chế độ xoay của máy ảnh. Máy ảnh luôn isTopLevel(), do đó tính năng này hoạt động giống như setWorldRotation(Quaternion).

Nếu máy ảnh này thuộc ArSceneView, thì đây là thao tác không được hỗ trợ. Bạn không thể thay đổi chế độ xoay của máy ảnh. Chế độ này chịu sự kiểm soát của tư thế máy ảnh ARCore.

Các tham số

xoay	Xoay vòng để áp dụng.

public void setParent (NodeParent mẹ)

Hoạt động không được hỗ trợ. Cha mẹ của máy ảnh không thể thay đổi được, nó luôn là cảnh.

Các tham số

mẹ	Cha mẹ mới mà nút này sẽ là con của. Nếu giá trị rỗng, nút này sẽ được tách khỏi nút mẹ.

public void setVerticalFovdegrees (floatverticalFov)

Đặt trường nhìn dọc cho máy ảnh không phải máy ảnh theo độ. Nếu đây là máy ảnh thực tế tăng cường (AR), thì phần mềm sẽ đến từ ARCore và không thể thiết lập ngoại lệ. Giá trị mặc định là 90 độ.

Các tham số

dọc

Gửi

Trường hợp ngoại lệ không được hỗ trợ	nếu đây là máy ảnh thực tế tăng cường

public void setWorldPosition (Vector3 vị trí)

Đặt vị trí của máy ảnh. Máy ảnh luôn isTopLevel(), do đó tính năng này hoạt động giống như setLocalPosition(Vector3).

Nếu máy ảnh này thuộc ArSceneView, thì đây là thao tác không được hỗ trợ. Vị trí máy ảnh không thể thay đổi được, nó bị kiểm soát bởi tư thế máy ảnh ARCore.

Các tham số

position	Vị trí đăng ký.

public void setWorldRotation (Quaternion xoay)

Đặt chế độ xoay của máy ảnh. Máy ảnh luôn isTopLevel(), do đó tính năng này hoạt động giống như setLocalRotation(Quaternion).

Nếu máy ảnh này thuộc ArSceneView, thì đây là thao tác không được hỗ trợ. Bạn không thể thay đổi chế độ xoay của máy ảnh. Chế độ này chịu sự kiểm soát của tư thế máy ảnh ARCore.

Các tham số

xoay	Xoay vòng để áp dụng.

công khai Vector3 worldToScreenPoint (Vector3 điểm)

Chuyển đổi một điểm từ không gian thế giới thành không gian màn hình.

Giá trị X là số âm khi điểm nằm bên trái khung nhìn, trong khoảng từ 0 đến chiều rộng của SceneView khi điểm đó nằm trong khung nhìn và lớn hơn chiều rộng khi điểm này ở bên phải của khung nhìn.

Giá trị Y là số âm khi điểm nằm dưới khung nhìn, từ 0 đến chiều cao của SceneView khi điểm đó nằm trong khung nhìn và lớn hơn chiều cao khi điểm này nằm trên khung nhìn.

Giá trị Z luôn bằng 0 vì giá trị trả về là một tọa độ 2D.

Các tham số

điểm	điểm trong không gian thế giới để chuyển đổi

Trả về

• một vectơ mới biểu thị điểm trong không gian màn hình.