โหนด

คลาสสาธารณะ โหนด
คลาสย่อยที่ทราบ
คลาสย่อยทางอ้อมที่ทราบ

โหนดแสดงการเปลี่ยนรูปแบบภายในลําดับชั้นของโหมด&#39 ซึ่งอาจมีการแสดงผลเพื่อให้เครื่องมือแสดงผลแสดงผล

แต่ละโหนดมีโหนดย่อยได้ตามจํานวนที่ต้องการและโหนดหลัก 1 รายการ องค์ประกอบหลักอาจเป็นโหนดอื่นหรือฉากก็ได้

ชั้นเรียนที่ฝังไว้

ที่ปรับปรุงใหม่ Node.LifecycleListener คํานิยามของอินเทอร์เฟซสําหรับโค้ดเรียกกลับที่จะเรียกใช้เมื่อเกิดเหตุการณ์อายุการใช้งานของโหนด
ที่ปรับปรุงใหม่ Node.OntapListener คํานิยามอินเทอร์เฟซสําหรับการเรียกกลับเพื่อเรียกใช้เมื่อมีการแตะโหนด
ที่ปรับปรุงใหม่ No..OnTouchListener คําจํากัดความอินเทอร์เฟซสําหรับการเรียกกลับสําหรับเรียกใช้เมื่อมีการส่งเหตุการณ์การแตะไปยังโหนดนี้
ที่ปรับปรุงใหม่ Node.TransformChangedListener คํานิยามของอินเทอร์เฟซสําหรับโค้ดเรียกกลับที่จะเรียกใช้เมื่อการเปลี่ยนโหนด

ผู้ผลิตก่อสร้าง

โหนด()
สร้างโหนดที่ไม่มีระดับบนสุด

วิธีการสาธารณะ

เป็นโมฆะ
addLifecycleListener(LdeecycleListener LifecycleListener)
เพิ่ม Listener ที่จะเรียกเมื่อมีเหตุการณ์ในวงจรของโหนดเกิดขึ้น
เป็นโมฆะ
addTransformChangedListener(Node.TransformChangedListener TransformChangedListener)
เพิ่ม Listener ที่จะเรียกเมื่อการเปลี่ยนโหนด
เป็นโมฆะ
callOnHierarchy(Consumer<Node>consumer)
สํารวจลําดับชั้นและเรียกเมธอดในแต่ละโหนด (รวมถึงโหนดนี้)
โหนด
findInHierarchy(Predicate<Node>condition)
สํารวจลําดับชั้นของการค้นหาเพื่อหาโหนดแรก (รวมถึงโหนดนี้) ที่ตรงกับเงื่อนไข
สุดท้าย Vector3
getBack()
รับเวกเตอร์พื้นที่กลับ (+z) ของโหนดนี้
รูปร่างภาพต่อกัน
getCollisionShape()
รับรูปร่างที่จะใช้สําหรับการชนกับโหนดนี้
สุดท้าย Vector3
getdown()
นําเวกเตอร์พื้นที่ (-y) ลงของโหนดนี้
สุดท้าย Vector3
getForward()
รับเวกเตอร์ส่งต่อพื้นที่ (-z) ของโหนดนี้
สุดท้าย Vector3
get left()
รับเวกเตอร์พื้นที่ซ้าย (-x) ของโหนดนี้
สว่าง
getLight()
รับไฟปัจจุบันซึ่งเปลี่ยนแปลงไม่ได้
สุดท้าย Vector3
getLocalPosition()
รับสําเนาของตําแหน่งโหนดที่เกี่ยวข้องกับระดับบนสุด (พื้นที่ภายใน)
สุดท้าย ไตรมาส
getLocalRotation()
รับสําเนาการหมุนเวียนโหนดที่เกี่ยวข้องกับระดับบนสุด (พื้นที่ภายใน)
สุดท้าย Vector3
getLocalScale()
รับสําเนาของสเกลโหนดที่เกี่ยวข้องกับระดับบนสุด (พื้นที่ภายใน)
สุดท้าย สตริง
getName()
แสดงผลชื่อของโหนด
สุดท้าย โหนด
getผู้ปกครอง()
แสดงผลระดับบนสุดของโหนดนี้
แสดงผลได้
getRenderable()
ทําให้การแสดงผลแสดงผลสําหรับโหนดนี้
สุดท้าย Vector3
getRight()
รับเวกเตอร์พื้นที่ด้านขวา (+x) ของโหนดนี้
สุดท้าย โหมด
getScene()
แสดงผลโหมดที่โหนดนี้เป็นส่วนหนึ่งของ Null หากค่านั้นไม่ใช่'ฉากใดๆ
สุดท้าย Vector3
getUp()
รับเวกเตอร์พื้นที่ขึ้น (+y) ของโหนดนี้
สุดท้าย Vector3
getWorldPosition()
ขอสําเนาของตําแหน่งพื้นที่โลกของโหนด
สุดท้าย ไตรมาส
getWorldRotation()
รับสําเนาการหมุนเวียนพื้นที่ทํางานในโหนด
สุดท้าย Vector3
getWorldScale()
รับสําเนาของโหนดพื้นที่โลก
บูลีนสุดท้าย
isActive()
แสดงผลเป็น "จริง" หากโหนดทํางานอยู่
บูลีนสุดท้าย
isDescendantOf(ระดับบนของ NodeParent)
ตรวจสอบว่าระดับบนสุดของโหนดที่ระบุเป็นระดับบนระดับบนของโหนดนี้ซ้ําๆ
บูลีนสุดท้าย
isEnabled()
รับสถานะที่เปิดใช้ของโหนดนี้
บูลีน
isTopLevel()
แสดงผลเป็น "จริง" หากโหนดนี้เป็นระดับบนสุด
สุดท้าย Vector3
localToWorldDirection(Vector3ทิศทาง)
แปลงทิศทางจากพื้นที่ในเครื่องของโหนดนี้เป็นโลก
สุดท้าย Vector3
localToWorldPoint(Vector3 จุด)
แปลงจุดในพื้นที่ท้องถิ่นของโหนดนี้เป็นการเว้นวรรค
เป็นโมฆะ
onActivate()
จัดการเมื่อโหนดนี้เริ่มทํางาน
เป็นโมฆะ
onการปิดใช้งาน()
จัดการเมื่อโหนดนี้ไม่ทํางาน
บูลีน
onTouchEvent(HitTestResult HitTestResult, MotionEvent ภาพเคลื่อนไหว
จัดการเมื่อแตะโหนดนี้
เป็นโมฆะ
onTransformChange(NodeoriginNode)
จัดการเมื่อการเปลี่ยนโหนดนี้มีการเปลี่ยนแปลง
เป็นโมฆะ
onUpdate(FrameTimeFrameTime)
จัดการเมื่ออัปเดตโหนดนี้
เป็นโมฆะ
removeLifecycleListener(Node.LifecycleListener LifecycleListener)
นํา Listener ที่ระบบจะเรียกใช้เมื่อเกิดเหตุการณ์วงจรโหนด
เป็นโมฆะ
removeTransformChangedListener (Node.TransformChangedListener TransformChangedListener)
นํา Listener ที่ระบบจะเรียกใช้ออกเมื่อการเปลี่ยนโหนด
เป็นโมฆะ
setCollisionShape(CollisionShapecolisionShape)
ตั้งค่ารูปร่างที่ใช้ตรวจหาการชนกันของ Node นี้
ค่าสุดท้าย
setEnabled(เปิดใช้บูลีน)
ตั้งค่าสถานะการเปิดใช้ของโหนดนี้
เป็นโมฆะ
setLight(สว่างสว่าง)
ตั้งค่า Light ให้แสดง
เป็นโมฆะ
setLocalPosition(ตําแหน่ง Vector3)
กําหนดตําแหน่งของโหนดนี้เมื่อเทียบกับโหนดหลัก (local-space)
เป็นโมฆะ
setLocalRotation(ควอร์เตอร์การหมุน)
ตั้งค่าการหมุนของโหนดนี้ตามโหนดระดับบน (local-space)
เป็นโมฆะ
setLocalScale(Vector3)
ตั้งค่าขนาดของโหนดนี้เมื่อเทียบกับระดับบนสุด (local-space)
ค่าสุดท้าย
setLookDirection(Vector3 LookDirection)
ตั้งค่าทิศทางที่โหนดกําลังดูในโลกแห่งพื้นที่
ค่าสุดท้าย
setLookDirection(Vector3 LookDirection, Vector3 upDirection)
ตั้งค่าทิศทางที่โหนดกําลังดูในโลกแห่งพื้นที่
ค่าสุดท้าย
setName(ชื่อ String)
ตั้งชื่อโหนดนี้
เป็นโมฆะ
setOntapListener(Node.OntapListener ontapListener)
ลงทะเบียนการเรียกกลับที่จะเรียกใช้เมื่อมีการแตะโหนดนี้
เป็นโมฆะ
setOnTouchListener(Node.OnTouchListener ononListener)
ลงทะเบียนการเรียกกลับที่จะเรียกใช้เมื่อมีการส่งกิจกรรมการสัมผัสไปยังโหนดนี้
เป็นโมฆะ
setPARENT(ผู้ปกครองของ NodeParent)
เปลี่ยนโหนดหลักของโหนดนี้
เป็นโมฆะ
setRenderable(แสดงผลได้ Renderable)
ตั้งค่า Renderable เพื่อแสดงสําหรับโหนดนี้
เป็นโมฆะ
setWorldPosition(ตําแหน่ง Vector3)
กําหนดตําแหน่งช่องว่างของโหนดนี้
เป็นโมฆะ
setWorldRotation(การหมุนการหมุน)
ตั้งค่าการหมุนพื้นที่โลกของโหนดนี้
เป็นโมฆะ
setWorldScale(Vector3 สเกล)
ตั้งค่าการปรับขนาดพื้นที่โลกของโหนดนี้
สตริง
สุดท้าย Vector3
worldToLocalDirection(Vector3ทิศทาง)
แปลงทิศทางจากพื้นที่ทํางานไปเป็นพื้นที่ท้องถิ่นของโหนดนี้
สุดท้าย Vector3
worldToLocalPoint(Vector3 จุด)
แปลงจุดในช่องว่างให้เป็นพื้นที่ท้องถิ่นของโหนดนี้

วิธีป้องกัน

บูลีนสุดท้าย
canAddChild(Node children, StringBuilder failedReason)
ค่าสุดท้าย
onAddChild(Node ย่อย)
ค่าสุดท้าย
onRemoveChild(Node ย่อย)

วิธีการที่รับค่ามา

ผู้ผลิตก่อสร้าง

สาธารณะ โหนด ()

สร้างโหนดที่ไม่มีระดับบนสุด

วิธีการสาธารณะ

สาธารณะ null addLifecycleListener (Node.LifecycleListener วงจรอายุการใช้งาน)

เพิ่ม Listener ที่จะเรียกเมื่อมีเหตุการณ์ในวงจรของโหนดเกิดขึ้น ระบบจะเรียกใช้ Listener ตามลําดับที่มีการเพิ่มไว้

พารามิเตอร์
ผู้ฟังวงจรการใช้งาน

สาธารณะ null addTransformChangedListener (Node.TransformChangedListener TransformChangedListener)

เพิ่ม Listener ที่จะเรียกเมื่อการเปลี่ยนโหนด

พารามิเตอร์
TransformChangedListener

สาธารณะ null callOnHierarchy (Consumer<Node> Consumer)

สํารวจลําดับชั้นและเรียกเมธอดในแต่ละโหนด (รวมถึงโหนดนี้) การส่งผ่านเป็นความลึกก่อน

พารามิเตอร์
ผู้บริโภค วิธีการเรียกใช้แต่ละโหนด

สาธารณะ โหนด findInHierarchy (Predicate<Node>condition)

สํารวจลําดับชั้นของการค้นหาเพื่อหาโหนดแรก (รวมถึงโหนดนี้) ที่ตรงกับเงื่อนไข เมื่อพบการข้ามเงื่อนไข การส่งผ่านจะหยุดลง การส่งผ่านคือความลึกที่มาก่อน

พารามิเตอร์
เงื่อนไข ระบุเงื่อนไขของโหนดที่จะค้นหา
การคืนสินค้า
  • โหนดแรกที่ตรงกับเงื่อนไขของ predicate มิเช่นนั้น ระบบจะแสดงผลค่า Null

สาธารณะ สุดท้าย Vector3 getBack ()

รับเวกเตอร์พื้นที่กลับ (+z) ของโหนดนี้

การคืนสินค้า
  • เวกเตอร์ใหม่ที่แสดงถึงทิศทางย้อนกลับของโหนดในพื้นที่ว่างของโลก

สาธารณะ CollisionShape getCollisionShape ()

รับรูปร่างที่จะใช้สําหรับการชนกับโหนดนี้ หากรูปทรงเป็น Null และมีการตั้งค่า setRenderable(Renderable) ระบบจะใช้ getCollisionShape() เพื่อตรวจหาการชนกันของ Node นี้

การคืนสินค้า
  • แสดงรูปทรงเรขาคณิต เช่น ทรงกลม, กล่อง, แท่งนูน

สาธารณะ สุดท้าย Vector3 getdown ()

นําเวกเตอร์พื้นที่ (-y) ลงของโหนดนี้

การคืนสินค้า
  • เวกเตอร์ใหม่ที่แสดงถึงโหนดลงล่างโหนดในพื้นที่ว่างของโลก

สาธารณะ สุดท้าย Vector3 getForward ()

รับเวกเตอร์ส่งต่อพื้นที่ (-z) ของโหนดนี้

การคืนสินค้า
  • เวกเตอร์ใหม่ที่แสดงถึงทิศทางข้างหน้าของโหนดในพื้นที่ว่างของโลก

สาธารณะ สุดท้าย Vector3 get left ()

รับเวกเตอร์พื้นที่ซ้าย (-x) ของโหนดนี้

การคืนสินค้า
  • เวกเตอร์ใหม่ที่แสดงถึงทิศทางซ้ายของโหนด' ในพื้นที่ทํางาน

สาธารณะ สว่าง getLight ()

รับไฟปัจจุบันซึ่งเปลี่ยนแปลงไม่ได้

สาธารณะ สุดท้าย Vector3 getLocalPosition ()

รับสําเนาของตําแหน่งโหนดที่เกี่ยวข้องกับระดับบนสุด (พื้นที่ภายใน) หาก isTopLevel() เป็นจริง ค่านี้จะเหมือนกับ getWorldPosition()

การคืนสินค้า
  • เวกเตอร์ใหม่ที่แสดงถึงตําแหน่งพื้นที่ภายในโหนดของโหนด ##39
ดูเพิ่มเติม

สาธารณะ สุดท้าย ไตรมาส getLocalRotation ()

รับสําเนาการหมุนเวียนโหนดที่เกี่ยวข้องกับระดับบนสุด (พื้นที่ภายใน) หาก isTopLevel() เป็นจริง ค่านี้จะเหมือนกับ getWorldRotation()

การคืนสินค้า
  • ควอไทล์ใหม่ซึ่งแสดงถึงการหมุนพื้นที่ภายในโหนดของโหนด
ดูเพิ่มเติม

สาธารณะ สุดท้าย Vector3 getLocalScale ()

รับสําเนาของสเกลโหนดที่เกี่ยวข้องกับระดับบนสุด (พื้นที่ภายใน) หาก isTopLevel() เป็นจริง ค่านี้จะเหมือนกับ getWorldScale()

การคืนสินค้า
  • เวกเตอร์ใหม่ที่แสดงถึงอัตราส่วนพื้นที่ท้องถิ่นของโหนด' ในเครื่อง
ดูเพิ่มเติม

สาธารณะ สุดท้าย สตริง getName ()

แสดงผลชื่อของโหนด ค่าเริ่มต้นคือ "Node"

สาธารณะ สุดท้าย โหนด getParent ()

แสดงผลระดับบนสุดของโหนดนี้ หาก Node นี้มีผู้ปกครองและระดับบนสุดนั้นเป็นกลุ่มย่อย Node หรือ Node ฟังก์ชันนี้จะแสดงผลระดับบนสุดเป็น Node แสดงผลเป็น Null หากระดับบนสุดเป็น Scene ให้ใช้ getScene() เพื่อดึงข้อมูลระดับบนสุดแทน

การคืนสินค้า
  • ผู้ปกครองในฐานะ Node หากผู้ปกครองคือ Node

สาธารณะ แสดงผลได้ getRenderable ()

ทําให้การแสดงผลแสดงผลสําหรับโหนดนี้

การคืนสินค้า
  • แสดงผลได้เพื่อแสดงสําหรับโหนดนี้

สาธารณะ สุดท้าย Vector3 getRight ()

รับเวกเตอร์พื้นที่ด้านขวา (+x) ของโหนดนี้

การคืนสินค้า
  • เวกเตอร์ใหม่ที่แสดงถึงโหนดที่ถูกต้องของโหนดในพื้นที่โลก

สาธารณะ สุดท้าย โหมด getScene ()

แสดงผลโหมดที่โหนดนี้เป็นส่วนหนึ่งของ Null หากค่านั้นไม่ใช่'ฉากใดๆ โหนดเป็นส่วนหนึ่งของฉากหากระดับบนระดับบนคือ Scene

สาธารณะ สุดท้าย Vector3 getUp ()

รับเวกเตอร์พื้นที่ขึ้น (+y) ของโหนดนี้

การคืนสินค้า
  • เวกเตอร์ใหม่ที่แสดงถึงโหนด&#39 ขึ้นตามทิศทางในพื้นที่ว่างบนโลก

สาธารณะ สุดท้าย Vector3 getWorldPosition ()

ขอสําเนาของตําแหน่งพื้นที่โลกของโหนด

การคืนสินค้า
  • เวกเตอร์ใหม่ที่แสดงตําแหน่งพื้นที่อวกาศของโหนด'
ดูเพิ่มเติม

สาธารณะ สุดท้าย ควอเตอร์ getWorldRotation ()

รับสําเนาการหมุนเวียนพื้นที่ทํางานในโหนด

การคืนสินค้า
  • ควอตใหม่ที่แสดงถึงการหมุนรอบโลกของโหนด'
ดูเพิ่มเติม

สาธารณะ สุดท้าย Vector3 getWorldScale ()

รับสําเนาของโหนดพื้นที่โลก โหนดบางรายการจะสูญเสียความแม่นยําหากบิดเบือนโหนด

การคืนสินค้า
  • เวกเตอร์ใหม่ที่แสดงถึงการปรับขนาดพื้นที่โลกของโหนด'
ดูเพิ่มเติม

บูลีน ขั้นตอนสุดท้าย isActive ()

แสดงผลเป็น "จริง" หากโหนดทํางานอยู่ ระบบจะถือว่าโหนดทํางานอยู่หากเป็นไปตามเงื่อนไขทั้งหมดต่อไปนี้

  • โหนดนี้เป็นส่วนหนึ่งของฉาก
  • โหนดหลักของโหนดทํางานอยู่
  • เปิดใช้โหนดอยู่
โหนดที่ทํางานอยู่จะมีลักษณะการทํางานดังนี้
  • ฟังก์ชัน onUpdate(FrameTime) ของโหนดจะเรียกใช้ทุกเฟรม
  • โหนด getRenderable() จะแสดงผล
  • โหนดของ getCollisionShape() จะได้รับการตรวจสอบในการเรียกใช้ Scene.hitTest
  • ระบบจะเรียกใช้ฟังก์ชัน onTouchEvent(HitTestResult, MotionEvent) ของโหนดเมื่อแตะโหนด

การคืนสินค้า
  • สถานะการใช้งานของโหนด
ดูเพิ่มเติม

บูลีน สุดท้าย บูลีน isDescendantOf (NodeParental) ระดับบน)

ตรวจสอบว่าระดับบนสุดของโหนดที่ระบุเป็นระดับบนระดับบนของโหนดนี้ซ้ําๆ

พารามิเตอร์
ระดับบน โหนดหลักของโหนดที่จะตรวจสอบ
การคืนสินค้า
  • true หากโหนดเป็นระดับบนของโหนดนี้

บูลีน ขั้นตอนสุดท้าย isEnabled ()

รับสถานะที่เปิดใช้ของโหนดนี้ โปรดทราบว่าโหนดอาจเปิดใช้อยู่แต่ไม่ทํางานหากไม่ได้เป็นส่วนหนึ่งของฉากหรือในกรณีที่โหนดหลักไม่ทํางาน

การคืนสินค้า
  • โหนดที่เปิดใช้โหนด
ดูเพิ่มเติม

บูลีน สาธารณะ isTopLevel ()

แสดงผลเป็น "จริง" หากโหนดนี้เป็นระดับบนสุด โหนดจะถือเป็นระดับบนสุดหากไม่มีโหนดหรือระดับบนสุดคือฉาก

การคืนสินค้า
  • true ถ้าโหนดอยู่ในระดับบนสุด

สาธารณะ สุดท้าย Vector3 localToWorldDirection (Vector3 ทิศทาง)

แปลงทิศทางจากพื้นที่ในเครื่องของโหนดนี้เป็นโลก โดยตําแหน่งหรือขนาดโหนดจะไม่ได้รับผลกระทบจาก

พารามิเตอร์
เส้นทาง ทิศทางในพื้นที่ท้องถิ่นเพื่อแปลง
การคืนสินค้า
  • เวกเตอร์ใหม่ที่แสดงถึงทิศทางในพื้นที่ทํางาน

สาธารณะ สุดท้าย Vector3 localToWorldPoint (Vector3 จุด)

แปลงจุดในพื้นที่ท้องถิ่นของโหนดนี้เป็นการเว้นวรรค

พารามิเตอร์
คะแนน จุดในพื้นที่ท้องถิ่นเพื่อแปลง
การคืนสินค้า
  • เวกเตอร์ใหม่ที่แสดงถึงจุดในพื้นที่ทํางาน

โฟลเดอร์สาธารณะ onActivate ()

จัดการเมื่อโหนดนี้เริ่มทํางาน โหนดจะทํางานหากเปิดใช้ เป็นส่วนหนึ่งของฉาก และโหนดหลักทํางานอยู่

ลบล้างเพื่อดําเนินการตั้งค่าที่จําเป็นเมื่อเปิดใช้งานโหนด

ดูเพิ่มเติม

โฟลเดอร์สาธารณะ เมื่อปิดใช้งาน ()

จัดการเมื่อโหนดนี้ไม่ทํางาน โหนดจะไม่ทํางานหากปิดใช้โหนด ไม่ใช่ส่วนหนึ่งของฉาก หรือไม่มีโหนดหลักของโหนด

ลบล้างเพื่อดําเนินการตั้งค่าต่างๆ ที่จะเกิดขึ้นเมื่อโหนดปิดใช้งาน

ดูเพิ่มเติม

บูลีน สาธารณะ onTouchEvent (HitTestResult HitTestResult, MotionEvent MotionEvent)

จัดการเมื่อแตะโหนดนี้

ลบล้างเพื่อทําตรรกะที่ควรจะเกิดขึ้นเมื่อเมื่อมีการแตะโหนดนี้ การเผยแพร่เหตุการณ์การสัมผัสจะถ่ายทอดวิธีสัมผัสไปยัง Android View ซึ่งจะเรียกใช้เฉพาะเมื่อโหนดทํางานอยู่

เมื่อเกิดเหตุการณ์ ACTION_DOWN นั่นหมายถึงจุดเริ่มต้นของท่าทางสัมผัส ACTION_UP หรือ ACTION_cancel แสดงแทนเมื่อท่าทางสัมผัสสิ้นสุด เมื่อท่าทางสัมผัสเริ่มดําเนินการแล้ว จะมีการดําเนินการดังต่อไปนี้

  • ส่งเหตุการณ์การแตะไปยังโหนดที่มีการสัมผัสตามที่ hitTest(MotionEvent) ตรวจพบ
  • หากโหนดไม่ได้ใช้กิจกรรม ให้เกิดซ้ําขึ้นผ่านโหนดของโหนดระดับบนสุดและจัดสรรเหตุการณ์การแตะจนกว่าโหนดใดโหนดหนึ่งจะใช้เหตุการณ์นั้น
  • หากไม่มีโหนดที่ใช้เหตุการณ์ ระบบจะไม่สนใจท่าทางสัมผัสดังกล่าว เหตุการณ์ที่ตามมาซึ่งเป็นส่วนหนึ่งของท่าทางสัมผัสจะไม่ส่งไปยังโหนดใดๆ
  • หากโหนดใดโหนดหนึ่งใช้เหตุการณ์ โหนดนั้นจะใช้เหตุการณ์การแตะทั้งหมดในอนาคตสําหรับท่าทางสัมผัสนั้น
เมื่อมีการส่งเหตุการณ์การแตะไปยังโหนด ระบบจะส่งเหตุการณ์ไปยังโหนดก่อน Node.OnTouchListener หาก Node.OnTouchListener ไม่ได้จัดการกิจกรรม ระบบจะส่งผ่านไปยัง onTouchEvent(HitTestResult, MotionEvent)

พารามิเตอร์
ผลการทดสอบ Hit แสดงโหนดที่มีการสัมผัสและข้อมูลเกี่ยวกับตําแหน่งที่มีการสัมผัส ในเหตุการณ์ ACTION_DOWN getNode() จะเป็นโหนดนี้หรือโหนดใดโหนดหนึ่งเสมอ สําหรับเหตุการณ์อื่นๆ การสัมผัสอาจย้ายไปทําให้ getNode() เปลี่ยนแปลง (หรืออาจเป็น Null)
เหตุการณ์การเคลื่อนไหว เหตุการณ์การเคลื่อนไหว
การคืนสินค้า
  • True หากจัดการกิจกรรม จะเป็นเท็จ

สาธารณะ null onTransformChange (NodeoriginNode)

จัดการเมื่อการเปลี่ยนโหนดนี้มีการเปลี่ยนแปลง

โหนดต้นทางเป็นโหนดระดับบนสุดที่สุดในลําดับชั้นที่ทริกเกอร์โหนดนี้มีการเปลี่ยนแปลง โดยจะเป็นโหนดเดียวกันหรือโหนดใดโหนดหนึ่งของระดับบนสุดเสมอ เช่น หากตําแหน่ง A และ #39 มีการเปลี่ยนแปลง ทริกเกอร์จะเรียกใช้ onTransformChange(Node) กับโหนดทั้งหมดของโหนดย่อยทั้ง 3 ที่มีโหนดต้นทาง A

พารามิเตอร์
โหนดต้นทาง โหนดที่เรียกใช้การเปลี่ยนแปลงโหนดนี้

สาธารณะ null onUpdate (FrameTimeframeTime)

จัดการเมื่ออัปเดตโหนดนี้ ระบบจะอัปเดตโหนดก่อนแสดงผลแต่ละเฟรม การดําเนินการนี้เรียกใช้เฉพาะเมื่อโหนดทํางานอยู่

ลบล้างเพื่อดําเนินการอัปเดตที่จําเป็นต้องเกิดขึ้นในแต่ละเฟรม

พารามิเตอร์
เวลาที่ใช้ในการแสดงผลเฟรม ให้ข้อมูลเวลาของเฟรมปัจจุบัน

สาธารณะ null removeLifecycleListener (Node.LifecycleListener วงจรอายุการใช้งาน)

นํา Listener ที่ระบบจะเรียกใช้เมื่อเกิดเหตุการณ์วงจรโหนด

พารามิเตอร์
ผู้ฟังวงจรการใช้งาน

สาธารณะ null removeTransformChangedListener (Node.TransformChangedListener TransformChangedListener)

นํา Listener ที่ระบบจะเรียกใช้ออกเมื่อการเปลี่ยนโหนด

พารามิเตอร์
TransformChangedListener

สาธารณะ null setCollisionShape (CollisionShapellisionShape)

ตั้งค่ารูปร่างที่ใช้ตรวจหาการชนกันของ Node นี้ หากไม่ได้ตั้งค่ารูปร่างไว้และตั้งค่า setRenderable(Renderable) ระบบจะใช้ getCollisionShape() เพื่อตรวจหาการชนกันของ Node นี้

พารามิเตอร์
รูปร่างการชนกัน แสดงรูปทรงเรขาคณิต เช่น ทรงกลม, กล่อง, แท่งนูน หากเป็น Null ระบบจะนํารูปร่างการชนในปัจจุบันของโหนดนี้ออก

สาธารณะ สุดท้าย null setEnabled (เปิดใช้บูลีน)

ตั้งค่าสถานะการเปิดใช้ของโหนดนี้ โปรดทราบว่าโหนดอาจเปิดใช้อยู่แต่ไม่ทํางานหากไม่ได้เป็นส่วนหนึ่งของฉากหรือในกรณีที่โหนดหลักไม่ทํางาน

พารามิเตอร์
เปิดใช้อยู่ สถานะเปิดใช้ใหม่ของโหนด
ดูเพิ่มเติม

โฟลเดอร์สาธารณะ setLight (แสง)

ตั้งค่า Light ให้แสดง หากต้องการใช้ ให้สร้าง Light โดยใช้ Light.Builder ก่อน ตั้งค่าพารามิเตอร์ที่คุณสนใจแล้วแนบกับโหนดโดยใช้ฟังก์ชันนี้ โหนดอาจมีการแสดงผลและแสง หรือทําหน้าที่เป็น Light

พารามิเตอร์
ไฟ คุณสมบัติของ Light เพื่อแสดงผล ให้ส่งค่าเป็น Null เพื่อนําแสงออก

สาธารณะ null setLocalPosition (Vector3ตําแหน่ง)

กําหนดตําแหน่งของโหนดนี้เมื่อเทียบกับโหนดหลัก (local-space) หาก isTopLevel() เป็นจริง ค่านี้จะเหมือนกับ setWorldPosition(Vector3)

พารามิเตอร์
position อันดับที่ต้องการสมัคร
ดูเพิ่มเติม

สาธารณะ null setLocalRotation (Quaternionการหมุนเวียน)

ตั้งค่าการหมุนของโหนดนี้ตามโหนดระดับบน (local-space) หาก isTopLevel() เป็นจริง ค่านี้จะเหมือนกับ setWorldRotation(Quaternion)

พารามิเตอร์
การหมุน การหมุนที่จะใช้
ดูเพิ่มเติม

สาธารณะ null setLocalScale (Vector3 Scale)

ตั้งค่าขนาดของโหนดนี้เมื่อเทียบกับระดับบนสุด (local-space) หาก isTopLevel() เป็นจริง ค่านี้จะเหมือนกับ setWorldScale(Vector3)

พารามิเตอร์
ขนาด สเกลที่จะใช้
ดูเพิ่มเติม

สาธารณะ สุดท้าย null setLookDirection (Vector3 LookDirection)

ตั้งค่าทิศทางที่โหนดกําลังดูในโลกแห่งพื้นที่ หลังจากเรียกใช้ getForward() จะจับคู่กับทิศทางของรูปลักษณ์ที่ส่งผ่าน ช่องว่างโลกขึ้น (0, 1, 0) จะใช้เพื่อกําหนดการวางแนวของโหนดรอบๆ ทิศทาง

พารามิเตอร์
ดูทิศทาง เวกเตอร์ที่แสดงทิศทางมุมมองที่ต้องการในพื้นที่ว่างของโลก

สาธารณะ สุดท้าย null setLookDirection (Vector3 LookDirection, Vector3 upDirection)

ตั้งค่าทิศทางที่โหนดกําลังดูในโลกแห่งพื้นที่ หลังจากเรียกใช้ getForward() จะจับคู่กับทิศทางของรูปลักษณ์ที่ส่งผ่าน ทิศทางชี้ขึ้นจะกําหนดการวางแนวโหนดรอบๆ ทิศทาง ทิศทางของทิศทางและทิศทางขึ้นต้องไม่ตรงกัน (ขนานกัน) ไม่เช่นนั้นการวางแนวอาจไม่ถูกต้อง

พารามิเตอร์
ดูทิศทาง เวกเตอร์ที่แสดงทิศทางมุมมองที่ต้องการในพื้นที่ว่างของโลก
ทิศทางขึ้น เวกเตอร์ที่แสดงเวกเตอร์ที่ใช้จริง เช่น Vector3.up()

สาธารณะ สุดท้าย null setName (สตริง ชื่อ)

ตั้งชื่อโหนดนี้ โหนดต่างๆ จะอยู่ในชื่อ โหนดหลายรายการอาจมีชื่อเดียวกัน ซึ่งในกรณีนี้การเรียก findByName(String) จะแสดงผลโหนดแรกโดยใช้ชื่อที่ระบุ

พารามิเตอร์
name ชื่อของโหนด

สาธารณะ null setOn TapListener (Node.OntapListener ontapListener)

ลงทะเบียนการเรียกกลับที่จะเรียกใช้เมื่อมีการแตะโหนดนี้ หากมีการบันทึกการเรียกกลับไว้ เหตุการณ์การแตะจะไม่แสดงไปยังโหนดของโหนดนี้ หากลบล้าง Node.onTouchEvent แล้วไม่ได้เรียก Super.onTouchEvent การแตะจะไม่เกิดขึ้น

พารามิเตอร์
เปิด TapListener
ดูเพิ่มเติม

สาธารณะ null setOnTouchListener (Node.OnTouchListener onTouchListener)

ลงทะเบียนการเรียกกลับที่จะเรียกใช้เมื่อมีการส่งกิจกรรมการสัมผัสไปยังโหนดนี้ การเผยแพร่เหตุการณ์การสัมผัสจะถ่ายทอดวิธีสัมผัสไปยัง Android View ซึ่งจะเรียกใช้เฉพาะเมื่อโหนดทํางานอยู่

เมื่อเกิดเหตุการณ์ ACTION_DOWN นั่นหมายถึงจุดเริ่มต้นของท่าทางสัมผัส ACTION_UP หรือ ACTION_cancel แสดงแทนเมื่อท่าทางสัมผัสสิ้นสุด เมื่อท่าทางสัมผัสเริ่มดําเนินการแล้ว จะมีการดําเนินการดังต่อไปนี้

  • ส่งเหตุการณ์การแตะไปยังโหนดที่มีการสัมผัสตามที่ hitTest(MotionEvent) ตรวจพบ
  • หากโหนดไม่ได้ใช้กิจกรรม ให้เกิดซ้ําขึ้นผ่านโหนดของโหนดระดับบนสุดและจัดสรรเหตุการณ์การแตะจนกว่าโหนดใดโหนดหนึ่งจะใช้เหตุการณ์นั้น
  • หากไม่มีโหนดที่ใช้เหตุการณ์ ระบบจะไม่สนใจท่าทางสัมผัสดังกล่าว เหตุการณ์ที่ตามมาซึ่งเป็นส่วนหนึ่งของท่าทางสัมผัสจะไม่ส่งไปยังโหนดใดๆ
  • หากโหนดใดโหนดหนึ่งใช้เหตุการณ์ โหนดนั้นจะใช้เหตุการณ์การแตะทั้งหมดในอนาคตสําหรับท่าทางสัมผัสนั้น
เมื่อมีการส่งเหตุการณ์การแตะไปยังโหนด ระบบจะส่งเหตุการณ์ไปยังโหนดก่อน Node.OnTouchListener หาก Node.OnTouchListener ไม่ได้จัดการกิจกรรม ระบบจะส่งผ่านไปยัง onTouchEvent(HitTestResult, MotionEvent)

พารามิเตอร์
ใน onListenerListener
ดูเพิ่มเติม

สาธารณะ null setPARENT (NodeParental)

เปลี่ยนโหนดหลักของโหนดนี้ หากตั้งค่าเป็น Null ระบบจะแยกโหนดนี้ออกจากโหนดหลัก ตําแหน่ง การหมุน และการปรับขนาดของโหนดในเครื่องจะยังคงเหมือนเดิม ดังนั้น ตําแหน่งของโลก การหมุน และการปรับขนาดของโหนดนี้อาจแตกต่างกันหลังจากที่ระดับบนสุดมีการเปลี่ยนแปลง

ผู้ปกครองอาจเป็น Node หรือ Scene อีกคน หากเป็นฉาก Node นี้จะถือว่าเป็นระดับบนสุด getParent() จะคืนค่าเป็น Null และ getScene() จะส่งคืนฉาก

พารามิเตอร์
ระดับบนสุด โหนดหลักที่โหนดนี้จะเป็นรายการย่อย หากเป็น Null ระบบจะปลดโหนดนี้ออกจากโหนดหลัก
ดูเพิ่มเติม

สาธารณะ null setRenderable (แสดงผลได้ แสดงผล)

ตั้งค่า Renderable เพื่อแสดงสําหรับโหนดนี้ หากไม่ได้ตั้งค่า setCollisionShape(CollisionShape) ระบบจะใช้ getCollisionShape() เพื่อตรวจหาการชนกันของ Node นี้

พารามิเตอร์
แสดงผลได้ โดยปกติจะเป็นโมเดล 3 มิติ หากเป็น Null ระบบจะนําการแสดงผลปัจจุบันของโหนดนี้ออก
ดูเพิ่มเติม

สาธารณะ null setWorldPosition (Vector3ตําแหน่ง)

กําหนดตําแหน่งช่องว่างของโหนดนี้

พารามิเตอร์
position อันดับที่ต้องการสมัคร
ดูเพิ่มเติม

สาธารณะ null setWorldRotation (Quaternionการหมุนเวียน)

ตั้งค่าการหมุนพื้นที่โลกของโหนดนี้

พารามิเตอร์
การหมุน การหมุนที่จะใช้
ดูเพิ่มเติม

สาธารณะ null setWorldScale (Vector3 Scale)

ตั้งค่าการปรับขนาดพื้นที่โลกของโหนดนี้

พารามิเตอร์
ขนาด สเกลที่จะใช้
ดูเพิ่มเติม

สาธารณะ สตริง toString ()

สาธารณะ สุดท้าย Vector3 worldToLocalDirection (ทิศทางที่ 3)

แปลงทิศทางจากพื้นที่ทํางานไปเป็นพื้นที่ท้องถิ่นของโหนดนี้ โดยตําแหน่งหรือขนาดโหนดจะไม่ได้รับผลกระทบจาก

พารามิเตอร์
เส้นทาง ทิศทางในพื้นที่ทํางานซึ่งจะแปลง
การคืนสินค้า
  • เวกเตอร์ใหม่ที่แสดงถึงทิศทางในพื้นที่ท้องถิ่น

สาธารณะ สุดท้าย Vector3 worldToLocalPoint (Vector3 จุด)

แปลงจุดในช่องว่างให้เป็นพื้นที่ท้องถิ่นของโหนดนี้

พารามิเตอร์
คะแนน จุดบนช่องว่างของโลกเพื่อแปลง
การคืนสินค้า
  • เวกเตอร์ใหม่ที่แสดงถึงจุดในพื้นที่ท้องถิ่น

วิธีป้องกัน

บูลีน สุดท้าย บูลีน canAddChild (โหนด, StringBuilder failedReason)

พารามิเตอร์
เด็ก
เหตุผลที่ล้มเหลว

ปกป้อง สุดท้าย เวน onAddChild (Node children)

พารามิเตอร์
เด็ก

ปกป้อง สุดท้าย เวล onRemoveChild (โหนด ย่อย)

พารามิเตอร์
เด็ก