Aparat

klasa publiczna Kamera

Reprezentuje kamerę wirtualną, która określa perspektywę, w której ogląda się daną scenę.

Jeśli ArSceneView należy do kamery, automatycznie śledzi jej pozycję z ARCore. Oprócz tego poniższe metody spowodują wywołanie UnsupportedOperationException:

• setParent(NodeParent) – nie można zmienić rodzica w kamerze. Zawsze jest to oświetlenie.
• setLocalPosition(Vector3) – nie można zmienić pozycji kamery, ponieważ jest ona sterowana przez pozycję ARCore.
• setLocalRotation(Quaternion) – nie można zmienić rotacji kamery. Kontroluje ją położenie kamery ARCore.
• setWorldPosition(Vector3) – nie można zmienić pozycji kamery, ponieważ jest ona sterowana przez pozycję ARCore.
• setWorldRotation(Quaternion) – nie można zmienić rotacji kamery. Kontroluje ją położenie kamery ARCore.

Wszystkie inne funkcje w węźle są obsługiwane. Możesz sprawdzać położenie i obrót kamery, przypisywać kształtowi kolizji do kamery lub dodawać dzieci. Wyłączenie kamery powoduje wyłączenie renderowania.

Metody publiczne

liczba zmiennoprzecinkowa	getFarClipPlane()
liczba zmiennoprzecinkowa	getNearClipPlane()
liczba zmiennoprzecinkowa	getVerticalFovDegrees() Pobiera pionowe pole widzenia kamery.
Być może	screenPointToRay (liczba zmiennoprzecinkowa x, liczba zmiennoprzecinkowa Y) Oblicza promień w przestrzeni świata przecinający obszar bliski płaszczyzny kamery i przechodzący przez taki obszar.
nieważne	setLocalPosition(Pozycja Vector3) Określ położenie kamery.
nieważne	setLocalRotation(rotacja Quaternion) Ustaw obrót kamery.
nieważne	setParent(element nadrzędny NodeParent) Nieobsługiwana operacja.
nieważne	setVerticalFovDegrees (liczba zmiennoprzecinkowa pionowy) Ustawia poziomy pola widzenia w przypadku aparatu innego niż kątowy w stopniach.
nieważne	setWorldPosition(pozycja Vector3) Określ położenie kamery.
nieważne	setWorldRotation (rotacja kwartałów) Ustaw obrót kamery.
Wektor3	worldToScreenPoint(Vector3 punkt) Przekształć punkt z przestrzeni świata w ekran.

Metody dziedziczone

Z klasy com.google.ar.sceneform.Node

nieważne	addLifecycleListener(Node.LifecycleListener cyklu życia) Dodaj detektor, który zostanie wywołany po wystąpieniu zdarzeń cyklu życia węzła.
nieważne	addTransformChangedListener (Node.TransformChangedListener transformChangedListener) Dodaj detektor, który zostanie wywołany po przekształceniu węzła.
nieważne	callOnHierarchy(consumer<Node>consumer) Pokonuje hierarchię i wywołuje metodę w każdym węźle (w tym w tym węźle).
końcowa wartość logiczna	canAddChild(element podrzędny węzła, błąd StringBuilder)
Węzeł	findInHierarchy(predykat<węzeł> warunek) Pokonuje hierarchię w celu znalezienia pierwszego węzła (w tym tego węzła), który spełnia warunek.
final Vector3	getBack Pobiera wektor w przestrzeni wstecznej (+z) tego węzła.
Koliza kształtu	getCollisionkształt() Pobiera kształt do wykorzystania w przypadku zderzenia z tym węzłem.
final Vector3	getdown Pobiera wektor wielokanałowy w dół (-y) tego węzła.
final Vector3	getForward() Pobiera wektor świata w przestrzeni (-z) tego węzła.
final Vector3	getLeft() Pobiera wektor w lewo przestrzeni świata (-x) tego węzła.
Jasny	getLight Pobiera bieżące oświetlenie, które można zmienić.
final Vector3	getLocalPosition() Pobiera kopię pozycji węzłów w stosunku do jej elementu nadrzędnego (przestrzeń lokalna).
final Quaternion	getLocalRotation() Pobiera kopię rotacji węzłów w stosunku do jej jednostki nadrzędnej (przestrzeń lokalna).
final Vector3	getLocalScale() Pobiera kopię skali węzłów w stosunku do jej jednostki nadrzędnej (przestrzeń lokalna).
final Ciąg	getName() Zwraca nazwę węzła.
końcowy węzeł	getParent() Zwraca obiekt nadrzędny tego węzła.
Renderowanie	getRenderable() Pobiera renderowane do wyświetlenia dla tego węzła.
final Vector3	getRight() Pobiera właściwy wektor miejsca na świecie (+x) tego węzła.
końcowy Scena	getScene() Zwraca scenę, w której znajduje się dany węzeł, lub wartość null, jeśli nie jest ona częścią żadnej sceny.
final Vector3	getUp() Pobiera wektor świata w górę (+y) tego węzła.
final Vector3	getWorldPosition() Uzyskaj kopię pozycji miejsca na świecie węzłów.
final Quaternion	getWorldRotation() Pobiera kopię rotacji świata w węzłach.
final Vector3	getWorldScale() Pobiera kopię skali świata węzłów.
końcowa wartość logiczna	isActive() Zwraca wartość „true”, jeśli węzeł jest aktywny.
końcowa wartość logiczna	isDescendantOf(element nadrzędny NodeParent) Sprawdzanie, czy dany element nadrzędny węzła jest rekurencyjny w stosunku do tego węzła.
końcowa wartość logiczna	isEnabled() Pobiera stan włączenia tego węzła.
wartość logiczna	isTopLevel() Zwraca wartość „true”, jeśli ten węzeł jest najwyższego poziomu.
final Vector3	localToWorldDirection(Vector3) Przekształca kierunek z pamięci lokalnej tego węzła w przestrzeń świata.
final Vector3	localToWorldPoint(Vector3) Przekształca punkt w przestrzeni lokalnej tego węzła w przestrzeń świata.
nieważne	onActivate() Obsługuje, gdy ten węzeł stanie się aktywny.
końcowy unieważnienie	onAddChild(element podrzędny węzła)
nieważne	onDezaktywuj() Obsługuje, gdy ten węzeł stanie się nieaktywny.
końcowy unieważnienie	onRemoveChild(element podrzędny)
wartość logiczna	onTouchEvent(HiTTestResult HitTestResult, MotionEvent Motion) Obsługuje po dotknięciu tego węzła.
nieważne	onTransformChange(węzeł węzła początkowego) Obsługuje zmianę przekształcenia tego węzła.
nieważne	onUpdate(FrameTime), Obsługuje podczas aktualizowania tego węzła.
nieważne	removeLifecycleListener(Node.LifecycleListener cyklu życia) Usuwa odbiornik, który będzie wywoływany po wystąpieniu zdarzeń cyklu życia węzła.
nieważne	removeTransformChangedListener(Node.TransformChangedListener transformChangedListener) Usuwa odbiornik, który będzie wywoływany po przekształceniu węzła.
nieważne	setCollisionShape(kolimatorkształt) Określa kształt używany do wykrywania kolizji w przypadku tego elementu: Node.
końcowy unieważnienie	setEnabled(wartość logiczna włączona) Ustawia włączony stan tego węzła.
nieważne	setLight(jasny) Ustawia Light do wyświetlenia.
nieważne	setLocalPosition(Pozycja Vector3) Ustawia pozycję tego węzła w stosunku do jego elementu nadrzędnego (przestrzeń lokalna).
nieważne	setLocalRotation (rotacja Quaternion) Ustawia obrót tego węzła w stosunku do jego węzła nadrzędnego (przestrzeń lokalna).
nieważne	setLocalScale(skala Vector3) Ustawia skalę tego węzła w stosunku do jego węzła nadrzędnego (przestrzeń lokalna).
końcowy unieważnienie	setLookDirection(Vector3 LookDirection) Ustawia kierunek, w którym węzeł patrzy na obszar świata.
końcowy unieważnienie	setLookDirection(Vector3 LookDirection, Vector3 upDirection) Ustawia kierunek, w którym węzeł patrzy na obszar świata.
końcowy unieważnienie	setName(nazwa ciągu ciągu znaków) Ustawia nazwę tego węzła.
nieważne	setOnTapListener(Node.OnTapListener onTapListener) Rejestruje wywołanie zwrotne, które ma zostać wykonane po kliknięciu tego węzła.
nieważne	setOnTouchListener(Node.OnTouchListener onTouchListener), Rejestruje wywołanie zwrotne, które jest wysyłane do tego węzła po wywołaniu zdarzenia dotknięcia.
nieważne	setParent(element nadrzędny NodeParent) Zmienia węzeł nadrzędny tego węzła.
nieważne	setRenderable (możliwość renderowania Renderable) Ustawia Renderable do wyświetlenia dla tego węzła.
nieważne	setWorldPosition(pozycja Vector3) Ustawia pozycję świata na świecie tego węzła.
nieważne	setWorldRotation(rotacja kwartałów) Ustawia obrót między światem tego węzła.
nieważne	setWorldScale (skala Vector3) Ustawia skalę tego miejsca na świecie.
Ciąg	toString()
final Vector3	worldToLocalDirection(Vector3) Przekształca wskazówki z przestrzeni świata na przestrzeń lokalną tego węzła.
final Vector3	worldToLocalPoint(Vector3 punkt) Przekształca punkt w środowisku świata w przestrzeń lokalną tego węzła.

Od klasy com.google.ar.sceneform.NodeParent

końcowy unieważnienie	addChild (element podrzędny) Dodaje węzeł podrzędny jako element podrzędny tego węzła NodeParent.
nieważne	callOnHierarchy(consumer<Node>consumer) Poruszaj się po hierarchii i wywołuj metodę w każdym węźle.
wartość logiczna	canAddChild(element podrzędny węzła, błąd StringBuilder)
Węzeł	findByName(ciąg znaków) Poruszaj się po hierarchii, aby znaleźć pierwszy węzeł o danej nazwie.
Węzeł	findInHierarchy(predykat<węzeł> warunek) Poruszaj się po hierarchii, aby znaleźć pierwszy węzeł spełniający warunek.
final List<Node>	getChildren() Zwraca stałą listę elementów podrzędnych tego elementu nadrzędnego.
nieważne	onAddChild (element podrzędny węzła)
nieważne	onRemoveChild (element podrzędny)
końcowy unieważnienie	removeChild (element podrzędny węzła) Usuwa węzeł z elementów podrzędnych tego węzła NodeParent.

Z klasy java.lang.Object

Obiekt	klon
wartość logiczna	równa się(obiekt argument;0)
nieważne	finalizacji
final Class<\">gt;	getClass()
int,	hashCode()
końcowy unieważnienie	notify()
końcowy unieważnienie	notifyAll()
Ciąg	toString()
końcowy unieważnienie	wait(długi arg0, int arg1)
końcowy unieważnienie	wait(długi arg0)
końcowy unieważnienie	wait()

Metody publiczne

liczba pływająca getFarClipPlane ()

powłoka publiczna getNearClipPlane ()

powszechna liczba zmiennoprzecinkowa getVerticalFovDegrees ()

Pobiera pionowe pole widzenia kamery.

Jeśli jest to kamera AR, jest obliczana na podstawie informacji z kamery z ARCore i może się różnić w zależności od urządzenia. Nie można go obliczyć, dopóki pierwsza sesja ARCore nie zostanie wznowiona – w takim przypadku zostanie wywołany wyjątek DisallowStateException.

W przeciwnym razie zostanie zwrócona wartość ustawiona na setVerticalFovDegrees(float), a domyślna wartość to 90 stopni.

Narzuty

DisallowStateException (niedozwolony stan)	jeśli jest wywoływane przed rozpoczęciem pierwszej klatki po wznowieniu ARCore;

publiczny Ray screenPointToRay (liczba zmiennoprzecinkowa x, pływająca y)

Oblicza promień w przestrzeni świata przecinający obszar bliski płaszczyzny kamery i przechodzący przez taki obszar. Układ ekranu znajduje się we współrzędnych ekranu urządzenia z Androidem: lewy górny = (0, 0) prawy dolny = (szerokość ekranu, wysokość ekranu). Układ współrzędnych urządzenia nie ma wpływu na orientację urządzenia.

Parametry

x	Pozycja X na współrzędnych ekranu urządzenia.
r.	Pozycja na osi Y na współrzędnych ekranu urządzenia.

void void setLocalPosition (Vector3))

Określ położenie kamery. Aparat zawsze isTopLevel(), więc działa tak samo jak setWorldPosition(Vector3).

Jeśli kamera jest częścią systemu ArSceneView, ta operacja nie jest obsługiwana. Nie można zmienić pozycji kamery, ponieważ jest ona sterowana przez pozycję ARCore.

Parametry

position	Pozycja, która ma zostać zastosowana.

nieważny setLocalRotation (rotacja kwartałów)

Ustaw obrót kamery. Aparat zawsze isTopLevel(), więc działa tak samo jak setWorldRotation(Quaternion).

Jeśli kamera jest częścią systemu ArSceneView, ta operacja nie jest obsługiwana. Nie można zmienić rotacji kamery. Kontroluje ją położenie kamery ARCore.

Parametry

obrót	Rotacja, którą chcesz zastosować.

void void setParent (ParentParent)

Nieobsługiwana operacja. Nie można zmienić rodzica w kamerze – zawsze jest to scena.

Parametry

element nadrzędny	Nowy element nadrzędny, z którego będzie korzystał węzeł. Jeśli węzeł będzie pusty, ten węzeł zostanie odłączony od jego elementu nadrzędnego.

void void setVerticalFovDegrees (floatverticalFov)

Ustawia poziomy pola widzenia w przypadku aparatu innego niż kątowy w stopniach. Jeśli to jest kamera AR, Fov pochodzi z ARCore i nie można go ustawić, więc zostanie zgłoszony wyjątek. Wartość domyślna to 90 stopni.

Parametry

pionowaFov

Narzuty

Nieobsługiwany wyjątek operacyjny	jeśli to jest kamera AR

void void setWorldPosition (Vector3))

Określ położenie kamery. Aparat zawsze isTopLevel(), więc działa tak samo jak setLocalPosition(Vector3).

Jeśli kamera jest częścią systemu ArSceneView, ta operacja nie jest obsługiwana. Nie można zmienić pozycji kamery, ponieważ jest ona sterowana przez pozycję ARCore.

Parametry

position	Pozycja, która ma zostać zastosowana.

nieważny setWorldRotation (obrót Kryterium)

Ustaw obrót kamery. Aparat zawsze isTopLevel(), więc działa tak samo jak setLocalRotation(Quaternion).

Jeśli kamera jest częścią systemu ArSceneView, ta operacja nie jest obsługiwana. Nie można zmienić rotacji kamery. Kontroluje ją położenie kamery ARCore.

Parametry

obrót	Rotacja, którą chcesz zastosować.

Vector3 worldToScreenPoint (Vector3))

Przekształć punkt z przestrzeni świata w ekran.

Wartość X jest ujemna, gdy punkt pozostaje w widocznym obszarze, między 0 a szerokością SceneView, gdy punkt znajduje się w widocznym obszarze, i większy niż jego szerokość po prawej stronie widocznego obszaru.

Wartość Y jest ujemna, gdy punkt znajduje się pod widocznym obszarem, od 0 do wysokości SceneView, gdy punkt znajduje się w widocznym obszarze, i więcej niż wysokość, gdy punkt znajduje się powyżej widocznego obszaru.

Wartość Z jest zawsze równa 0, bo wartość zwrotna jest współrzędną 2D.

Parametry

punkt	punkt konwersji na świecie

Zwraca

• nowy wektor, który reprezentuje punkt w przestrzeni ekranu.