מצלמה

מחלקה ציבורית מצלמה

מייצג מצלמה וירטואלית, שקובעת את נקודת המבט שבה צופים בסצנה.

אם המצלמה היא חלק מ-ArSceneView, המצלמה תעקוב באופן אוטומטי אחר עמדת המצלמה של ARCore. כמו כן, השיטות הבאות יידחו את UnsupportedOperationException כשהקריאה תהיה:

• setParent(NodeParent) - לא ניתן לשנות את ההורים של המצלמה. זו תמיד הסצנה.
• setLocalPosition(Vector3) - לא ניתן לשנות את המיקום של המצלמה או לשלוט בה על ידי עמדת המצלמה של ARCore.
• setLocalRotation(Quaternion) – לא ניתן לשנות את הסבב של המצלמה.
• setWorldPosition(Vector3) - לא ניתן לשנות את המיקום של המצלמה או לשלוט בה על ידי עמדת המצלמה של ARCore.
• setWorldRotation(Quaternion) – לא ניתן לשנות את הסבב של המצלמה.

כל פונקציונליות אחרת בצומת תהיה נתמכת. אפשר לגשת למיקום ולסיבוב של המצלמה, להקצות צורת התנגשות למצלמה או להוסיף ילדים למצלמה. השבתת המצלמה משביתה את העיבוד.

שיטות ציבוריות

מספר ממשי (float)	getFarClipPlane()
מספר ממשי (float)	getNearClipPlane()
מספר ממשי (float)	getVerticalFowDegrees() מקבלת את שדה הראייה האנכי של המצלמה.
ריי	screenPointToRay (float x, float y) מחשבת קרן בחלל בעולם שעוברת מהמטוס הקרוב של המצלמה ועוברת בנקודה בשטח המסך.
ביטול	setLocalLocation(מיקום Vector3) הגדרת המיקום של המצלמה.
ביטול	setLocalRotation(סבב Quaternion) מגדירים את סיבוב המצלמה.
ביטול	set הורה(הורה ראשי) הפעולה לא נתמכת.
ביטול	setVerticalFobDegrees(צף אנכיFob) מגדירה את שדה הראייה האנכי של המצלמה שאינה במעלות.
ביטול	setWorldLocation(מיקום Vector3) הגדרת המיקום של המצלמה.
ביטול	setWorldRotation(Quaternion סבב) מגדירים את סיבוב המצלמה.
וקטור3	worldToScreenPoint(נקודהשל Vector3) המרת נקודה מהחלל המשותף לחלל המסך.

שיטות שעברו בירושה

מתוך הכיתה com.google.ar.sceneform.Node

ביטול	addLifecycleListener(Node.LifecycleListener LifecycleListener) מוסיף מאזינים שייקראו כאשר יתקיימו אירועים במחזור החיים של הצומת.
ביטול	addTransformChangedListener(Node.TransformChangedListener transformChangedListener) מוסיף מאזינים שייקראו בעת שינוי הטרנספורמציה של הצומת #39.
ביטול	callOnHiirrchy(Consumer<Node> Consumer) חוצה את ההיררכיה וקוראים לשיטה בכל צומת (כולל הצומת הזה).
ערך בוליאני סופי	canAddChild(צאצא של צומת, סיבת הכשל של StringBuilder)
צומת	findInHiirrchy(Predicate<Node>condition) חוצה את ההיררכיה כדי למצוא את הצומת הראשון (כולל הצומת הזה) שעומד בתנאי.
סופי Vector3	getBack() מקבל את הוקטור האחורי של המרחב המשותף (+z) עבור הצומת הזה.
צורת התנגשות	getCollisionצורת() קבלת הצורה לשימוש עבור התנגשויות עם הצומת הזה.
סופי Vector3	getdown() מקבל את הווקטור כלפי מטה של המרחב המשותף (-y) של הצומת הזה.
סופי Vector3	getforward() מקבלת את הווקטור הקדמי של המרחב המשותף (-z) עבור הצומת הזה.
סופי Vector3	getleft() מקבל את הוקטור השמאלי של המרחב המשותף (-x) עבור הצומת הזה.
בהיר	getLight() מקבל את האור הנוכחי, שניתן לשנות אותו.
סופי Vector3	getLocalLocation() קבלת עותק של מיקום הצמתים ביחס להורה שלו (מרחב מקומי).
סופי רבעון	getLocalRotation() קבלת עותק של סבב הצמתים ביחס להורה שלו (מרחב מקומי).
סופי Vector3	getLocalScale() יוצג עותק של קנה המידה של הצמתים ביחס להורה שלו (מרחב מקומי).
סופי מחרוזת	getName() מחזירה את שם הצומת.
סופי צומת	getהורה() מחזירה את ההורה של הצומת הזה.
ניתן לעיבוד	getRenderable() מקבל אפשרות להצגה של הצומת הזה.
סופי Vector3	getright() מקבל את הוקטור הימני של המרחב המשותף (+x) עבור הצומת הזה.
סופי סצנה	getScene() מחזירה את הצומת שהצומת הוא חלק ממנו, null אם הוא לא חלק מסצנה כלשהי.
סופי Vector3	getUp() מקבלת את הווקטור של המרחב המשותף למעלה (+y) של הצומת הזה.
סופי Vector3	getWorldLocation() עותק של מיקום הצמתים בעולם.
סופי רבעון	getWorldRotation() קבלת עותק של סבב המרחבים המשותפים.
סופי Vector3	getWorldScale() קבלת עותק של קנה המידה של המרחב המשותף בצמתים.
ערך בוליאני סופי	isActive() פונקציה זו מחזירה את הערך True אם הצומת פעיל.
ערך בוליאני סופי	isDescendantOf(Nodeהורה אב) מתבצעת בדיקה אם הצומת האב הוא אב של הצומת בצורה חוזרת.
ערך בוליאני סופי	isEnabled() קבלת המצב הפעיל של הצומת הזה.
boolean	isTopLevel() פונקציה זו מחזירה את הערך True אם הצומת הזה הוא ברמה העליונה.
סופי Vector3	localToWorldDirection(כיוון Vector3) ממירה כיוון מהמרחב המקומי של הצומת הזה למרחב משותף.
סופי Vector3	localToWorldPoint(נקודה אחת (Vector3) ממירה נקודה במרחב המקומי של הצומת הזה למרחב משותף.
ביטול	onActivate() מטפל כשהצומת הזה הופך לפעיל.
ביטול סופי	onAddChild(צומת ילד)
ביטול	onהשבתה( מטפל כשהצומת הזה מושבת.
ביטול סופי	onRemoveChild(צומת ילד)
boolean	onTouchEvent(HitTestResult היטTestResult, MotionEvent trafficEvent) מטפל כשנוגעים בצומת הזה.
ביטול	onTransformChange(צומת שמקורו בצומת) מטפל כשטרנספורמציה של הצומת הזה משתנה.
ביטול	onUpdate(FrameTime frameworkTime) ניהול הטיפול כשהצומת הזה מעודכן.
ביטול	removelifecycleListener(Node.LifecycleListener LifecycleListener) הסרת מאזינים שייקראו במועד שבו מתרחשים אירועים במחזור החיים של הצומת.
ביטול	removeTransformChangedListener(Node.TransformChangedListener transformChangedListener) מסיר את המאזינים שייקראו כשהטרנספורמציה של הצומת תשתנה.
ביטול	setCollisionצורת(Collision הצורה התנגשות) מגדיר את הצורה המשמשת לזיהוי התנגשויות עבור Node.
ביטול סופי	setEnabled(הפעלה בוליאנית) הגדרת המצב הפעיל של הצומת הזה.
ביטול	setLight(בהיר) הגדרה של Light להצגה.
ביטול	setLocalLocation(מיקום Vector3) מגדיר את המיקום של הצומת הזה ביחס להורה שלו (מרחב מקומי).
ביטול	setLocalRotation(סבב Quaternion) מגדירה את הסיבוב של הצומת הזה ביחס להורה שלו (מרחב מקומי).
ביטול	setLocalScale(קנה מידה של Vector3) מגדיר את קנה המידה של הצומת הזה ביחס להורה שלו (מרחב מקומי).
ביטול סופי	setLookDirection(Vector3 LookDirection) הגדרת הכיוון שבו הצומת רואה במרחב המשותף.
ביטול סופי	setLookDirection(Vector3 LookDirection, Vector3 upDirection) הגדרת הכיוון שבו הצומת רואה במרחב המשותף.
ביטול סופי	setName(שם מחרוזת) מגדיר את השם של הצומת הזה.
ביטול	setOnTapListener(Node.OnTapListener onTapListener) רישום קריאה חוזרת (callback) להפעלת הצומת.
ביטול	setOnTouchListener(Node.OnTouchListener ב-TouchToucher) רושם קריאה חוזרת (callback) שיופעל כשאירוע מגע יישלח לצומת הזה.
ביטול	set הורה(הורה ראשי) שינוי הצומת של הצומת של הצומת הזה.
ביטול	setRenderable(ניתן לעיבוד (ניתן לעיבוד) מגדיר את Renderable להצגה עבור הצומת הזה.
ביטול	setWorldLocation(מיקום Vector3) הגדרת המיקום של המרחב המשותף של הצומת הזה בעולם.
ביטול	setWorldRotation(Quaternion סבב) מגדיר את סיבוב המרחב המשותף של הצומת הזה.
ביטול	setWorldScale(קנה מידה של Vector3) מגדיר את קנה המידה של המרחב המשותף בצומת הזה.
מחרוזת	toString()
סופי Vector3	worldToLocalDirection(מסלול וקטור3) ממירה כיוון ממרחב משותף למרחב המקומי של הצומת הזה.
סופי Vector3	worldToLocalPoint(נקודה אחת (Vector3) ממירה נקודה במרחב המשותף למרחב המקומי של הצומת הזה.

מתוך הכיתה com.google.ar.sceneform.Nodeהורה

ביטול סופי	addChild(צומת ילד) מוסיף צומת כצאצא של Nodeהורה זה.
ביטול	callOnHiirrchy(Consumer<Node> Consumer) חוצה את ההיררכיה וקוראים לשיטה בכל צומת.
boolean	canAddChild(צאצא של צומת, סיבת הכשל של StringBuilder)
צומת	findByName(שם מחרוזת) חוצה את ההיררכיה כדי למצוא את הצומת הראשון עם שם נתון.
צומת	findInHiirrchy(Predicate<Node>condition) חוצה את ההיררכיה כדי למצוא את הצומת הראשון שעומד בתנאי.
הסופי List<Node>	getkids() מחזירה רשימה קבועה של הילדים של ההורה הזה.
ביטול	onAddChild(צומת ילד)
ביטול	onRemoveChild(צומת ילד)
ביטול סופי	removeChild(צומת ילד) מסיר צומת מהילדים של הצומת הזה.

class Java.lang.Object

אובייקט	clone()
boolean	equals(Object arg0)
ביטול	finalize()
סופי class<?>	getClass()
int	HashCode()
ביטול סופי	know()
ביטול סופי	knowAll()
מחרוזת	toString()
ביטול סופי	Pending(long arg0, int arg1)
ביטול סופי	Pending (long arg0)
ביטול סופי	Pending()

שיטות ציבוריות

Public float getFarClipPlane ()

Public float getNearClipPlane ()

Public float getVerticalFowDegrees ()

מקבלת את שדה הראייה האנכי של המצלמה.

אם זו מצלמת AR, היא מחושבת על סמך פרטי המצלמה מ-ARCore ויכולה להשתנות בהתאם למכשיר. לא ניתן לחשב אותו עד לפריים הראשון אחרי המשך הסשן ב-ARCore, ובמקרה כזה המערכת תשליך IVStateStateExceptions.

אחרת, הפונקציה תחזיר את הערך שהוגדר על ידי setVerticalFovDegrees(float), כאשר ברירת המחדל היא 90 מעלות.

זריקות

invalidStateExceptions	קריאה לפני הפריים הראשון אחרי המשך ההפעלה של ARCore

גלוי לכול Ray screenPointToRay (float x, float y)

מחשבת קרן בחלל בעולם שעוברת מהמטוס הקרוב של המצלמה ועוברת בנקודה בשטח המסך. שטח המסך הוא בקואורדינטות המסך של מכשירי Android: Topleft = (0, 0) Bottomright = (רוחב מסך, גובה המסך) שטח הקואורדינטות של המכשיר לא מושפע מהכיוון של המכשיר.

פרמטרים

x	מיקום X בקואורדינטות של מסך המכשיר.
y	מיקום ה-Y בקואורדינטות של מסך המכשיר.

Public null setLocalLocation (מיקום Vector3)

הגדרת המיקום של המצלמה. המצלמה היא תמיד isTopLevel(), ולכן ההתנהגות שלה זהה לזו של setWorldPosition(Vector3).

אם המצלמה היא חלק מ-ArSceneView, זו פעולה לא נתמכת. לא ניתן לשנות את מיקום המצלמה והוא נשלט על ידי עמדת המצלמה של ARCore.

פרמטרים

position	המיקום להגשת הבקשה.

Public null setLocalRotation (סבב רבעון)

מגדירים את סיבוב המצלמה. המצלמה היא תמיד isTopLevel(), ולכן ההתנהגות שלה זהה לזו של setWorldRotation(Quaternion).

אם המצלמה היא חלק מ-ArSceneView, זו פעולה לא נתמכת. לא ניתן לשנות את הסיבוב של המצלמה או בשליטת המצלמה.

פרמטרים

סיבוב	הסיבוב ליישום.

Public null setparent (הורה הורה)

הפעולה לא נתמכת. לא ניתן לשנות את ההורה של המצלמה.

פרמטרים

הורה	ההורה החדש שאליו הצומת הזה יהיה צאצא. אם הוא ריק, הצומת הזה ינותק מההורה שלו.

Public null setVerticalFowDegrees (floatfloatFow)

מגדירה את שדה הראייה האנכי של המצלמה שאינה במעלות. אם זו מצלמת AR, המשמעות היא שב-ARCore אי אפשר להגדיר את התצורה, כך שיוצא חריגים. ברירת המחדל היא 90 מעלות.

פרמטרים

אנכי

זריקות

חריג לא נתמך להפעלה	אם זו מצלמת AR

Public null setWorldposition (מיקום Vcor3)

הגדרת המיקום של המצלמה. המצלמה היא תמיד isTopLevel(), ולכן ההתנהגות שלה זהה לזו של setLocalPosition(Vector3).

אם המצלמה היא חלק מ-ArSceneView, זו פעולה לא נתמכת. לא ניתן לשנות את מיקום המצלמה והוא נשלט על ידי עמדת המצלמה של ARCore.

פרמטרים

position	המיקום להגשת הבקשה.

Public null setWorldRotation (סבב רבעון)

מגדירים את סיבוב המצלמה. המצלמה היא תמיד isTopLevel(), ולכן ההתנהגות שלה זהה לזו של setLocalRotation(Quaternion).

אם המצלמה היא חלק מ-ArSceneView, זו פעולה לא נתמכת. לא ניתן לשנות את הסיבוב של המצלמה או בשליטת המצלמה.

פרמטרים

סיבוב	הסיבוב ליישום.

גלוי לכול Vector3 worldToScreenPoint (Vector3 נקודה)

המרת נקודה מהחלל המשותף לחלל המסך.

ערך ה-X שלילי כשנקודת התצפית באזור השמאלי נמצאת באזור שבין 0 לרוחב של SceneView, כשהנקודה נמצאת באזור התצוגה וגדולה יותר מהרוחב כשהנקודה נמצאת מימין לאזור התצוגה.

ערך ה-Y הוא שלילי כשהנקודה נמצאת מתחת לאזור התצוגה, בין 0 לגובה של SceneView כשהנקודה נמצאת באזור התצוגה וגבוהה מהגובה כשהנקודה נמצאת מעל אזור התצוגה.

ערך ה-Z הוא תמיד 0 כי ערך ההחזרה הוא קואורדינטה דו-ממדית.

פרמטרים

נקודה	הנקודה במרחב המשותף

החזרות

• וקטור חדש שמייצג את הנקודה במרחב המסך.