nfc

Property	Type	Description
`keepSessionAlive?`	`boolean`	-
`message?`	`string`	Message displayed in the UI. iOS only.
`successMessage?`	`string`	Message displayed in the UI when the message has been read. iOS only.

Tag

Properties

Property	Type	Defined in
`id`	`number`[]
`kind`	`string`[]
`records`	`TagRecord`[]

TagRecord

Properties

Property	Type	Defined in
`id`	`number`[]
`kind`	`number`[]
`payload`	`number`[]
`tnf`	`NFCTypeNameFormat`

UriFilter

Properties

Property	Type	Defined in
`host?`	`string`
`pathPrefix?`	`string`
`scheme?`	`string`

WriteOptions

Properties

Property	Type	Description
`kind?`	`ScanKind`	-
`message?`	`string`	Message displayed in the UI when reading the tag. iOS only.
`successfulReadMessage?`	`string`	Message displayed in the UI when the tag has been read. iOS only.
`successMessage?`	`string`	Message displayed in the UI when the message has been written. iOS only.

Type Aliases

ScanKind

type ScanKind: object | object;

Variables

RTD_TEXT

const RTD_TEXT: number[];

RTD_URI

const RTD_URI: number[];

Functions

isAvailable()

function isAvailable(): Promise<boolean>

Returns

Promise<boolean>

record()

function record(
   format,
   kind,
   id,
   payload): NFCRecord

Parameters

Parameter	Type
`format`	`NFCTypeNameFormat`
`kind`	`string` \| `number`[]
`id`	`string` \| `number`[]
`payload`	`string` \| `number`[]

Returns

NFCRecord

scan()

function scan(kind, options?): Promise<Tag>

Scans an NFC tag.

import { scan } from "@crabnebula/taurify-api/nfc";
await scan({ type: "tag" });

See https://developer.android.com/develop/connectivity/nfc/nfc#ndef for more information.

Parameters

Parameter	Type	Description
`kind`	`ScanKind`
`options`?	`ScanOptions`

Returns

Promise<Tag>

textRecord()

function textRecord(
   text,
   id?,
   language?): NFCRecord

Parameters

Parameter	Type	Default value
`text`	`string`	`undefined`
`id`?	`string` \| `number`[]	`undefined`
`language`?	`string`	`'en'`

Returns

NFCRecord

uriRecord()

function uriRecord(uri, id?): NFCRecord

Parameters

Parameter	Type
`uri`	`string`
`id`?	`string` \| `number`[]

Returns

NFCRecord

write()

function write(records, options?): Promise<void>

Write to an NFC tag.

import { uriRecord, write } from "@crabnebula/taurify-api/nfc";
await write([uriRecord("https://tauri.app")], { kind: { type: "ndef" } });

If you did not previously call scan with ScanOptions.keepSessionAlive set to true, it will first scan the tag then write to it.

Parameters

Parameter	Type	Description
`records`	`NFCRecord`[]
`options`?	`WriteOptions`

Returns

Promise<void>