NFCStatus (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

See also

NFCStatus (Function)

In french: NFCEtat

Returns the activation status of the NFC sensor found on the device.

Versions 24 and later

This function is now available for iPhone/iPad applications.

New in version 24

This function is now available for iPhone/iPad applications.

Example

// Write a url into an NFC tag
IF NFCStatus = nfcEnabled THEN
tag is nfcTag
url is nfcData
url..Type = nfcURI
url..Content = "www.pcsoft.com"
Add(tag, url)
NFCWriteTag(tag)
IF ErrorOccurred THEN
Error("Failure writing onto the NFC tag.", ErrorInfo())
END
END

Syntax

<Result> = NFCStatus()

<Result>: Integer constant

Sensor activation status:
nfcEnabled The NFC sensor is enabled.
Scan in progress.
nfcDisabled The NFC sensor is disabled.
nfcUnavailable The device is not equipped with a NFC sensor or this one is not available.

Remarks

Special cases

Versions 24 and later
The NFC functions are only available in read-only mode.
New in version 24
The NFC functions are only available in read-only mode.
The NFC functions are only available in read-only mode.
The activation status of the NFC sensor cannot be modified by programming.
If the NFC sensor is not enabled, the user has the ability to enable it via the window for configuring the wireless communications by using the following code in a procedure in native Java code:

getCurrentActivity().startActivity(new android.content.Intent(
android.provider.Settings.ACTION_WIRELESS_SETTINGS));
NFCStatus cannot be used in the simulator or in the emulator: the function will return the nfcUnavailable constant.
NFCStatus is available for the devices running Android version 2.3.3 or later (api level 10).
A fatal error occurs if the function is used with an earlier system version.
To know the Android version on which the application is running, use SysAndroidVersion.
Versions 24 and later
NFCStatus is only available on iPhones from iPhone 8 onwards.
New in version 24
NFCStatus is only available on iPhones from iPhone 8 onwards.
NFCStatus is only available on iPhones from iPhone 8 onwards.

Required permissions

The call to this function modifies the permissions required by the application.

Required permission: NFC: Allows the applications to perform input/output operations via the NFC technology.

Versions 24 and later

AppID required

Calling this function modifies the AppIDs of the application in the Apple developer account. It is necessary to activate the "NFC Tag Reading" App ID..

New in version 24

AppID required

Calling this function modifies the AppIDs of the application in the Apple developer account. It is necessary to activate the "NFC Tag Reading" App ID..

AppID required

Calling this function modifies the AppIDs of the application in the Apple developer account. It is necessary to activate the "NFC Tag Reading" App ID..

Business / GUI classification : Business Logic

Component : wd250android.jar