Share via

الدالة ReadNFC

  • مقالة

ينطبق على: تطبيقات اللوحة

قراءة علامة اتصال المجال القريب (NFC).

الوصف

استخدم وظيفة ReadNFC لقراءة علامة NFC القريبة من جهازك. عند الاستدعاء ، تعرض الشاشة تعليمات لمسح علامة NFC، ولا تعود إلا بعد مسح العلامة ضوئيًا.

عمود نوع ‏‏الوصف
Identifier نص معرف علامات NFC إن كان متوفرًا.
NDEFRecords جدول سجلات NDEF المدعومة التي تم العثور عليها على العلامة.

يحتوي سجل NDEFRecord واحد على الأعمدة التالية:

عمود نوع ‏‏الوصف
RTD نص تعريف علامة نوع السجل (RTD). فقط النص وURI مدعومان في الوقت الحالي.
TNF الرقم‬ تنسيق اسم نوع العلامة (TNF). وحدها TNF من النوع معروف جيدًا(1) مدعومة في الوقت الحالي.
نص نص الحمولة النصية لعلامة NFC إذا كان RTD هو النص أو فارغ.
URI ارتباط تشعبي حمولة URI لعلامة NFC إذا كان RTD هو URI أو فارغ.

إذا لم يكن سجل NDEF مدعومًا (على سبيل المثال، TNF ليس من النوع معروف جيدًا)، فلن يُرتجع كجزء من جدول NDEFRecords.

تحقق دائما من قيم الحمولة لـ فارغةباستخدام وظيفة IsBlank قبل استخدامها. لا يلزم مراجعة قيم RTD وTNF بنفسك حيث يجب أن تكون القيم الصحيحة لـ النص وURI للحصول على قيمة غير فارغة.

وقد يتم دعم قيم RTD وTNF الإضافية في المستقبل. وفي حالة دعم مزيد من القيم، سيتم إضافة أعمدة تحميل إضافية أيضا. يتم توفير قيم RTD وTNF الأولية لأغراض معلوماتية ولا تحتاج إلى استشارتها إذا تم فحص عمود الحمولة للتحقق من أنه فارغ. يتوفر المزيد من المعلومات حول هذه القيم واستخدامها من خلال منتدى NFC.

لا يحتاج ReadNFC إلى علامة تحتوي على سجلات NDEF لاستخدامها، ولكنك مع ذلك قد تحصل على معرف العلامة في حال كان متوفرًا.

ReadNFC يمكن استخدامها فقط في صيغ السلوك.

‏‫ملاحظة‬

  • يتم دعم ReadNFC فقط عند تشغيل التطبيق في تطبيق أجهزة محمولة أصلي، مثل تطبيقات iOS وAndroid. حتى مع مشغل مدعوم، قد لا يدعم الجهاز NFC. إذا كان الخيار إدارة الأخطاء على مستوى الصيغة قيد التشغيل في تطبيقك، فستقوم الدالة بإرجاع خطأ. بخلا ذلك، ستظهر رسالة خطأ للمستخدم وستقوم الدالة بإرجاع سجل فارغ.
  • تأكد من تمكين إعداد NFC في جهازك لاستخدام هذه الإمكانية.

بناء الجملة

ReadNFC()

الأمثلة

الصيغة ‏‏الوصف نتيجة
ReadNFC().Identifier إرجاع المعرف من علامة NFC عند وجوده. 04A1C301314003
ReadNFC().NDEFRecords إرجاع جدول سجلات NDEF تم العثور عليه في علامة NFC إن كانت من النوع والحمل المدعومين. نتيجة NDEFRecords مع سجل مقدم كمثال.

مثال خطوة بخطوة

  1. أنشئ تطبيق لوحة فارغًا باستخدام تنسيق الهاتف.

  2. أضف عنصر تحكم Button.

  3. انقر نقرًا مزدوجًا فوق عنصر تحكم الزر لتغيير نص الزر إلى علامة NFC المقروءة (أو تعديل خاصية Text).

  4. قم بتعيين خاصية OnSelect الخاص بعنصر تحكم الزر إلى هذه الصيغة التي ستضيف عنصرًا إلى مجموعتنا:

    With(ReadNFC(),
    Set(id, Coalesce(Identifier, "No ID"));
    ForAll(NDEFRecords, Collect(tagRecords, {ID: id, Value: Coalesce(Text, URI)})))

    تم إدخال الصيغة أعلاه باعتبارها خاصية OnSelect للزر.

    تقرأ هذه الصيغة علامة NFC باستخدام الدالة ReadNFC()، وتعرض معلومات النوع حول النتيجة. ثم تقوم بتجميع علامات NFC المقروءة لتعبئة مجموعة tagRecords التي سيتم استخدامها للمعرض في الخطوات التالية.

  5. أضف عنصر تحكم المعرض مع تخطيط عمودي.

  6. عند المطالبة، حدد مجموعة tagRecords‎ كمصدر بيانات لهذا المعرض. سيقوم هذا الإجراء بتعيين خاصية Items الخاصة بعنصر تحكم المعرض:

    تحديد مصدر البيانات للمعرض باعتباره tagRecords.

  7. يمكنك تغيير موضع عنصر تحكم المعرض حتى لا يتداخل مع الزر، ويمكنك تغيير نوع التخطيط إلى العنوان والعنوان الفرعي.

    تخطيط المعرض.

  8. قم بتغيير صيغة العنوان في عنصر تحكم المعرص إلى ThisItem.Value وقم بتغيير صيغة العنوان الفرعي في عنصر تحكم المعرض إلى ThisItem.ID.

    يمكنك أيضا حذف NextArrow من عنصر تحكم المعرض بما أنه غير مستخدم.

  9. حفظ التطبيق ونشره.

  10. نظرًا لتعذر استخدام الدالة ReadNFC() في Power Apps Studio أو في مستعرض الويب، افتح التطبيق على جهاز محمول.

    تلميح

    قد يستغرق ظهور التطبيق على الجهاز المحمول بضع لحظات. إذا لم تشاهد التطبيق مدرجًا، فحاول تحديث قائمة التطبيقات.

  11. حدد علامة NFC المقروءة، ثم افحص العلامة. كرر العملية لإضافة علامات متعددة إلى مجموعتك.

    تطبيق على الجهاز المحمول مع مثال قراءة علامة NFC والنتيجة داخل المعرض.