nfc_register_field_events()

Register for field events.

Synopsis:

#include <nfc/nfc.h>
 
NFC_API nfc_result_t nfc_register_field_events(void)

Since:

BlackBerry 10.0.0

Arguments:

Library:

libnfc (For the qcc command, use the -l nfc option to link against this library)

Description:

This function registers for field events. These events are generated when external fields are detected by the device, which could indicate the proximity of readers or other NFC enabled devices. However, be aware that these events may be unreliable because:
  • field detection is stopped when NFC is disabled due to either the backlight being turned off or the device being locked
  • field detection is temporarily interrupted due to NFC actions like establishing card connections, or whenever this device starts driving the field
  • depending on its polling rate, the external field may not be detected as stable Due to the unreliable nature of the field detection, the field events serve only as a rough indicator.
Valid events that can be received after registering for field events are:

Returns:

NFC_RESULT_SUCCESS, or one of the following:

Last modified: 2014-05-14



Got questions about leaving a comment? Get answers from our Disqus FAQ.

comments powered by Disqus