tencent cloud

All product documents
Tencent Cloud Super App as a Service
NFC-NfcB
Last updated: 2024-11-21 18:48:12
NFC-NfcB
Last updated: 2024-11-21 18:48:12

.connect

The method is utilized via NfcB.connect().
Function Description: Establishes a connection with the NFC tag.
Parameters and Description: Object - object.
Attributes
Types
Default value
Required
Note
success
function
-
Not required
Callback function for successful interface invocation
fail
function
-
Not required
Callback function for unsuccessful interface invocation
complete
function
-
Not required
Callback function executed upon the completion of the interface invocation (both successful and unsuccessful invocations)
Error Code
Error Codes
Error Message
Note
13000
The device does not support NFC
-
13001
The system's NFC switch is not activated.
-
13010
An unknown error occurred.
-
13019
user is not authorized
User Authorization Denied
13011
invalid parameter
Invalid parameter
13012
parse NdefMessage failed
Failed to parse the parameter into NdefMessage.
13021
NFC discovery already started
NFC scanning has already commenced.
13018
NFC discovery has not started
Attempted to halt NFC scanning without initiating it.
13022
Tech already connected
The tag has been successfully connected.
13023
Tech has not connected
Attempted to disconnect without a tag being connected.
13013
NFC tag has not been discovered
No NFC tag was detected.
13014
invalid tech
Invalid tag technology.
13015
unavailable tech
Failed to acquire the corresponding technology from the tag.
13024
function not support
The current tag technology does not support this feature.
13017
system internal error
The related read-write operation has failed.
13016
connect fail
Connection failed

.close

The method is utilized as NfcB.close().
Function Description: Disconnects the link.
Parameters and Description: Object object
Attributes
Types
Default value
Required
Note
success
function
-
Not required
Callback function for successful interface invocation
fail
function
-
Not required
Callback function for unsuccessful interface invocation
complete
function
-
Not required
Callback function executed upon the completion of the interface invocation (both successful and unsuccessful invocations)
Error Code
Error Codes
Error Message
Note
13000
The device does not support NFC
-
13001
The system's NFC switch is not activated.
-
13010
An unknown error occurred.
-
13019
user is not authorized
User Authorization Denied
13011
invalid parameter
Invalid parameter
13012
parse NdefMessage failed
Failed to parse the parameter into NdefMessage.
13021
NFC discovery already started
NFC scanning has already commenced.
13018
NFC discovery has not started
Attempted to halt NFC scanning without initiating it.
13022
Tech already connected
The tag has been successfully connected.
13023
Tech has not connected
Attempted to disconnect without a tag being connected.
13013
NFC tag has not been discovered
No NFC tag was detected.
13014
invalid tech
Invalid tag technology.
13015
unavailable tech
Failed to acquire the corresponding technology from the tag.
13024
function not support
The current tag technology does not support this feature.
13017
system internal error
The related read-write operation has failed.
13016
connect fail
Connection failed

.setTimeout

The method is employed as NfcB.setTimeout(Object object).
Function Description: Setting the timeout duration.
Parameters and Description: Object object
Attributes
Types
Default value
Required
Note
timeout
number
-
Supported
Setting the timeout duration (ms)
success
function
-
Not required
Callback function for successful interface invocation
fail
function
-
Not required
Callback function for unsuccessful interface invocation
complete
function
-
Not required
Callback function executed upon the completion of the interface invocation (both successful and unsuccessful invocations)
Error Code
Error Codes
Error Message
Note
13000
The device does not support NFC
-
13001
The system's NFC switch is not activated.
-
13010
An unknown error occurred.
-
13019
user is not authorized
User Authorization Denied
13011
invalid parameter
Invalid parameter
13012
parse NdefMessage failed
Failed to parse the parameter into NdefMessage.
13021
NFC discovery already started
NFC scanning has already commenced.
13018
NFC discovery has not started
Attempted to halt NFC scanning without initiating it.
13022
Tech already connected
The tag has been successfully connected.
13023
Tech has not connected
Attempted to disconnect without a tag being connected.
13013
NFC tag has not been discovered
No NFC tag was detected.
13014
invalid tech
Invalid tag technology.
13015
unavailable tech
Failed to acquire the corresponding technology from the tag.
13024
function not support
The current tag technology does not support this feature.
13017
system internal error
The related read-write operation has failed.
13016
connect fail
Connection failed

.isConnected

The method is utilized as NfcB.isConnected().
Function Description: Verifies if a connection has been established.
Parameters and Description: Object - object.
Attributes
Types
Default value
Required
Note
success
function
-
Not required
Callback function for successful interface invocation
fail
function
-
Not required
Callback function for unsuccessful interface invocation
complete
function
-
Not required
Callback function executed upon the completion of the interface invocation (both successful and unsuccessful invocations)
Error Code
Error Codes
Error Message
Note
13000
The device does not support NFC
-
13001
The system's NFC switch is not activated.
-
13010
An unknown error occurred.
-
13019
user is not authorized
User Authorization Denied
13011
invalid parameter
Invalid parameter
13012
parse NdefMessage failed
Failed to parse the parameter into NdefMessage.
13021
NFC discovery already started
NFC scanning has already commenced.
13018
NFC discovery has not started
Attempted to halt NFC scanning without initiating it.
13022
Tech already connected
The tag has been successfully connected.
13023
Tech has not connected
Attempted to disconnect without a tag being connected.
13013
NFC tag has not been discovered
No NFC tag was detected.
13014
invalid tech
Invalid tag technology.
13015
unavailable tech
Failed to acquire the corresponding technology from the tag.
13024
function not support
The current tag technology does not support this feature.
13017
system internal error
The related read-write operation has failed.
13016
connect fail
Connection failed

.getMaxTransceiveLength

The method is utilized as NfcB.getMaxTransceiveLength().
Function Description: Retrieves the maximum transmission length.
Parameters and Description: Object - object.
Attributes
Types
Default value
Required
Note
success
function
-
Not required
Callback function for successful interface invocation
fail
function
-
Not required
Callback function for unsuccessful interface invocation
complete
function
-
Not required
Callback function executed upon the completion of the interface invocation (both successful and unsuccessful invocations)
object.success Callback Function Parameters: Object res.
Attributes
Types
Note
length
number
Maximum Transmission Length
Error Code
Error Codes
Error Message
Note
13000
The device does not support NFC
-
13001
The system's NFC switch is not activated.
-
13010
An unknown error occurred.
-
13019
user is not authorized
User Authorization Denied
13011
invalid parameter
Invalid parameter
13012
parse NdefMessage failed
Failed to parse the parameter into NdefMessage.
13021
NFC discovery already started
NFC scanning has already commenced.
13018
NFC discovery has not started
Attempted to halt NFC scanning without initiating it.
13022
Tech already connected
The tag has been successfully connected.
13023
Tech has not connected
Attempted to disconnect without a tag being connected.
13013
NFC tag has not been discovered
No NFC tag was detected.
13014
invalid tech
Invalid tag technology.
13015
unavailable tech
Failed to acquire the corresponding technology from the tag.
13024
function not support
The current tag technology does not support this feature.
13017
system internal error
The related read-write operation has failed.
13016
connect fail
Connection failed

.transceive

The method is employed as NfcB.transceive(Object object).
Function Description: Transmits data.
Parameters and Description: Object - object.
Attributes
Types
Default value
Required
Note
data
ArrayBuffer
-
Supported
Binary data required for transmission
success
function
-
Not required
Callback function for successful interface invocation
fail
function
-
Not required
Callback function for unsuccessful interface invocation
complete
function
-
Not required
Callback function executed upon the completion of the interface invocation (both successful and unsuccessful invocations)
object.success Callback Function Parameters: Object res.
Attributes
Types
Note
data
ArrayBuffer
-
Error Code
Error Codes
Error Message
Note
13000
The device does not support NFC
-
13001
The system's NFC switch is not activated.
-
13010
An unknown error occurred.
-
13019
user is not authorized
User Authorization Denied
13011
invalid parameter
Invalid parameter
13012
parse NdefMessage failed
Failed to parse the parameter into NdefMessage.
13021
NFC discovery already started
NFC scanning has already commenced.
13018
NFC discovery has not started
Attempted to halt NFC scanning without initiating it.
13022
Tech already connected
The tag has been successfully connected.
13023
Tech has not connected
Attempted to disconnect without a tag being connected.
13013
NFC tag has not been discovered
No NFC tag was detected.
13014
invalid tech
Invalid tag technology.
13015
unavailable tech
Failed to acquire the corresponding technology from the tag.
13024
function not support
The current tag technology does not support this feature.
13017
system internal error
The related read-write operation has failed.
13016
connect fail
Connection failed

Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback

Contact Us

Contact our sales team or business advisors to help your business.

Technical Support

Open a ticket if you're looking for further assistance. Our Ticket is 7x24 available.

7x24 Phone Support
Hong Kong, China
+852 800 906 020 (Toll Free)
United States
+1 844 606 0804 (Toll Free)
United Kingdom
+44 808 196 4551 (Toll Free)
Canada
+1 888 605 7930 (Toll Free)
Australia
+61 1300 986 386 (Toll Free)
EdgeOne hotline
+852 300 80699
More local hotlines coming soon