ArSceneView

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

SurfaceView המשולב עם ARCore ומעבד סצנה.

קבועים שעברו בירושה

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

בונים ציבוריים

ArSceneView(הקשר הקשר)
בונה אובייקט ArSceneView ומקשר אותו להקשר Android.
ArSceneView(הקשר, מאפיין מאפיין)
בונה אובייקט ArSceneView ומקשר אותו להקשר Android.

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

פריים
getArFrame()
מחזירה את מסגרת ARCore העדכנית ביותר, אם היא זמינה.
int
getCameraStreamRenderעדיפות()
קבלת עדיפות העיבוד השולטת בסדר העיבוד של זרם המצלמה.
פלייר רנדר
getPlaneRenderer()
פונקציה זו מחזירה את PlaneRenderer, המשמשת לשליטה בתצוגה החזותית של המטוס.
סשן
getSession()
מחזירה את הסשן של ARCore שבו משתמשת התצוגה הזו.
boolean
isEnvironmentalHdrLightingזמין()
פונקציה זו מחזירה את הערך true אם מצלמת ARCore מוגדרת עם Config.LightEstimationMode.ENVIRONMENTAL_HDR.
boolean
isLightDirectionUpdateEnabled()
בודקת אם אור השמש מתעדכן בכל מסגרת על סמך הערכת התאורה של איכות ה-HDR.
boolean
ביטול
pause()
משהה את שרשור העיבוד ואת הסשן של ARCore.
CompletableFuture<Void>
pauseAsync(מוציא לפועלמוציא לפועל)
שיחה ללא חסימה כדי להשהות את שרשור העיבוד ואת הסשן של ARCore.
ביטול
resume()
ממשיך את שרשור העיבוד ואת פעילות ARCore.
CompletableFuture<Void>
resumeAsync(מוציא לפועל)
קריאה ללא חסימה כדי להמשיך את שרשור העיבוד ואת הסשן של ARCore ברקע

יש לקרוא לפונקציה הזו מ-onResume().

ביטול
setCameraStreamRenderPriority(עדיפות גבוהה)
מגדירים את עדיפות העיבוד כדי לשלוט בסדר העיבוד של זרם המצלמה.
ביטול
setLightDirectionUpdateEnabled(boolean isLightDirectionUpdateEnabled)
המדיניות הזו קובעת אם הכיוון של אור השמש שנוצר מתאורה HDR סביבתית יעודכן בכל פריים.
ביטול
setLightEstimationEnabled(הפעלה בוליאנית)
הפעלה של הערכת אור על סמך פיד המצלמה.
ביטול
setupSession(סשן
הגדרת התצוגה באמצעות סשן AR.

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

בונים ציבוריים

גלוי לכול ArSceneView (הקשר הקשר)

בונה אובייקט ArSceneView ומקשר אותו להקשר Android.

כדי שהעיבוד יפעל כהלכה, יש להפעיל את setupSession(Session).

פרמטרים
הקשר ההקשר של Android שבו יש להשתמש

גלוי לכול ArSceneView (הקשר, מאפיין set

בונה אובייקט ArSceneView ומקשר אותו להקשר Android.

כדי שהעיבוד יפעל כהלכה, יש להפעיל את setupSession(Session).

פרמטרים
הקשר ההקשר של Android שבו יש להשתמש
אטרקציות מאפיין המאפיין של Android שאליו יש לשייך
ראו בנוסף

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

Public Framework getArFrame ()

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

Public int getCameraStreamRenderעדיפות ()

קבלת עדיפות העיבוד השולטת בסדר העיבוד של זרם המצלמה. העדיפות היא בין טווח 0 (שעבר עיבוד) ל-7 (עיבוד אחרון).

ערך ברירת המחדל הוא 7, שמאלצת את עיבוד הסטרימינג של המצלמה. זו האפשרות המומלצת לביצועים כי היא מונעת חריגות. עם זאת, כשמשתמשים בחומר כגוש (לדוגמה בדגימה של הפנים המשופרות), צריך לשנות את הבחירה. אחרת, האבקה תחסום את שידור המצלמה ושידור השחור יעובד.

Public PlaneRenderer getPlaneRenderer ()

פונקציה זו מחזירה את PlaneRenderer, המשמשת לשליטה בתצוגה החזותית של המטוס.

גלוי לכול סשן getSession ()

מחזירה את הסשן של ARCore שבו משתמשת התצוגה הזו.

Public בוליאני isEnvironmentalHdrLightingavailable ()

פונקציה זו מחזירה את הערך true אם מצלמת ARCore מוגדרת עם Config.LightEstimationMode.ENVIRONMENTAL_HDR. כשמצב התאורה של ה-HDR הסביבתי מופעל, אומדני התאורה שנובעים יחולו על הסצנה ב-Sformform.

החזרות
  • true אם תאורת HDR מופעלת ב-Squareform כי הערכת התאורה ב-ARCore HDR מופעלת.

Public בוליאני isLightDirectionUpdateEnabled ()

בודקת אם אור השמש מתעדכן בכל מסגרת על סמך הערכת התאורה של איכות ה-HDR.

החזרות
  • הערך true אם הכיוון של אור השמש מעודכן לכל מסגרת, אחרת false.

Public בוליאני isLightEstimationEnabled ()

החזרות
  • מחזירה את הערך true אם הערכת האור מופעלת.

Public null pause ()

משהה את שרשור העיבוד ואת הסשן של ARCore.

יש לבצע קריאה זו מ-onpause().

Public CompletableFuture<Void> pauseAsync (Executor executor)

שיחה ללא חסימה כדי להשהות את שרשור העיבוד ואת הסשן של ARCore.

יש להפעיל את האפשרות הזו מ-onpause().

אם השהיה ניתנת להשהיה מתרחשת בזמן שהשהיה או המשך אחרים מתבצעות, ההשהיה תושהה ותתבצע בסוף הפעולה הנוכחית.

פרמטרים
מוציא לפועל
החזרות
  • הסתיים שרשור אחד (CompletableFuture) בשרשור הראשי בהשהיה. העתיד יושלם באופן חריג אם לא ניתן להמשיך את קורות החיים.

Public null קורות חיים ()

ממשיך את שרשור העיבוד ואת פעילות ARCore.

יש לקרוא לפונקציה הזו מ-onResume().

זריקות
המצלמה לא זמינה אם לא ניתן לפתוח את המצלמה

Public CompletableFuture<Void> resumeAsync (Executor executor)

קריאה ללא חסימה כדי להמשיך את שרשור העיבוד ואת הסשן של ARCore ברקע

יש לקרוא לפונקציה הזו מ-onResume().

אם השיחה תופעל בזמן שמתבצעת השהיה או המשך נוספת, היא תתווסף לתור ויתבצע אחרי שהפעולה הנוכחית תסתיים.

פרמטרים
מוציא לפועל
החזרות
  • השלמת שרשור בשרשור הראשי אחרי השלמת החידוש. אם לא תהיה אפשרות להמשיך, לא תהיה לך אפשרות להשלים את התהליך בעתיד.

Public null setCameraStreamRenderעדיפות (עדיפות))

מגדירים את עדיפות העיבוד כדי לשלוט בסדר העיבוד של זרם המצלמה. העדיפות היא בין טווח 0 (שעבר עיבוד) ל-7 (עיבוד אחרון).

ערך ברירת המחדל הוא 7, שמאלצת את עיבוד הסטרימינג של המצלמה. זו האפשרות המומלצת לביצועים כי היא מונעת חריגות. עם זאת, כשמשתמשים בחומר כגוש (לדוגמה בדגימה של הפנים המשופרות), צריך לשנות את הבחירה. אחרת, האבקה תחסום את שידור המצלמה ושידור השחור יעובד.

פרמטרים
הרשמה בעדיפות

Public null setLightDirectionUpdateEnabled (boolean isLightDirectionUpdateEnabled)

המדיניות הזו קובעת אם הכיוון של אור השמש שנוצר מתאורה HDR סביבתית יעודכן בכל פריים. אם הערך הוא false, כיוון התאורה יתעדכן פעם אחת ואז לא ישתנה.

ניתן להשתמש בכך כדי להשבית עדכונים בכיוון הצללית כשהם מסיחים את הדעת או לא רצויים.

מצב ברירת המחדל הוא True, עם כיוון אור השמש מעודכן לכל מסגרת.

פרמטרים
isLightDirectionUpdateEnabled

Public null setLightEstimationEnabled (boolean activation)

הפעלה של הערכת אור על סמך פיד המצלמה. הצבע והעוצמה של האור העקיף של השמש ישפיעו על הערכים של תאורת ה-ARCore&#39. הדבר ישפיע על אובייקטים ליטרים בסצנה.

פרמטרים
הפעלה יש להגדיר את הערך True כדי להפעיל הערכה משוערת או את הערך False כדי להשתמש באומדן ברירת המחדל, כלומר עוצמת פיקסלים של 1.0 וערך תיקון הצבעים לבן (1.0, 1.0, 1.0).

Public null setupSession (סשן)

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

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

פרמטרים
סשן הסשן של ARCore לשימוש בתצוגה המפורטת הזו