Kamera

class publik Camera

Mewakili kamera virtual, yang menentukan perspektif saat melihat tampilan.

Jika kamera adalah bagian dari ArSceneView, kamera akan otomatis melacak pose kamera dari ARCore. Selain itu, metode berikut akan memunculkan UnsupportedOperationException saat dipanggil:

• setParent(NodeParent) - Orang tua kamera tidak dapat diubah, selalu ada adegan.
• setLocalPosition(Vector3) - Posisi kamera tidak dapat diubah, dikontrol oleh pose kamera ARCore.
• setLocalRotation(Quaternion) - Rotasi kamera tidak dapat diubah, yang dikontrol oleh pose kamera ARCore.
• setWorldPosition(Vector3) - Posisi kamera tidak dapat diubah, dikontrol oleh pose kamera ARCore.
• setWorldRotation(Quaternion) - Rotasi kamera tidak dapat diubah, yang dikontrol oleh pose kamera ARCore.

Semua fungsi lainnya dalam Node didukung. Anda dapat mengakses posisi dan rotasi kamera, menetapkan bentuk tabrakan ke kamera, atau menambahkan turunan ke kamera. Menonaktifkan kamera akan menonaktifkan rendering.

Metode Publik

float	getFarClipPlane()
float	getNearClipPlane()
float	getVerticalFovDegrees() Mendapatkan ruang pandang vertikal kamera.
Ray	screenPointToRay(float x, float y) Menghitung sinar di ruang dunia yang berasal dari bidang dekat kamera dan melalui suatu titik dalam ruang layar.
void	setLocalPosition(posisi Vector3) Tetapkan posisi kamera.
void	setLocalRotation(Rotasi Quaternion) Tetapkan rotasi kamera.
void	setParent(induk NodeParent) Operasi tidak didukung.
void	setVerticalFovDegrees(float verticalFov) Menetapkan ruang pandang vertikal untuk kamera non-ar dalam derajat.
void	setWorldPosition(posisi Vector3) Tetapkan posisi kamera.
void	setWorldRotation(Quaternion rotasi) Tetapkan rotasi kamera.
Vektor3	worldToScreenPoint(titik Vector3) Ubah titik dari ruang dunia menjadi ruang layar.

Metode Turunan

Dari class com.google.ar.sceneform.Node

void	addLifecycleListener(Node.LifecycleListener lifecycleListener) Menambahkan pemroses yang akan dipanggil saat peristiwa siklus proses node terjadi.
void	addTransformChangedListener(Node.TransformChangedListener transformChangedListener) Menambahkan pemroses yang akan dipanggil saat transformasi node berubah.
void	callOnHierarchy(Konsumen<Node> konsumen) Melintasi hierarki dan memanggil metode di setiap node (termasuk node ini).
boolean akhir	canAddChild(turunan Node, kegagalan kegagalan StringBuilder)
Node	findInHierarchy(Predicate<Node> kondisi) Melintasi hierarki untuk menemukan node pertama (termasuk node ini) yang memenuhi sebuah kondisi.
final Vector3	getBack() Mendapatkan vektor kembali ruang dunia (+z) dari node ini.
CollisionShape	getCollisionShape() Mendapatkan bentuk yang akan digunakan untuk konflik dengan node ini.
final Vector3	getDown() Mendapatkan vektor ruang dunia (-y) dari node ini.
final Vector3	getForward() Mendapatkan vektor penerusan ruang dunia (-z) dari node ini.
final Vector3	getLeft() Mendapatkan vektor ruang dunia (-x) dari node ini.
Terang	getLight() Mendapatkan cahaya saat ini yang dapat diubah.
final Vector3	getLocalPosition() Mendapatkan salinan posisi node relatif terhadap induknya (ruang lokal).
final Quaternion	getLocalRotation() Mendapatkan salinan rotasi node yang relatif terhadap induknya (ruang lokal).
final Vector3	getLocalScale() Mendapatkan salinan skala node relatif terhadap induknya (ruang lokal).
final String	getName() Menampilkan nama node.
Node final	getParent() Menampilkan induk node ini.
Dapat dirender	getRenderable() Mendapatkan hasil render yang dapat ditampilkan untuk node ini.
final Vector3	getRight() Mendapatkan vektor ruang dunia (+x) dari node ini.
final Scene	getScene() Menampilkan scene tempat node ini menjadi null, jika bukan merupakan bagian dari scene mana pun.
final Vector3	getUp() Mendapatkan vektor ruang dunia (+y) dari node ini.
final Vector3	getWorldPosition() Mendapatkan salinan posisi ruang dunia node.
final Quaternion	getWorldRotation() Mendapatkan salinan rotasi ruang dunia node.
final Vector3	getWorldScale() Mendapatkan salinan skala ruang dunia node.
boolean akhir	isActive() Menampilkan true jika node aktif.
boolean akhir	isDescendantOf(ancestor NodeParent) Memeriksa apakah induk node tertentu adalah ancestor dari node ini secara rekursif.
boolean akhir	isEnabled() Mendapatkan status diaktifkan dari node ini.
boolean	isTopLevel() Menampilkan true jika node ini adalah tingkat atas.
final Vector3	localToWorldDirection(arah Vector3) Mengonversi arah dari ruang lokal node ini ke ruang dunia.
final Vector3	localToWorldPoint(titik Vector3) Mengonversi titik di ruang lokal node ini menjadi ruang dunia.
void	onActivate() Menangani kapan node ini menjadi aktif.
final void	onAddChild(Node turunan)
void	onDisabled() Menangani saat node ini menjadi tidak aktif.
final void	onRemoveChild(turunan Node)
boolean	onTouchEvent(HitTestResult hitTestResult, MotionEvent MotionEvent) Menangani saat node ini disentuh.
void	onTransformChange(Node originNode) Menangani saat transformasi node ini diubah.
void	onUpdate(FrameTime frameTime) Menangani kapan node ini diupdate.
void	removeLifecycleListener(Node.LifecycleListener lifecycleListener) Menghapus pemroses yang akan dipanggil saat peristiwa siklus proses node terjadi.
void	removeTransformChangedListener(Node.TransformChangedListener transformChangedListener) Menghapus pemroses yang akan dipanggil saat transformasi node berubah.
void	setCollisionShape(tabrakan CollisionShape) Menetapkan bentuk yang digunakan untuk mendeteksi tabrakan untuk Node ini.
final void	setEnabled(boolean diaktifkan) Menetapkan status node ini yang diaktifkan.
void	setLight(Cahaya cahaya) Menetapkan Light untuk ditampilkan.
void	setLocalPosition(posisi Vector3) Menetapkan posisi node ini relatif terhadap induknya (local-space).
void	setLocalRotation(Rotasi Quaternion) Menetapkan rotasi node ini relatif terhadap induknya (ruang lokal).
void	setLocalScale(skala Vector3) Menetapkan skala node ini relatif terhadap induknya (ruang lokal).
final void	setLookDirection(Vector3 LookDirection) Menetapkan arah yang dilihat node di ruang dunia.
final void	setLookDirection(Vector3 LookDirection, Vector3 upDirection) Menetapkan arah yang dilihat node di ruang dunia.
final void	setName(nama String) Menetapkan nama node ini.
void	setOnTapListener(Node.OnTapListener onTapListener) Mendaftarkan callback untuk dipanggil saat node ini diketuk.
void	setOnTouchListener(Node.OnTouchListener onTouchListener) Mendaftarkan callback untuk dipanggil saat peristiwa sentuh dikirim ke node ini.
void	setParent(induk NodeParent) Mengubah node induk untuk node ini.
void	setRenderable(Dapat dirender dapat dirender) Menetapkan Renderable yang akan ditampilkan untuk node ini.
void	setWorldPosition(posisi Vector3) Menetapkan posisi ruang dunia node ini.
void	setWorldRotation(Quaternion rotasi) Menetapkan rotasi ruang dunia node ini.
void	setWorldScale(skala Vector3) Menetapkan skala ruang dunia node ini.
String	toString()
final Vector3	worldToLocalDirection(arah Vector3) Mengonversi arah dari ruang dunia ke ruang lokal node ini.
final Vector3	worldToLocalPoint(titik Vector3) Mengonversi titik di ruang dunia ke ruang lokal node ini.

Dari class com.google.ar.sceneform.NodeParent

final void	addChild(Node turunan) Menambahkan node sebagai turunan dari NodeParent ini.
void	callOnHierarchy(Konsumen<Node> konsumen) Jelajahi hierarki dan panggil metode pada setiap node.
boolean	canAddChild(turunan Node, kegagalan kegagalan StringBuilder)
Node	findByName(nama String) Telusuri hierarki untuk menemukan node pertama dengan nama tertentu.
Node	findInHierarchy(Predicate<Node> kondisi) Telusuri hierarki untuk menemukan node pertama yang memenuhi kondisi.
final List<Node>	getChildren() Menampilkan daftar yang tidak dapat diubah dari turunan induk ini.
void	onAddChild(Node turunan)
void	onRemoveChild(turunan Node)
final void	removeChild(Node turunan) Menghapus node dari turunan NodeParent ini.

Dari class java.lang.Object

Objek	clone()
boolean	sama dengan(Objek arg0)
void	finalize()
final Class< ?>gt;	getClass()
int	hashCode()
final void	beri tahu()
final void	notifyAll()
String	toString()
final void	wait(panjang arg0, int arg1)
final void	wait(panjang arg0)
final void	wait()

Metode Publik

float publik getFarClipPlane ()

float publik getNearClipPlane ()

float publik getVerticalFovDegrees ()

Mendapatkan ruang pandang vertikal kamera.

Jika ini adalah kamera AR, penghitungannya berdasarkan informasi kamera dari ARCore dan dapat bervariasi di antara perangkat. Ini tidak dapat dihitung sampai frame pertama setelah sesi ARCore dilanjutkan, dalam hal ini IllegalStateException dilempar.

Jika tidak, nilai yang ditetapkan oleh setVerticalFovDegrees(float) akan ditampilkan, dengan default 90 derajat.

Menampilkan

IllegalStateException	jika dipanggil sebelum frame pertama setelah ARCore dilanjutkan

publik Ray screenPointToRay (float x, float y)

Menghitung sinar di ruang dunia yang berasal dari bidang dekat kamera dan melalui suatu titik dalam ruang layar. Ruang layar dalam koordinat layar perangkat Android: Kiri Atas = (0, 0) Kanan Bawah = (Lebar Layar, Tinggi Layar) Ruang koordinat perangkat tidak terpengaruh oleh orientasi perangkat.

Parameter

x	Posisi X dalam koordinat layar perangkat.
y	Posisi Y dalam koordinat layar perangkat.

publik void setLocalPosition (posisi Vector3)

Tetapkan posisi kamera. Kamera selalu isTopLevel(), sehingga berperilaku sama seperti setWorldPosition(Vector3).

Jika kamera merupakan bagian dari ArSceneView, berarti operasi ini tidak didukung. Posisi kamera tidak dapat diubah, dikontrol oleh pose kamera ARCore.

Parameter

position	Posisi yang akan diterapkan.

publik void setLocalRotation (Rotasi Quaternion)

Tetapkan rotasi kamera. Kamera selalu isTopLevel(), sehingga berperilaku sama seperti setWorldRotation(Quaternion).

Jika kamera merupakan bagian dari ArSceneView, berarti operasi ini tidak didukung. Rotasi kamera tidak dapat diubah, dikontrol oleh pose kamera ARCore.

Parameter

rotasi	Rotasi yang akan diterapkan.

publik void setParent (NodeParent parent)

Operasi tidak didukung. Orang tua Kamera tidak dapat diubah, selalu ada adegan.

Parameter

induk	Induk baru tempat node ini akan menjadi turunannya. Jika null, node ini akan dilepaskan dari induknya.

publik void setVerticalFovDegrees (float verticalFov)

Menetapkan ruang pandang vertikal untuk kamera non-ar dalam derajat. Jika ini adalah kamera AR, fov berasal dari ARCore dan tidak dapat ditetapkan sehingga pengecualian ditampilkan. Nilai defaultnya adalah 90 derajat.

Parameter

Vertikal

Menampilkan

Tidak DidukungOperationException	jika ini adalah kamera AR

publik void setWorldPosition (Posisi vektor3)

Tetapkan posisi kamera. Kamera selalu isTopLevel(), sehingga berperilaku sama seperti setLocalPosition(Vector3).

Jika kamera merupakan bagian dari ArSceneView, berarti operasi ini tidak didukung. Posisi kamera tidak dapat diubah, dikontrol oleh pose kamera ARCore.

Parameter

position	Posisi yang akan diterapkan.

publik void setWorldRotation (rotasi Quaternion)

Tetapkan rotasi kamera. Kamera selalu isTopLevel(), sehingga berperilaku sama seperti setLocalRotation(Quaternion).

Jika kamera merupakan bagian dari ArSceneView, berarti operasi ini tidak didukung. Rotasi kamera tidak dapat diubah, dikontrol oleh pose kamera ARCore.

Parameter

rotasi	Rotasi yang akan diterapkan.

publik Vector3 worldToScreenPoint (Vector3 titik)

Ubah titik dari ruang dunia menjadi ruang layar.

Nilai X negatif jika titik tersisa dari area pandang, antara 0 dan lebar SceneView saat titik berada dalam area pandang, dan lebih besar dari lebar saat titik berada di sebelah kanan area pandang.

Nilai Y negatif jika titik berada di bawah area pandang, antara 0 dan tinggi SceneView saat titik berada dalam area pandang, dan lebih besar dari tinggi saat titik berada di atas area pandang.

Nilai Z selalu 0 karena nilai yang ditampilkan adalah koordinat 2D.

Parameter

poin	titik di ruang dunia untuk berkonversi

Hasil

• vektor baru yang mewakili titik di ruang layar.