إشارات 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 لتغيير الشاشة التي تظهر. |
مزيد من المعلومات، وثائق كائن App .
Compass
تُرجع إشارة البوصلة عنوان البوصلة الموجود أعلى الشاشة. يعتمد العنوان على الشمال المغناطيسي.
| الخاصية | الوصف |
|---|---|
| Compass.Heading | العنوان بالدرجات. تُرجع رقم من 0 إلى 360 و 0 هو الشمال. |
الاتصال
تُرجع إشارة الاتصال المعلومات المتعلقة باتصال الشبكة. عندما تكون على اتصال محدد، قد ترغب في تحديد مقدار البيانات التي ترسلها أو تتلقاها عبر الشبكة. أو، إذا تم تمكين تطبيقك للعمل دون اتصال، فقد ترغب في عرض معلومات مختلفة بناء على حالة المزامنة الحالية.
| الخاصية | الوصف |
|---|---|
| Connection.Connected | تُرجع قيمة منطقية صواب أو خطأ تشير إلى ما إذا كان الجهاز متصلاً بشبكة. |
| Connection.Metered | تُرجع قيمة منطقية صواب أو خطأ تشير إلى ما إذا كان الاتصال محسوبًا. |
| Connection.Sync | إرجاع تعداد باسم ConnectionSync يحمل حالة المزامنة الحالية لتطبيق تم تمكينه للعمل دون اتصال. |
فيما يلي قيم التعداد المتوفرة للخاصية Connection.Sync.
| قيمة التعداد | الوصف |
|---|---|
| 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 شمالاً، 122.333 غربًا. | 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 | إرجاع قيمة تعداد تشير إلى حالة المزامنة الحالية. | ConnectionSync.Connected |
| App.ActiveScreen = PlayBall | تُرجع قيمة منطقية تشير إلى ما إذا كان PlayBall معروضًا. | true |
| App.ActiveScreen.Fill | يُعيد لون الخلفية للشاشة المعروضة. | Color.Green |