אותות Acceleration, App, Compass, Connection ו- Location ב- Power Apps
חל על:
יישומי בד ציור יישומים מונחי דגמים
החזרת מידע אודות סביבת היישום, כגון מיקום המשתמש בעולם והמסך המוצג.
תיאור ותחביר
אותות הם ערכים שיכולים להשתנות בכל עת, ללא קשר לאופן שבו המשתמש עשוי לקיים אינטראקציה עם היישום. נוסחאות המבוססות על אותות מבצעים חישוב מחדש באופן אוטומטי כאשר ערכים אלה משתנים.
אותות מחזירים בדרך כלל רשומת מידע. באפשרותך להשתמש במידע זה ולאחסן אותו כרשומה, או שבאפשרותך לחלץ מאפיינים בודדים באמצעות האופרטור..
הערה
הפונקציות Acceleration ו- Compass מחזירות ערכים מדויקים בנגן מקורי כגון iOS או Android, אבל פונקציות אלה מחזירות ערכי אפס כאשר אתה יוצר או משנה יישום בדפדפן.
האצה
אות האצה מחזיר את האצת המכשיר בשלושה ממדים ביחס למסך המכשיר. האצה נמדדת ביחידות g של 9.81 מטר/שנייה2 או 32.2 רגל/שנייה2 (ההאצה שכדור הארץ נותן לעצמים על פני השטח שלו עקב כוח הכבידה).
| מאפיין | תיאור |
|---|---|
| Acceleration.X | ימין ושמאל. ימין הוא מספר חיובי. |
| Acceleration.Y | קדימה ואחורה. קדימה הוא מספר חיובי. |
| Acceleration.Z | למעלה ולמטה. למעלה הוא מספר חיובי. |
יישום
בין שאר המאפיינים, האובייקט יישום כולל אות המציין איזה מסך מוצג.
| מאפיין | תיאור |
|---|---|
| App.ActiveScreen | מסך שמוצג. החזרת אובייקט מסך, שבאפשרותך להשתמש בו כדי להפנות למאפיינים של המסך או להשוות למסך אחר כדי לקבוע איזה מסך מוצג. באפשרותך להשתמש בפונקציה Back או Navigate כדי לשנות את המסך המוצג. |
למידע נוסף: תיעוד object App.
Compass
האות מצפן מחזיר את כותרת המצפן של החלק העליון של המסך. הכותרת מבוססת על צפון מגנטי.
| מאפיין | תיאור |
|---|---|
| Compass.Heading | כותרת במעלות. מחזירה מספר 0 עד 360, ו- 0 הוא צפון. |
חיבור
האות חיבור מחזיר את המידע אודות חיבור הרשת. בחיבור לפי שימוש, ייתכן שתרצה להגביל את כמות הנתונים שאתה שולח או מקבל דרך הרשת. לחלופין, אם האפליקציה שלך מופעלת במצב לא מקוון, ייתכן שתרצה להציג מידע שונה בהתאם למצב הסנכרון הנוכחי.
| מאפיין | תיאור |
|---|---|
| Connection.Connected | החזרת ערך true או false בוליאני המציין אם המכשיר מחובר לרשת. |
| Connection.Metered | החזרת ערך true או false בוליאני המציין אם החיבור הוא לפי שימוש. |
| Connection.Sync | מחזירה ערך enum בשם ConnectionSync שמחזיק את מצב הסנכרון הנוכחי עבור אפליקציה שמופעלת במצב לא מקוון. |
להלן ערכי ה-enums הזמינים עבור Connection.Sync.
| ערך enum | תיאור |
|---|---|
| Connected | המכשיר שלך מחובר לרשת והאפליקציה שלך מוכנה לעבוד במצב לא מקוון |
| ConnectedWithWarning | המכשיר שלך מחובר עם אזהרה. |
| ConnectedPendingUpsync | חלק מהנתונים במכשיר שלך חייבים להיות מסונכרנים עם השירות. |
| ConnectedError | אירעה שגיאה בניסיון הסנכרון האחרון. |
| ConnectedRefresh | האפליקציה שלך מסנכרנת כעת נתונים עם השירות. |
| NotConnected | המכשיר שלך לא מחובר לשירות. |
| NotConnectedWithWarning | אזהרת הסנכרון האחרונה. |
| NotConnectedPendingUpsync | ישנם עדכונים במכשיר שלך שמחכים לסנכרון. |
| NotConnectedSyncError | שגיאת הסנכרון האחרונה. |
מיקום
האות מיקום מחזיר את מיקום המכשיר בהתבסס על מערכת המיקום הגלובלית (GPS) ומידע נוסף על המכשיר, כגון תקשורת אתר סלולרי וכתובת IP.
כאשר משתמש מקבל גישה למידע המיקום בפעם הראשונה, המכשיר עשוי להנחות את המשתמש לאפשר גישה למידע זה.
כאשר המיקום משתנה, יחסי תלות במיקום יחושבו מחדש באופן קבוע, מה שיצרוך את מתח סוללת המכשיר. כדי לחסוך בחיי הסוללה, ניתן להשתמש בפונקציות Enable ו- Disable כדי להפעיל ולבטל עדכוני מיקום. המיקום מבוטל אוטומטית אם המסך המוצג אינו תלוי במידע מיקום.
| מאפיין | תיאור |
|---|---|
| Location.Altitude | החזרת מספר המציין את הגובה, שנמדד במטרים, מעל פני הים. |
| Location.Latitude | החזרת מספר, מ- -90עד 90, המציין את קו הרוחב, כפי שנמדד במעלות מקו המשווה. מספר חיובי מציין מיקום שנמצא צפונית לקו המשווה. |
| Location.Longitude | החזרת מספר, מ- -180עד 180, המציין את קו האורך, כפי שנמדד במעלות מגריניץ', אנגליה. מספר חיובי מציין מיקום שנמצא מזרחית לגריניץ'. |
דוגמאות
במגרש בייסבול, מגיש משליך טלפון מסוללת המגיש אל תופס בבסיס התופס. הטלפון מונח שטוח ביחס לקרקע, החלק העליון של המסך מצביע אל התופס, והמגיש אינו מוסיף סיבובים. במיקום זה, לטלפון יש שירות של רשת סלולרית שנמדד לפי שימוש, אבל לא WiFi. המסך PlayBall מוצג. האפליקציה מופעלת במצב לא מקוון ומחוברת לשירות.
| נוסחה | תיאור | תוצאה |
|---|---|---|
| Location.Latitude | החזרת קו הרוחב של המיקום הנוכחי. השדה ממוקם בקואורדינטות המפה 47.591 N, 122.333 W. | 47.591 קו הרוחב ישתנה ברציפות כאשר הכדור יעבור בין המגיש לתופס. |
| Location.Longitude | החזרת קו האורך של המיקום הנוכחי. | 122.333 קו האורך ישתנה ברציפות כאשר הכדור יעבור בין המגיש לתופס. |
| Location | החזרת קו הרוחב וקו האורך של המיקום הנוכחי, כרשומה. | { קו רוחב: 47.591, קו אורך: 122.333 } |
| Compass.Heading | החזרת כותרת המצפן של החלק העליון של המסך. בשדה זה, בסיס התופס נמצא בערך דרום-מערבית מסוללת המגיש. | 230.25 |
| Acceleration.X | החזרת האצת המכשיר מצד לצד. המגיש משליך את הטלפון היישר לפנים ביחס לחלק העליון של המסך, כך שהמכשיר אינו מאיץ מצד לצד. | 0 |
| Acceleration.Y | החזרת האצת המכשיר מקדימה לאחורה. המגיש נותן בתחילה למכשיר האצה גדולה בעת השלכת המכשיר, שעובר מ- 0 ל- 90 מייל לשעה (132 רגל לשנייה) תוך חצי שנייה. לאחר שהמכשיר כבר באוויר, ומתעלם מחיכוך האוויר, המכשיר אינו מאיץ עוד. המכשיר מאט כאשר התופס תופס אותו, ועוצר אותו. | 8.2, כאשר המגיש משליך את המכשיר. 0, בזמן שהמכשיר באוויר. -8.2, כאשר התופס תופס את המכשיר. |
| Acceleration.Z | החזרת האצת המכשיר מלמעלה למטה. כשהמכשיר באוויר, הוא נתקל בהשפעות כוח הכבידה. | 0, לפני שהמגיש משליך את המכשיר. 1, בזמן שהמכשיר באוויר. 0, אחרי שהתופס תופס את המכשיר. |
| האצה | החזרת ההאצה כרשומה. | { X: 0, Y: 264, Z: 0 } כאשר המגיש משליך את המכשיר. |
| Connection.Connected | החזרת ערך בוליאני המציין אם המכשיר מחובר לרשת | true |
| Connection.Metered | החזרת ערך בוליאני המציין אם החיבור הוא לפי שימוש | true |
| Connection.Sync | מחזירה ערך enum המציין את מצב הסנכרון הנוכחי. | ConnectionSync.Connected |
| App.ActiveScreen = PlayBall | החזרת ערך בוליאני המציין אם PlayBall מוצג. | true |
| App.ActiveScreen.Fill | החזרת צבע הרקע עבור המסך המוצג. | Color.Green |