NFC Helper Support Documentation

Welcome to NFC Helper Support

Thank you for choosing NFC Helper! This page is dedicated to providing you with comprehensive support and guidance to ensure a smooth experience with our app. Whether you're new to NFC technology or an experienced user, we're here to assist you.

Frequently Asked Questions (FAQs)

Q1: How do I write a URL to an NFC tag using NFC Helper?

• A1: Open NFC Helper, go to the writing page, enter the desired URL, and tap the 'Write' button. Hold your device close to the NFC tag to complete the writing process.

Q2: What should I do if my device does not recognize an NFC tag?

• A2: Ensure that your device's NFC is turned on and that the NFC tag is not damaged. Try moving your device slowly over the tag to find the optimal reading position.

Q3: How do I use custom URL schemes with NFC Helper?

• A3: NFC Helper supports custom URL schemes like nfchelper://write?url=<URL-to-write>&callback=<callback-URL>. Simply enter this format in your browser or app to open NFC Helper directly to the writing page, more information below.

Q4: Can NFC Helper work with any NFC tag?

• A4: NFC Helper is designed to work with most standard NFC tags. However, compatibility may vary depending on the tag's technology and format.

User Guide

Getting Started

• Installation: Download and install NFC Helper from the App Store. Open the app and grant the necessary permissions for NFC operations.

Writing URLs to NFC Tags

• Step-by-Step Guide:
  1. Launch NFC Helper.
  2. Navigate to the writing page.
  3. Enter the URL you wish to write.
  4. Tap 'Write' and hold your device near the NFC tag.

Using Custom URL Schemes

• Custom URL schemes allow for direct interaction with NFC Helper from other apps or browsers. For instance, nfchelper://write?url=example.com will open the app and pre-fill the URL field with "example.com", more information below.

Troubleshooting

Encounter an issue? Here are some common problems and their solutions:

• NFC Tag Not Detected: Ensure your device's NFC is enabled and try different angles or distances.
• URL Write Error: Check if the URL format is correct and ensure the NFC tag is not write-protected.

Contact Us

For further assistance, questions, or feedback, please reach out to us at [email protected]. Your feedback is invaluable and helps us improve.

Updates and Notices

Stay updated with the latest features and enhancements in NFC Helper by checking this section regularly. We continuously work to improve your experience with new functionalities and improvements.

NFC Helper URL Scheme Guide

Overview

NFC Helper's URL scheme feature allows users to interact with the app using custom URLs. This enables direct navigation to specific functionalities within the app, primarily focused on writing to NFC tags and handling callback URLs.

URL Scheme Format

The basic URL scheme format for NFC Helper is as follows:

nfchelper://<action>?<parameters>

• <action>: This specifies the action to be performed by the app.
• <parameters>: These are optional and used to pass additional information required for the action.

Available Actions

1. Writing to NFC Tag:

   • Action: write
   • Parameters: url, callback
   • Description: Opens the NFC writing page and optionally writes a specified URL to an NFC tag.
   • URL Format: nfchelper://write?url=<URL-to-write>&callback=<callback-URL>

2. Reading NFC Tag:

   • Action: read
   • Parameters: callback, post, params (Available in version 1.1)
   • Description: Opens the NFC reading page.
   • URL Format: nfchelper://read

Parameters

• url (URL): The URL you want to write to the NFC tag.
• callback (URL): A URL that the app will open after successfully writing to the NFC tag. This URL will include the tag's serial number as a query parameter.
• post (URL): The endpoint URL to which the app will send a POST request with the NFC tag data. (Available in version 1.1)
• params (true/false): To include query parameters in read callback url or not. Default is false. (Available in version 1.1)
• custom (string): Custom parameter to include in POST api or callback params (Available in version 1.1.1)

Examples

1. Open Writing Page Without Parameters:

   • URL: nfchelper://write
   • Behavior: Opens the NFC writing page in the app.

2. Write Specific URL to NFC Tag:

   • URL: nfchelper://write?url=https://example.com
   • Behavior: Opens the NFC writing page and pre-fills the input field with https://example.com.

3. Write to NFC and Open Callback URL:

   • URL: nfchelper://write?url=https://example.com&callback=https://example.com/callback
   • Behavior: Writes https://example.com to an NFC tag. Upon successful writing, the app navigates to https://example.com/callback?tagid={serialnumber}.

Usage

To use NFC Helper's URL scheme:

1. Construct the URL: Based on the action and parameters you want, construct the URL.
2. Invoke the URL: Use this URL in a web browser, within another app, or in any system that can initiate a URL scheme.
3. Interact with NFC Helper: The app will open and perform the specified action based on the URL.

Notes

• Ensure that NFC Helper is installed on your device to use this feature.
• The URL scheme is case-sensitive. Ensure to use the correct casing as described in the examples.
• The NFC functionality requires a physical device with NFC capabilities.

For further question, please send the e-mail to [email protected]