Share via


ReadNFC işlevi

Şunlar için geçerlidir: Tuval uygulamaları

Yakın Alan İletişimi (NFC) etiketini okur.

Description

ReadNFC işlevini, cihazınıza yakın bir NFC etiketini okumak için kullanın. Bu işlev çağrıldığında, NFC etiketini tarama yönergeleri ekranda görüntülenir ve yalnızca etiket tarandıktan veya süresi dolduktan sonra döndürür.

Sütun Türü Tanım
Tanımlayıcı Metin Varsa NFC etiketleri tanımlayıcısı.
NDEFRecords Table Etikette, desteklenen NDEF kayıtları bulundu.

Tek bir NDEFRecord, aşağıdaki sütunları içerir:

Sütun Türü Tanım
RTD Metin Etiketin Kayıt Türü Tanımı (RTD). Şu anda yalnızca Metin ve URI desteklenmektedir.
TNF Sayı Etiketin Tür Adı Biçimi (TNF). Şu anda yalnızca İyi Bilinen(1) TNF'ler desteklenmektedir.
Metin Metin RTD değeri METİN olduğunda NFC etiketinin metin yükü, aksi halde boş.
URI Köprü RTD değeri URI olduğunda NFC etiketinin URI yükü, aksi halde boş.

NDEF kaydı desteklenmiyorsa (örneğin, TNF'nin türü İyi Bilinen değilse) NDEFRecords tablosunu parçası olarak döndürülmez.

Kullanmadan önce, IsBlank işlevini kullanarak boş için iş yükü değerlerini her zaman denetleyin. RTD ve TNF değerlerini kendiniz kontrol etmek zorunda değilsiniz çünkü Metin ve URI değerlerinin boş dışında bir değer olması için bunların doğru değerler olması gerekir.

Gelecekte başka RTD ve TNF değerleri de desteklenebilir. Daha fazla değer desteklenirse ek yük sütunları da eklenecektir. Ham RTD ve TNF değerleri bilgi amaçlı olarak sağlanmıştır ve yük sütunu boş olarak işaretlenmişse incelenmesi gerekmez. Bu değerler ve kullanımları hakkında daha fazla bilgiye NFC Forumu üzerinden ulaşabilirsiniz.

ReadNFC için NDEF kayıtlarını içeren bir etiketin kullanılması gerekmez ancak varsa yine de etiket tanımlayıcısını alabilirsiniz.

ReadNFC yalnızca davranış formüllerinde kullanılabilir.

Not

  • ReadNFC yalnızca uygulama iOS ve Android uygulamaları gibi yerel bir mobil uygulamada çalıştırılırken desteklenir. Desteklenen bir oynatıcıyla bile cihaz, NFC'yi desteklemeyebilir. Uygulamanızda Formül düzeyinde hata yönetimi açıksa işlev bir hata döndürür. Aksi takdirde, kullanıcıya bir hata iletisi gösterilir ve işlev boş bir kayıt döndürür.
  • Bu özelliği kullanmak için cihazınızda NFC ayarının etkinleştirildiğinden emin olun.

Sözdizimi

ReadNFC()

Örnekler

Formül Tanım Sonuç
ReadNFC().Identifier Varsa NFC etiketinin tanımlayıcısını döndürür. 04A1C301314003
ReadNFC().NDEFRecords Desteklenen bir tür ve yükse NFC etiketinde bulunan NDEF kayıtlarının tablosunu döndürür. Örnek bir kaydın olduğu NDEFRecords sonucu.

Adım adım örnek

  1. Telefon biçimiyle boş bir tuval uygulaması oluşturun.

  2. Button denetimi ekleyin.

  3. Düğme metnini Read NFC Etiketi olarak değiştirmek için button denetimine çift tıklayın (veya Text özelliğini değiştirin).

  4. Button denetiminin OnSelect özelliğini, koleksiyonumuza bir öğe ekleyecek olan bu formüle ayarlayın:

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

    Düğmenin OnSelect özelliği olarak girilen yukarıdaki formül.

    Bu formül, ReadNFC() işlevini kullanarak bir NFC etiketi okur ve sonuç hakkında tür bilgilerini görüntüler. Ardından sonraki adımlarda galeri için kullanılacak tagRecords koleksiyonunu doldurmak üzere read NFC etiketlerini toplar.

  5. Dikey düzen bulunan bir Gallery denetimi ekleyin.

  6. İstendiğinde, bu galeri için veri kaynağı olarak tagRecords koleksiyonunu seçin. Bu eylem, Gallery denetiminin Items özelliğini ayarlayacaktır.

    tagRecords olarak seçilen galeri için veri kaynağı.

  7. Düğmeyle çakışmayacak şekilde gallery denetimini yeniden konumlandırın ve düzen türünü Başlık ve alt başlık olarak değiştirin.

    Galerinin düzeni.

  8. Gallery denetimindeki Title formülünü ThisItem.Value olarak ve gallery denetimindeki Subtitle formülünü ThisItem.ID olarak değiştirin.

    Ayrıca, kullanılmadığından gallery denetimindeki NextArrow öğesini silebilirsiniz.

  9. Uygulamayı kaydedin ve yayımlayın.

  10. ReadNFC() işlevi Power Apps Studio'da veya web tarayıcısında kullanılamadığından uygulamanızı mobil bir cihazda açın.

    Bahşiş

    Uygulamanın mobil cihazınızda görünmesi biraz zaman alabilir. Listelenen uygulamayı görmezseniz uygulama listenizi yenilemeyi deneyin.

  11. Read NFC Etiketi'ni seçip bir etiket tarayın. Koleksiyonunuza birden çok etiket eklemek için işlemi yineleyin.

    NFC Etiketi okuma örneği ve galeri içindeki sonuç ile mobil cihazda uygulama.