Scena sceny to wykres scenowy, który ma hierarchiczną organizację treści. Uwaga: scena może zawierać 0 lub więcej węzłów podrzędnych, ale nie może ich być więcej.
Scena udostępnia także testy działania, dzięki którym można wykryć węzeł, na który wpływa zdarzenie Motion lub Ray.
Zajęcia zagnieżdżone
interfejs | Scene.OnPeekTouchListener | Definicja interfejsu wywołania zwrotnego, które jest wywoływane, gdy zdarzenie dotyku jest wysyłane do sceny. | |
interfejs | Scene.OnTouchListener (Scene.OnTouchListener) | Definicja interfejsu wywołania zwrotnego, które jest wywoływane, gdy zdarzenie dotyku jest wysyłane do sceny. | |
interfejs | Scene.OnUpdateListener | Definicja interfejsu wywołania zwrotnego jest wywoływana raz na klatkę bezpośrednio przed aktualizacją sceny. |
Pola
publiczne Static HdrParameters | DEFAULT_HDR_PARAMETERS |
Budownictwo publiczne
Metody publiczne
nieważne |
addOnPeekTouchListener (Scene.OnPeekTouchListener onPeekTouchListener)
Dodaje detektor, który zostanie wywołany przed wywołaniem funkcji
Scene.OnTouchListener . |
nieważne |
addOnUpdateListener (Scene.OnUpdateListener onUpdateListener)
Dodaje detektor, który będzie wywoływany raz w każdej klatce bezpośrednio przed aktualizacją.
|
Kamera |
getCamera()
Pobierz aparat używany do renderowania sceny.
|
Węzeł |
getSunlight()
Pobierz domyślny węzeł słoneczny.
|
SceneView |
getView()
Zwraca widok SceneView użyty do utworzenia sceny.
|
Wynik testu |
hitTest(MotionEvent MotionEvent)
Testuje, czy zdarzenie ruchu dotyka dowolnego węzła w scenie na podstawie testu działania promienia, którego punkt początkowy jest zdarzeniem ruchu, i wywołuje wynik działania TestTest zawierający węzeł znajdujący się najbliżej ekranu.
|
Wynik testu | |
ArrayList<HitTestResult> |
hitTestAll (ray)
Testuje, czy promień nie dotyczy żadnych węzłów w scenie, i zwraca listę działań HitTestResults zawierających wszystkie trafienia, które zostały posortowane według odległości.
|
ArrayList<HitTestResult> |
hitTestAll(MotionEvent MotionEvent)
Testuje, czy zdarzenie ruchu dotyczy wszystkich węzłów w scenie, a następnie zwraca listę działań HitTestResults zawierających wszystkie trafienia, które zostały posortowane według odległości.
|
nieważne |
onAddChild (element podrzędny węzła)
|
nieważne | |
Węzeł |
overlapTest(węzeł węzła)
Testuje, czy dany kształt kolizji danego węzła pokrywa się ze kształtem kolizji innych węzłów w scenie, używając interfejsu
getCollisionShape() . |
ArrayList<Node> |
overlapTestAll(węzeł węzła)
Testuje, czy węzeł nie pokrywa się z innymi węzłami w scenie za pomocą polecenia
getCollisionShape() . |
nieważne |
removeOnPeekTouchListener(Scene.OnPeekTouchListener onPeekTouchListener)
Usuwa detektor, który zostanie wywołany przed wywołaniem funkcji
Scene.OnTouchListener . |
nieważne |
removeOnUpdateListener(Scene.OnUpdateListener onUpdateListener)
Usuwa detektor, który jest wywoływany raz na klatkę bezpośrednio przed aktualizacją.
|
nieważne |
setLightEstimate(Korekcja kolorów, intensywność kolorów pływającej)
Ustawia szacowaną wartość światła, aby modyfikować oświetlenie i natężenie światła.
|
nieważne |
setOnTouchListener (Scene.OnTouchListener onTouchListener)
Zarejestruj wywołanie zwrotne, które ma być wywoływane po dotknięciu sceny.
|
Metody dziedziczone
Pola
public+static finalalHdrParameters DEFAULT_HDR_PARAMETERS
Budownictwo publiczne
Metody publiczne
void voidaddOnPeekTouchListener(Scene.OnPeekTouchListener onPeekTouchListener)
Dodaje detektor, który zostanie wywołany przed wywołaniem funkcji Scene.OnTouchListener
. Jest ona wywoływana nawet przy użyciu gestu, co pozwala obserwować wszystkie zdarzenia ruchu wysyłane do danej sceny. Jest to nazywane nawet wtedy, gdy punkt dotykowy nie znajduje się nad węzłem. W takim przypadku getNode()
ma wartość NULL. Detektory będą wywoływane w kolejności, w której zostały dodane.
Parametry
OnPeekTouchListener | Szybki podgląd słuchacza |
---|
void void addOnUpdateListener (Scene.OnUpdateListener onUpdateListener)
Dodaje detektor, który będzie wywoływany raz w każdej klatce bezpośrednio przed aktualizacją. Detektory będą wywoływane w kolejności, w której zostały dodane.
Parametry
onUpdateListener | detektor aktualizacji do dodania |
---|
Aparat getCamera ()
Pobierz aparat używany do renderowania sceny. Aparat jest typem węzła.
Zwraca
- aparat użyty do renderowania sceny
HitTestResult hitTest (MotionEvent MotionEvent)
Testuje, czy zdarzenie ruchu dotyka dowolnego węzła w scenie na podstawie testu działania promienia, którego punkt początkowy jest zdarzeniem ruchu, i wywołuje wynik działania TestTest zawierający węzeł znajdujący się najbliżej ekranu.
Parametry
Motionmotion | zdarzenie ruchu, które ma zostać wykorzystane do testu |
---|
Zwraca
- w wyniku znajdzie się pierwszy węzeł, który został wywołany przez zdarzenie ruchu (może mieć wartość null) oraz informacje o tym, w którym miejscu w ruchu wystąpił węzeł w przestrzeni świata.
publiczne HitTestResult hitTest (Ray ray)
Testuje, czy promień dociera do dowolnego węzła w scenie, i zwraca wynik działania TestTestResult zawierający węzeł najbliższy promienia, który krzyżuje się z promieniem.
Parametry
Ray | tablica do wykorzystania w teście |
---|
Zwraca
- w wyniku znajdzie się pierwszy węzeł trafiony przez promień (może mieć wartość null) oraz informacje o tym, w którym miejscu promień dotarł do węzła w przestrzeni świata.
Zobacz również
public ArrayList<HitTestResult> hitTestAll (Ray ray)
Testuje, czy promień nie dotyczy żadnych węzłów w scenie, i zwraca listę działań HitTestResults zawierających wszystkie trafienia, które zostały posortowane według odległości.
Parametry
Ray | Promień używany do testu. |
---|
Zwraca
- Wartość wypełniana przez wynik testu testowego dla każdego węzła, który został posortowany według odległości. Brak wartości, jeśli nie wystąpiły żadne węzły.
Zobacz również
public ArrayList<HitTestResult> hitTestAll (MotionEvent MotionEvent)
Testuje, czy zdarzenie ruchu dotyczy wszystkich węzłów w scenie, a następnie zwraca listę działań HitTestResults zawierających wszystkie trafienia, które zostały posortowane według odległości.
Parametry
Motionmotion | Zdarzenie ruchu używane w teście. |
---|
Zwraca
- Wartość wypełniana przez wynik testu testowego dla każdego węzła, który został posortowany według odległości. Brak wartości, jeśli nie wystąpiły żadne węzły.
Węzeł overlapTest (węzeł)
Testuje, czy dany kształt kolizji danego węzła pokrywa się ze kształtem kolizji innych węzłów w scenie, używając interfejsu getCollisionShape()
. Węzeł używany do testowania nie musi być aktywny.
Parametry
węzeł | Węzeł używany w teście. |
---|
Zwraca
- Węzeł pokrywający się z węzła testowego. Jeśli żaden węzeł testowy nie nakłada się na węzeł testowy, wartość jest pusta. Jeśli wiele węzłów pokrywa się z wieloma węzłami, może to być dowolny z nich.
Zobacz również
public ArrayList<Node> overlapTestAll (węzeł)
Testuje, czy węzeł nie pokrywa się z innymi węzłami w scenie za pomocą polecenia getCollisionShape()
. Węzeł używany do testowania nie musi być aktywny.
Parametry
węzeł | Węzeł używany w teście. |
---|
Zwraca
- Lista wszystkich węzłów, które nakładają się na węzeł testowy. Jeśli żaden węzeł testowy nie nakłada się na węzeł testowy, lista jest pusta.
Zobacz również
void void removeOnPeekTouchListener (Scene.OnPeekTouchListener onPeekTouchListener)
Usuwa detektor, który zostanie wywołany przed wywołaniem funkcji Scene.OnTouchListener
.
Jest ona wywoływana nawet przy użyciu gestu, co pozwala obserwować wszystkie zdarzenia ruchu wysyłane do danej sceny. Nazywa się to nawet wtedy, gdy kontakt nie znajduje się w węźle, w którym przypadku wartość getNode()
jest pusta.
Parametry
OnPeekTouchListener | Szybki podgląd detektora do usunięcia |
---|
void void removeOnUpdateListener (Scene.OnUpdateListener onUpdateListener)
Usuwa detektor, który jest wywoływany raz na klatkę bezpośrednio przed aktualizacją.
Parametry
onUpdateListener | detektor aktualizacji do usunięcia |
---|
void void setLightEstimated (Kolor, korekcja kolorów pływającego piksela)
Ustawia szacowaną wartość światła, aby modyfikować oświetlenie i natężenie światła. Wyrenderowane oświetlenie będzie korzystać z połączenia tych wartości, a także kolorów i intensywności żarówki. Wartość białej korekcji kolorów i intensywności piksela 1 oznacza, że w ustawieniach światła nie są wprowadzane żadne zmiany.
Ta scena jest wykorzystywana przez sceny AR AR do dostosowywania oświetlenia na podstawie wartości ARCore. Scena AR wyświetli się automatycznie i może zastąpić inne ustawienia. W większości przypadków nie trzeba tego wywoływać.
Parametry
korekcja kolorów | modyfikuje kolor oświetlenia sceny. |
---|---|
Intensywność piksela | modyfikuje intensywność oświetlenia sceny. |
void void setOnTouchListener (Scene.OnTouchListener onTouchListener)
Zarejestruj wywołanie zwrotne, które ma być wywoływane po dotknięciu sceny. Wywołanie zwrotne zostanie wysłane po wysłaniu zdarzenia dotknięcia do węzłów w scenie, jeśli żaden węzeł nie wykorzysta tego zdarzenia. Jest to wywoływane nawet wtedy, gdy punkt dotykowy nie znajduje się nad węzłem. W takim przypadku getNode()
ma wartość NULL.
Parametry
onTouchListener | detektor dotykowy do podłączenia |
---|