Share via


ReadNFC 函式

適用於: 畫布應用程式

讀取近距離無線通訊 (NFC) 標籤。

Description

使用 ReadNFC 函式讀取靠近您裝置的 NFC 標籤。 叫用時,畫面會顯示掃描 NFC 標籤的指示,只有在掃描標籤或逾時後才會傳回。

輸入 描述
識別碼 文字 NFC 標記識別項 (如果有的話)。
NDEFRecords 資料表 在標記上找到的支援 NDEF 記錄。

單個 NDEFRecord 包含下列各欄:

輸入 描述
RTD 文字 標籤的記錄類型定義 (RTD)。 目前只支援文字URI
TNF 數字 標籤的類型名稱格式 (TNF)。 目前只支援已知 (1) 的 TNF。
文字 文字 如果 RTD 為 文字,則為 NFC 標籤的文字裝載,否則為空白
URI 超連結 如果 RTD 為 URI,則為 NFC 標籤的 URI 裝載,否則為空白

如果不支援 NDEF 記錄 (例如,TNF 不是已知類型),則不會將它作為 NDEFRecords 表格的一部分傳回。

在使用之前,請務必使用 IsBlank 函式檢查空白的裝載值。 您不需要自己檢查 RTDTNF 值,因為它們必須是文字URI 的正確值才能具有非空白值。

未來可能會之元其他 RTDTNF 值。 如果支援更多的值,也會新增額外的裝載資料行。 原始 RTDTNF 值僅供參考,如果承載資料行確認為空白,則不需要參考。 有關這些值及其用法的詳細資訊,請造訪 NFC 論壇

ReadNFC 不需要使用包含 NDEF 記錄的標記,但是您仍然可以取得標記識別項 (如果有的話)。

ReadNFC 只能在行為公式中使用。

Note

  • 只有在原生行動裝置應用程式 (例如 iOSAndroid 應用程式) 上執行時,才支援 ReadNFC。 即使有支援的播放程式,裝置也可能不支援 NFC。 如果您的應用程式已打開公式層級的錯誤管理,則該函式將會傳回錯誤。 否則會向使用者顯示錯誤訊息,且該函式將會傳回空白記錄。
  • 請確定您的裝置已啟用 NFC 設定來使用此功能。

語法

ReadNFC()

範例

公式 描述 結果
ReadNFC().Identifier 傳回 NFC 標記識別項 (如果有的話)。 04A1C301314003
ReadNFC().NDEFRecords 如果 NDEF 記錄是受支援的類型和承載,則傳回在 NFC 標記上找到的 NDEF 記錄表格。 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 屬性輸入。

    此公式使用 ReadNFC() 函式讀取 NFC 標記,並顯示有關結果的類型資訊。 然後,它會收集讀取的 NFC 標記,以填入 tagRecords 集合,以便在接下來的步驟中用於資源庫。

  5. 新增含有垂直版面配置的資源庫控制項。

  6. 出現提示時,選取 tagRecords 集合物件做為此資源庫的資料來源。 此動作將設定 Gallery 控制項目的 Items 屬性。

    資源庫的資料來源選擇為 tagRecords。

  7. 重新置放資源庫控制項使其不會與按鈕重疊,並將版面配置類型變更為標題和副標題

    資源庫的版面配置。

  8. 將資源庫控制項中的標題公式變更為 ThisItem.Value,並將資源庫控制項中的副標題公式變更為 ThisItem.ID

    您也可以從資源庫控制項中移除 NextArrow,因為不會使用該控制項。

  9. 儲存並發佈應用程式。

  10. 因為此函式 ReadNFC()無法在 Power Apps Studio或網頁瀏覽器中使用,所以請在行動裝置上打開您的應用程式。

    小費

    該應用程式可能需要花費幾分鐘的時間才能顯示在行動裝置上。 如果您沒看到列出的應用程式,請嘗試重新整理您的應用程式清單。

  11. 選取讀取 NFC 標記並掃描標記。 重複此流程,將多個標記新增至您的集合物件。

    行動裝置上的應用程式,包含 NFC 標記讀取範例和資源庫中的結果。