Dasar-dasar NFC

Dokumen ini menjelaskan tugas-tugas NFC dasar yang Anda jalankan di Android. Panduan ini menjelaskan cara mengirim dan menerima data NFC dalam bentuk pesan NDEF dan menjelaskan API framework Android yang mendukung fitur ini. Untuk topik lanjutan, termasuk pembahasan tentang penggunaan data non-NDEF, lihat NFC Lanjutan.

Pembacaan data NDEF dari tag NFC ditangani dengan sistem pengiriman tag, yang menganalisis tag NFC yang ditemukan, mengategorikan data dengan tepat, dan memulai aplikasi yang tertarik dengan data yang dikategorikan. Aplikasi yang ingin menangani tag NFC yang dipindai dapat mendeklarasikan filter intent dan meminta untuk menangani data.

Sistem pengiriman tag

Perangkat yang didukung Android biasanya mencari tag NFC saat layar tidak terkunci, kecuali jika NFC dinonaktifkan di menu Setelan perangkat. Saat perangkat Android menemukan tag NFC, perilaku yang Anda inginkan adalah memiliki aktivitas yang paling sesuai untuk menangani intent tanpa menanyakan aplikasi yang akan digunakan kepada pengguna. Karena perangkat memindai tag NFC dalam jarak yang sangat dekat, kemungkinan besar membuat pengguna memilih aktivitas secara manual akan memaksa mereka menjauhkan perangkat dari tag dan memutuskan koneksi. Anda harus mengembangkan aktivitas untuk hanya menangani tag NFC yang penting bagi aktivitas Anda untuk mencegah Pemilih Aktivitas muncul.

Untuk membantu Anda mencapai tujuan ini, Android menyediakan sistem pengiriman tag khusus yang menganalisis tag NFC yang dipindai, mengurainya, dan mencoba menemukan aplikasi yang tertarik dengan data yang dipindai. Hal ini dilakukan dengan:

  1. Mengurai tag NFC dan mencari tahu jenis MIME atau URI yang mengidentifikasi payload data dalam tag.
  2. Menggabungkan jenis MIME atau URI dan payload dalam satu intent. Dua langkah pertama ini dijelaskan dalam Cara tag NFC dipetakan ke jenis MIME dan URI.
  3. Memulai aktivitas berdasarkan intent. Hal ini dijelaskan dalam Cara Tag NFC Dikirim ke Aplikasi.

Cara tag NFC dipetakan ke jenis MIME dan URI

Sebelum mulai menulis aplikasi NFC, Anda harus memahami berbagai jenis tag NFC, cara sistem pengiriman tag mengurai tag NFC, dan pekerjaan khusus yang dilakukan sistem pengiriman tag saat mendeteksi pesan NDEF. Tag NFC hadir dalam berbagai teknologi dan juga dapat memiliki data yang ditulis ke dalamnya dengan berbagai cara. Android memiliki dukungan terbanyak untuk standar NDEF, yang ditentukan oleh Forum NFC.

Data NDEF dienkapsulasi di dalam pesan (NdefMessage) yang berisi satu atau beberapa data (NdefRecord). Setiap data NDEF harus dibentuk dengan baik sesuai dengan spesifikasi jenis data yang ingin Anda buat. Android juga mendukung jenis tag lain yang tidak berisi data NDEF, yang dapat Anda gunakan dengan menggunakan class dalam paket android.nfc.tech. Untuk mempelajari teknologi ini lebih lanjut, lihat topik NFC Lanjutan. Bekerja dengan jenis tag lain ini melibatkan penulisan stack protokol Anda sendiri untuk berkomunikasi dengan tag, jadi sebaiknya gunakan NDEF jika memungkinkan untuk kemudahan pengembangan dan dukungan maksimum untuk perangkat yang didukung Android.

Catatan: Untuk mendownload spesifikasi NDEF lengkap, buka situs Spesifikasi & Dokumen Aplikasi NFC Forum dan lihat Membuat jenis umum data NDEF untuk contoh cara membuat data NDEF.

Setelah Anda memiliki latar belakang tentang tag NFC, bagian berikut menjelaskan secara lebih mendetail cara Android menangani tag berformat NDEF. Saat perangkat Android memindai tag NFC yang berisi data berformat NDEF, perangkat akan mengurai pesan dan mencoba mencari tahu jenis MIME data atau URI yang mengidentifikasi. Untuk melakukannya, sistem akan membaca NdefRecord pertama di dalam NdefMessage untuk menentukan cara menafsirkan seluruh pesan NDEF (pesan NDEF dapat memiliki beberapa data NDEF). Dalam pesan NDEF yang terbentuk dengan baik, NdefRecord pertama berisi kolom berikut:

TNF 3-bit (Format Nama Jenis)
Menunjukkan cara menafsirkan kolom jenis panjang variabel. Nilai yang valid dijelaskan dalam Tabel 1.
Jenis panjang variabel
Menjelaskan jenis data. Jika menggunakan TNF_WELL_KNOWN, gunakan kolom ini untuk menentukan Record Type Definition (RTD). Nilai RTD yang valid dijelaskan dalam Tabel 2.
ID panjang variabel
ID unik untuk data. Kolom ini tidak sering digunakan, tetapi jika Anda perlu mengidentifikasi tag secara unik, Anda dapat membuat ID untuk tag tersebut.
Payload panjang variabel
Payload data sebenarnya yang ingin Anda baca atau tulis. Pesan NDEF dapat berisi beberapa data NDEF, jadi jangan berasumsi bahwa payload lengkap ada dalam data NDEF pertama dari pesan NDEF.

Sistem pengiriman tag menggunakan kolom TNF dan jenis untuk mencoba memetakan jenis MIME atau URI ke pesan NDEF. Jika berhasil, sistem akan mengumpulkan informasi tersebut dalam intent ACTION_NDEF_DISCOVERED bersama dengan payload sebenarnya. Namun, ada kasus saat sistem pengiriman tag tidak dapat menentukan jenis data berdasarkan data NDEF pertama. Hal ini terjadi jika data NDEF tidak dapat dipetakan ke jenis MIME atau URI, atau jika tag NFC tidak berisi data NDEF sejak awal. Dalam kasus semacam ini, objek Tag yang memiliki informasi tentang teknologi tag dan payload akan dienkapsulasi di dalam intent ACTION_TECH_DISCOVERED.

Tabel 1 menjelaskan cara sistem pengiriman tag memetakan TNF dan kolom jenis ke jenis MIME atau URI. Tabel ini juga menjelaskan TNF yang tidak dapat dipetakan ke jenis MIME atau URI. Dalam kasus ini, sistem pengiriman tag akan beralih kembali ke ACTION_TECH_DISCOVERED.

Misalnya, jika sistem pengiriman tag menemukan data jenis TNF_ABSOLUTE_URI, sistem akan memetakan kolom jenis panjang variabel data tersebut ke dalam URI. Sistem pengiriman tag mengenkapsulasi URI tersebut dalam kolom data intent ACTION_NDEF_DISCOVERED bersama dengan informasi lain tentang tag, seperti payload. Di sisi lain, jika menemukan data jenis TNF_UNKNOWN, intent yang merangkum teknologi tag akan dibuat.

Tabel 1. TNF yang didukung dan pemetaannya

Format Nama Jenis (TNF) Pemetaan
TNF_ABSOLUTE_URI URI berdasarkan kolom jenis.
TNF_EMPTY Melakukan fallback ke ACTION_TECH_DISCOVERED.
TNF_EXTERNAL_TYPE URI berdasarkan URN dalam kolom jenis. URN dienkode ke dalam kolom jenis NDEF dalam bentuk yang dipersingkat: <domain_name>:<service_name>. Android memetakan ini ke URI dalam bentuk: vnd.android.nfc://ext/<domain_name>:<service_name>.
TNF_MIME_MEDIA Jenis MIME berdasarkan kolom jenis.
TNF_UNCHANGED Tidak valid di data pertama, sehingga kembali ke ACTION_TECH_DISCOVERED.
TNF_UNKNOWN Melakukan fallback ke ACTION_TECH_DISCOVERED.
TNF_WELL_KNOWN Jenis MIME atau URI bergantung pada Record Type Definition (RTD), yang Anda tetapkan di kolom jenis. Lihat Tabel 2 untuk mengetahui informasi selengkapnya tentang RTD yang tersedia dan pemetaannya.

Tabel 2. RTD yang didukung untuk TNF_WELL_KNOWN dan pemetaannya

Record Type Definition (RTD) Pemetaan
RTD_ALTERNATIVE_CARRIER Melakukan fallback ke ACTION_TECH_DISCOVERED.
RTD_HANDOVER_CARRIER Melakukan fallback ke ACTION_TECH_DISCOVERED.
RTD_HANDOVER_REQUEST Melakukan fallback ke ACTION_TECH_DISCOVERED.
RTD_HANDOVER_SELECT Melakukan fallback ke ACTION_TECH_DISCOVERED.
RTD_SMART_POSTER URI berdasarkan penguraian payload.
RTD_TEXT Jenis MIME text/plain.
RTD_URI URI berdasarkan payload.

Cara pengiriman tag NFC ke aplikasi

Setelah sistem pengiriman tag selesai membuat intent yang mengenkapsulasi tag NFC dan informasi identitasnya, sistem akan mengirimkan intent tersebut ke aplikasi yang tertarik dan memfilter intent tersebut. Jika lebih dari satu aplikasi dapat menangani intent, Pemilih Aktivitas akan ditampilkan sehingga pengguna dapat memilih Aktivitas. Sistem pengiriman tag menentukan tiga intent, yang tercantum dalam urutan prioritas tertinggi hingga terendah:

  1. ACTION_NDEF_DISCOVERED: Intent ini digunakan untuk memulai Aktivitas saat tag yang berisi payload NDEF dipindai dan merupakan jenis yang dikenali. Ini adalah intent prioritas tertinggi, dan sistem pengiriman tag mencoba memulai Aktivitas dengan intent ini sebelum intent lainnya, jika memungkinkan.

    Catatan: Mulai Android 16, pemindaian tag NFC yang menyimpan link web (yaitu, skema URI adalah "http://" atau "https://") akan memicu intent ACTION_VIEW, bukan intent ACTION_NDEF_DISCOVERED. Mulai Android 17, pemindaian tag tersebut akan menampilkan notifikasi "buka link", yang memerlukan interaksi pengguna secara eksplisit untuk memicu intent ACTION_VIEW.

  2. ACTION_TECH_DISCOVERED: Jika tidak ada aktivitas yang mendaftar untuk menangani intent ACTION_NDEF_DISCOVERED, sistem pengiriman tag akan mencoba memulai aplikasi dengan intent ini. Intent ini juga langsung dimulai (tanpa memulai ACTION_NDEF_DISCOVERED terlebih dahulu) jika tag yang dipindai berisi data NDEF yang tidak dapat dipetakan ke jenis MIME atau URI, atau jika tag tidak berisi data NDEF, tetapi merupakan teknologi tag yang dikenal.
  3. ACTION_TAG_DISCOVERED: Intent ini dimulai jika tidak ada aktivitas yang menangani intent ACTION_NDEF_DISCOVERED atau ACTION_TECH_DISCOVERED.

Cara kerja sistem pengiriman tag yang mendasar adalah sebagai berikut:

  1. Coba mulai Aktivitas dengan intent yang dibuat oleh sistem pengiriman tag saat mengurai tag NFC (ACTION_NDEF_DISCOVERED atau ACTION_TECH_DISCOVERED).
  2. Jika tidak ada aktivitas yang memfilter intent tersebut, coba mulai Aktivitas dengan intent prioritas terendah berikutnya (ACTION_TECH_DISCOVERED atau ACTION_TAG_DISCOVERED) hingga aplikasi memfilter intent atau hingga sistem pengiriman tag mencoba semua intent yang memungkinkan.
  3. Jika tidak ada aplikasi yang memfilter intent apa pun, jangan lakukan apa pun.
Gambar 1. Sistem Pengiriman Tag

Jika memungkinkan, gunakan pesan NDEF dan intent ACTION_NDEF_DISCOVERED, karena intent ini adalah yang paling spesifik dari ketiganya. Intent ini memungkinkan Anda memulai aplikasi pada waktu yang lebih tepat daripada dua intent lainnya, sehingga memberikan pengalaman yang lebih baik kepada pengguna.

Meminta akses NFC dalam manifes Android

Sebelum Anda dapat mengakses hardware NFC perangkat dan menangani intent NFC dengan benar, deklarasikan item ini dalam file AndroidManifest.xml:

  • Elemen <uses-permission> NFC untuk mengakses hardware NFC:
    <uses-permission android:name="android.permission.NFC" />
  • Mulai Android 17 (level API 37), agar aktivitas dapat dikirimi intent NFC, jika aplikasi menargetkan SDK > Build.VERSION_CODES.BAKLAVA, aplikasi harus dilindungi oleh izin android.permission.DISPATCH_NFC_MESSAGE. Hal ini memastikan bahwa hanya layanan sistem NFC yang dapat mengirimkan intent ke aktivitas Anda. Selain itu, sistem tidak akan mengirimkan intent NFC ke aplikasi yang dalam status dihentikan (misalnya, jika aplikasi belum pernah diluncurkan oleh pengguna atau telah dihentikan paksa).
    <activity
        android:name=".MyActivity"
        android:exported="true"
        android:permission="android.permission.DISPATCH_NFC_MESSAGE">
        ...
    </activity>
  • Versi SDK minimum yang dapat didukung oleh aplikasi Anda. API level 9 hanya mendukung pengiriman tag terbatas menggunakan ACTION_TAG_DISCOVERED, dan hanya memberikan akses ke pesan NDEF menggunakan tambahan EXTRA_NDEF_MESSAGES. Properti tag atau operasi I/O lainnya tidak dapat diakses. API level 10 mencakup dukungan pembaca/penulis yang komprehensif serta push NDEF latar depan, dan API level 14 menyediakan metode praktis tambahan untuk membuat data NDEF.
    <uses-sdk android:minSdkVersion="10"/>
  • Elemen uses-feature agar aplikasi Anda muncul di Google Play hanya untuk perangkat yang memiliki hardware NFC:
    <uses-feature android:name="android.hardware.nfc" android:required="true" />

    Jika aplikasi Anda menggunakan fungsi NFC, tetapi fungsi tersebut tidak penting untuk aplikasi, Anda dapat menghilangkan elemen uses-feature dan memeriksa ketersediaan NFC pada saat runtime dengan memeriksa apakah getDefaultAdapter() adalah null.

Memfilter intent NFC

Untuk memulai aplikasi saat tag NFC yang ingin Anda tangani dipindai, aplikasi Anda dapat memfilter satu, dua, atau ketiga intent NFC dalam manifes Android. Namun, Anda biasanya ingin memfilter intent ACTION_NDEF_DISCOVERED untuk kontrol terbanyak saat aplikasi Anda dimulai. Intent ACTION_TECH_DISCOVERED adalah penggantian untuk ACTION_NDEF_DISCOVERED jika tidak ada aplikasi yang memfilter ACTION_NDEF_DISCOVERED atau jika payload bukan NDEF. Pemfilteran untuk ACTION_TAG_DISCOVERED biasanya merupakan kategori yang terlalu umum untuk difilter. Banyak aplikasi akan memfilter ACTION_NDEF_DISCOVERED atau ACTION_TECH_DISCOVERED sebelum ACTION_TAG_DISCOVERED, sehingga aplikasi Anda memiliki kemungkinan kecil untuk dimulai. ACTION_TAG_DISCOVERED hanya tersedia sebagai upaya terakhir bagi aplikasi untuk memfilter jika tidak ada aplikasi lain yang diinstal untuk menangani intent ACTION_NDEF_DISCOVERED atau ACTION_TECH_DISCOVERED.

Karena deployment tag NFC bervariasi dan sering kali tidak berada di bawah kendali Anda, hal ini tidak selalu memungkinkan, sehingga Anda dapat beralih ke dua intent lainnya jika diperlukan. Jika Anda memiliki kontrol atas jenis tag dan data yang ditulis, sebaiknya gunakan NDEF untuk memformat tag Anda. Bagian berikut menjelaskan cara memfilter setiap jenis intent.

ACTION_NDEF_DISCOVERED

Untuk memfilter intent ACTION_NDEF_DISCOVERED, deklarasikan filter intent beserta jenis data yang ingin Anda filter. Contoh berikut memfilter intent ACTION_NDEF_DISCOVERED dengan jenis MIME text/plain:

<activity
    android:name=".MyActivity"
    android:exported="true"
    android:permission="android.permission.DISPATCH_NFC_MESSAGE">
    <intent-filter>
        <action android:name="android.nfc.action.NDEF_DISCOVERED"/>
        <category android:name="android.intent.category.DEFAULT"/>
        <data android:mimeType="text/plain" />
    </intent-filter>
</activity>

Contoh berikut memfilter URI dalam bentuk https://developer.android.com/index.html.

<activity
    android:name=".MyActivity"
    android:exported="true"
    android:permission="android.permission.DISPATCH_NFC_MESSAGE">
    <intent-filter>
        <action android:name="android.nfc.action.NDEF_DISCOVERED"/>
        <category android:name="android.intent.category.DEFAULT"/>
        <data android:scheme="https"
                  android:host="developer.android.com"
                  android:pathPrefix="/index.html" />
    </intent-filter>
</activity>

ACTION_TECH_DISCOVERED

Jika aktivitas Anda memfilter intent ACTION_TECH_DISCOVERED, Anda harus membuat file resource XML yang menentukan teknologi yang didukung aktivitas Anda dalam kumpulan tech-list. Aktivitas Anda dianggap cocok jika set tech-list adalah subset teknologi yang didukung oleh tag, yang dapat Anda peroleh dengan memanggil getTechList().

Misalnya, jika tag yang dipindai mendukung MifareClassic, NdefFormatable, dan NfcA, set tech-list Anda harus menentukan ketiga, dua, atau salah satu teknologi (dan tidak ada yang lain) agar aktivitas Anda cocok.

Contoh berikut menentukan semua teknologi. Anda harus menghapus teknologi yang tidak didukung oleh tag NFC Anda. Simpan file ini (Anda dapat menamainya sesuai keinginan) di folder <project-root>/res/xml.

<resources xmlns:xliff="urn:oasis:names:tc:xliff:document:1.2">
    <tech-list>
        <tech>android.nfc.tech.IsoDep</tech>
        <tech>android.nfc.tech.NfcA</tech>
        <tech>android.nfc.tech.NfcB</tech>
        <tech>android.nfc.tech.NfcF</tech>
        <tech>android.nfc.tech.NfcV</tech>
        <tech>android.nfc.tech.Ndef</tech>
        <tech>android.nfc.tech.NdefFormatable</tech>
        <tech>android.nfc.tech.MifareClassic</tech>
        <tech>android.nfc.tech.MifareUltralight</tech>
    </tech-list>
</resources>

Anda juga dapat menentukan beberapa kumpulan tech-list. Setiap kumpulan tech-list dipertimbangkan secara independen, dan aktivitas Anda dianggap cocok jika satu kumpulan tech-list adalah subset dari teknologi yang ditampilkan oleh getTechList(). Hal ini memberikan semantik AND dan OR untuk teknologi pencocokan. Contoh berikut mencocokkan tag yang dapat mendukung teknologi NfcA dan Ndef atau dapat mendukung teknologi NfcB dan Ndef:

<resources xmlns:xliff="urn:oasis:names:tc:xliff:document:1.2">
    <tech-list>
        <tech>android.nfc.tech.NfcA</tech>
        <tech>android.nfc.tech.Ndef</tech>
    </tech-list>
    <tech-list>
        <tech>android.nfc.tech.NfcB</tech>
        <tech>android.nfc.tech.Ndef</tech>
    </tech-list>
</resources>

Dalam file AndroidManifest.xml, tentukan file resource yang baru saja Anda buat dalam elemen <meta-data> di dalam elemen <activity> seperti dalam contoh berikut:

<activity
    android:name=".MyActivity"
    android:exported="true"
    android:permission="android.permission.DISPATCH_NFC_MESSAGE">
    <intent-filter>
        <action android:name="android.nfc.action.TECH_DISCOVERED"/>
    </intent-filter>

    <meta-data android:name="android.nfc.action.TECH_DISCOVERED"
        android:resource="@xml/nfc_tech_filter" />
</activity>

Untuk mengetahui informasi selengkapnya tentang cara menggunakan teknologi tag dan intent ACTION_TECH_DISCOVERED, lihat Menggunakan Teknologi Tag yang Didukung dalam dokumen NFC Lanjutan.

ACTION_TAG_DISCOVERED

Catatan: ACTION_TAG_DISCOVERED tidak digunakan lagi mulai Android 17 (level API 37). Sebagai gantinya, gunakan ACTION_NDEF_DISCOVERED atau ACTION_TECH_DISCOVERED.

Untuk memfilter ACTION_TAG_DISCOVERED, gunakan filter intent berikut:

<activity
    android:name=".MyActivity"
    android:exported="true"
    android:permission="android.permission.DISPATCH_NFC_MESSAGE">
    <intent-filter>
        <action android:name="android.nfc.action.TAG_DISCOVERED"/>
    </intent-filter>
</activity>

ACTION_VIEW

Mulai Android 16, pemindaian tag NFC yang menyimpan link web (yaitu, skema URI adalah "http://" atau "https://") akan memicu intent ACTION_VIEW, bukan intent ACTION_NDEF_DISCOVERED. Mulai Android 17, pemindaian tag tersebut akan menampilkan notifikasi "buka link", yang memerlukan interaksi pengguna secara eksplisit untuk memicu intent ACTION_VIEW. Untuk memfilter ACTION_VIEW, lihat this. Gunakan Android app links untuk membuka aplikasi Anda untuk URL tersebut.

Mendapatkan informasi dari intent

Jika aktivitas dimulai karena intent NFC, Anda dapat memperoleh informasi tentang tag NFC yang dipindai dari intent tersebut. Intent dapat berisi tambahan berikut bergantung pada tag yang dipindai:

Untuk mendapatkan tambahan ini, periksa apakah aktivitas Anda diluncurkan dengan salah satu intent NFC untuk memastikan bahwa tag telah dipindai, lalu dapatkan tambahan dari intent tersebut. Contoh berikut memeriksa intent ACTION_NDEF_DISCOVERED dan mendapatkan pesan NDEF dari intent tambahan.

Kotlin

override fun onNewIntent(intent: Intent) {
    super.onNewIntent(intent)
    ...
    if (NfcAdapter.ACTION_NDEF_DISCOVERED == intent.action) {
        intent.getParcelableArrayExtra(NfcAdapter.EXTRA_NDEF_MESSAGES)?.also { rawMessages ->
            val messages: List<NdefMessage> = rawMessages.map { it as NdefMessage }
            // Process the messages array.
            ...
        }
    }
}

Java

@Override
protected void onNewIntent(Intent intent) {
    super.onNewIntent(intent);
    ...
    if (NfcAdapter.ACTION_NDEF_DISCOVERED.equals(intent.getAction())) {
        Parcelable[] rawMessages =
            intent.getParcelableArrayExtra(NfcAdapter.EXTRA_NDEF_MESSAGES);
        if (rawMessages != null) {
            NdefMessage[] messages = new NdefMessage[rawMessages.length];
            for (int i = 0; i < rawMessages.length; i++) {
                messages[i] = (NdefMessage) rawMessages[i];
            }
            // Process the messages array.
            ...
        }
    }
}

Atau, Anda dapat memperoleh objek Tag dari intent, yang akan berisi payload dan memungkinkan Anda menghitung teknologi tag:

Kotlin

val tag: Tag = intent.getParcelableExtra(NfcAdapter.EXTRA_TAG)

Java

Tag tag = intent.getParcelableExtra(NfcAdapter.EXTRA_TAG);

Membuat jenis data NDEF yang umum

Bagian ini menjelaskan cara membuat jenis umum data NDEF untuk membantu Anda saat menulis ke tag NFC. Mulai Android 4.0 (level API 14), metode createUri() tersedia untuk membantu Anda membuat data URI secara otomatis. Mulai Android 4.1 (level API 16), createExternal() dan createMime() tersedia untuk membantu Anda membuat MIME dan data NDEF jenis eksternal. Gunakan metode bantuan ini jika memungkinkan untuk menghindari kesalahan saat membuat data NDEF secara manual.

Bagian ini juga menjelaskan cara membuat filter intent yang sesuai untuk data tersebut. Semua contoh data NDEF ini harus berada dalam data NDEF pertama dari pesan NDEF yang Anda tulis ke tag.

TNF_ABSOLUTE_URI

Catatan: Sebaiknya gunakan jenis RTD_URI, bukan TNF_ABSOLUTE_URI, karena lebih efisien.

Anda dapat membuat data NDEF TNF_ABSOLUTE_URI dengan cara berikut :

Kotlin

val uriRecord = ByteArray(0).let { emptyByteArray ->
    NdefRecord(
            TNF_ABSOLUTE_URI,
            "https://developer.android.com/index.html".toByteArray(Charset.forName("US-ASCII")),
            emptyByteArray,
            emptyByteArray
    )
}

Java

NdefRecord uriRecord = new NdefRecord(
    NdefRecord.TNF_ABSOLUTE_URI ,
    "https://developer.android.com/index.html".getBytes(Charset.forName("US-ASCII")),
    new byte[0], new byte[0]);

Filter intent untuk data NDEF sebelumnya akan terlihat seperti ini:

<activity
    android:name=".MyActivity"
    android:exported="true"
    android:permission="android.permission.DISPATCH_NFC_MESSAGE">
    <intent-filter>
        <action android:name="android.nfc.action.NDEF_DISCOVERED" />
        <category android:name="android.intent.category.DEFAULT" />
        <data android:scheme="https"
            android:host="developer.android.com"
            android:pathPrefix="/index.html" />
    </intent-filter>
</activity>

TNF_MIME_MEDIA

Anda dapat membuat data NDEF TNF_MIME_MEDIA dengan cara berikut:

Menggunakan metode createMime():

Kotlin

val mimeRecord = NdefRecord.createMime(
        "application/vnd.com.example.android.beam",
        "Beam me up, Android".toByteArray(Charset.forName("US-ASCII"))
)

Java

NdefRecord mimeRecord = NdefRecord.createMime("application/vnd.com.example.android.beam",
    "Beam me up, Android".getBytes(Charset.forName("US-ASCII")));

Membuat NdefRecord secara manual:

Kotlin

val mimeRecord = Charset.forName("US-ASCII").let { usAscii ->
    NdefRecord(
            NdefRecord.TNF_MIME_MEDIA,
            "application/vnd.com.example.android.beam".toByteArray(usAscii),
            ByteArray(0),
            "Beam me up, Android!".toByteArray(usAscii)
    )
}

Java

NdefRecord mimeRecord = new NdefRecord(
    NdefRecord.TNF_MIME_MEDIA ,
    "application/vnd.com.example.android.beam".getBytes(Charset.forName("US-ASCII")),
    new byte[0], "Beam me up, Android!".getBytes(Charset.forName("US-ASCII")));

Filter intent untuk data NDEF sebelumnya akan terlihat seperti ini:

<activity
    android:name=".MyActivity"
    android:exported="true"
    android:permission="android.permission.DISPATCH_NFC_MESSAGE">
    <intent-filter>
        <action android:name="android.nfc.action.NDEF_DISCOVERED" />
        <category android:name="android.intent.category.DEFAULT" />
        <data android:mimeType="application/vnd.com.example.android.beam" />
    </intent-filter>
</activity>

TNF_WELL_KNOWN dengan RTD_TEXT

Anda dapat membuat data NDEF TNF_WELL_KNOWN dengan cara berikut:

Kotlin

fun createTextRecord(payload: String, locale: Locale, encodeInUtf8: Boolean): NdefRecord {
    val langBytes = locale.language.toByteArray(Charset.forName("US-ASCII"))
    val utfEncoding = if (encodeInUtf8) Charset.forName("UTF-8") else Charset.forName("UTF-16")
    val textBytes = payload.toByteArray(utfEncoding)
    val utfBit: Int = if (encodeInUtf8) 0 else 1 shl 7
    val status = (utfBit + langBytes.size).toChar()
    val data = ByteArray(1 + langBytes.size + textBytes.size)
    data[0] = status.toByte()
    System.arraycopy(langBytes, 0, data, 1, langBytes.size)
    System.arraycopy(textBytes, 0, data, 1 + langBytes.size, textBytes.size)
    return NdefRecord(NdefRecord.TNF_WELL_KNOWN, NdefRecord.RTD_TEXT, ByteArray(0), data)
}

Java

public NdefRecord createTextRecord(String payload, Locale locale, boolean encodeInUtf8) {
    byte[] langBytes = locale.getLanguage().getBytes(Charset.forName("US-ASCII"));
    Charset utfEncoding = encodeInUtf8 ? Charset.forName("UTF-8") : Charset.forName("UTF-16");
    byte[] textBytes = payload.getBytes(utfEncoding);
    int utfBit = encodeInUtf8 ? 0 : (1 << 7);
    char status = (char) (utfBit + langBytes.length);
    byte[] data = new byte[1 + langBytes.length + textBytes.length];
    data[0] = (byte) status;
    System.arraycopy(langBytes, 0, data, 1, langBytes.length);
    System.arraycopy(textBytes, 0, data, 1 + langBytes.length, textBytes.length);
    NdefRecord record = new NdefRecord(NdefRecord.TNF_WELL_KNOWN,
    NdefRecord.RTD_TEXT, new byte[0], data);
    return record;
}

Filter intent untuk data NDEF sebelumnya akan terlihat seperti ini:

<activity
    android:name=".MyActivity"
    android:exported="true"
    android:permission="android.permission.DISPATCH_NFC_MESSAGE">
    <intent-filter>
        <action android:name="android.nfc.action.NDEF_DISCOVERED" />
        <category android:name="android.intent.category.DEFAULT" />
        <data android:mimeType="text/plain" />
    </intent-filter>
</activity>

TNF_WELL_KNOWN dengan RTD_URI

Anda dapat membuat data NDEF TNF_WELL_KNOWN dengan cara berikut:

Menggunakan metode createUri(String):

Kotlin

val rtdUriRecord1 = NdefRecord.createUri("https://example.com")

Java

NdefRecord rtdUriRecord1 = NdefRecord.createUri("https://example.com");

Menggunakan metode createUri(Uri):

Kotlin

val rtdUriRecord2 = Uri.parse("https://example.com").let { uri ->
    NdefRecord.createUri(uri)
}

Java

Uri uri = Uri.parse("https://example.com");
NdefRecord rtdUriRecord2 = NdefRecord.createUri(uri);

Membuat NdefRecord secara manual:

Kotlin

val uriField = "example.com".toByteArray(Charset.forName("US-ASCII"))
val payload = ByteArray(uriField.size + 1)                   //add 1 for the URI Prefix
payload [0] = 0x01                                           //prefixes https://www. to the URI
System.arraycopy(uriField, 0, payload, 1, uriField.size)     //appends URI to payload
val rtdUriRecord = NdefRecord(NdefRecord.TNF_WELL_KNOWN, NdefRecord.RTD_URI, ByteArray(0), payload)

Java

byte[] uriField = "example.com".getBytes(Charset.forName("US-ASCII"));
byte[] payload = new byte[uriField.length + 1];              //add 1 for the URI Prefix
payload[0] = 0x01;                                           //prefixes https://www. to the URI
System.arraycopy(uriField, 0, payload, 1, uriField.length);  //appends URI to payload
NdefRecord rtdUriRecord = new NdefRecord(
    NdefRecord.TNF_WELL_KNOWN, NdefRecord.RTD_URI, new byte[0], payload);

Filter intent untuk data NDEF sebelumnya akan terlihat seperti ini:

<activity
    android:name=".MyActivity"
    android:exported="true"
    android:permission="android.permission.DISPATCH_NFC_MESSAGE">
    <intent-filter>
        <action android:name="android.nfc.action.NDEF_DISCOVERED" />
        <category android:name="android.intent.category.DEFAULT" />
        <data android:scheme="https"
            android:host="example.com"
            android:pathPrefix="" />
    </intent-filter>
</activity>

TNF_EXTERNAL_TYPE

Anda dapat membuat data NDEF TNF_EXTERNAL_TYPE dengan cara berikut:

Menggunakan metode createExternal():

Kotlin

var payload: ByteArray //assign to your data
val domain = "com.example" //usually your app's package name
val type = "externalType"
val extRecord = NdefRecord.createExternal(domain, type, payload)

Java

byte[] payload; //assign to your data
String domain = "com.example"; //usually your app's package name
String type = "externalType";
NdefRecord extRecord = NdefRecord.createExternal(domain, type, payload);

Membuat NdefRecord secara manual:

Kotlin

var payload: ByteArray
...
val extRecord = NdefRecord(
        NdefRecord.TNF_EXTERNAL_TYPE,
        "com.example:externalType".toByteArray(Charset.forName("US-ASCII")),
        ByteArray(0),
        payload
)

Java

byte[] payload;
...
NdefRecord extRecord = new NdefRecord(
    NdefRecord.TNF_EXTERNAL_TYPE, "com.example:externalType".getBytes(Charset.forName("US-ASCII")),
    new byte[0], payload);

Filter intent untuk data NDEF sebelumnya akan terlihat seperti ini:

<activity
    android:name=".MyActivity"
    android:exported="true"
    android:permission="android.permission.DISPATCH_NFC_MESSAGE">
    <intent-filter>
        <action android:name="android.nfc.action.NDEF_DISCOVERED" />
        <category android:name="android.intent.category.DEFAULT" />
        <data android:scheme="vnd.android.nfc"
            android:host="ext"
            android:pathPrefix="/com.example:externalType"/>
    </intent-filter>
</activity>

Gunakan TNF_EXTERNAL_TYPE untuk deployment tag NFC yang lebih umum agar dapat mendukung perangkat Android dan non-Android dengan lebih baik.

Catatan: URN untuk TNF_EXTERNAL_TYPE memiliki format kanonis: urn:nfc:ext:example.com:externalType, tetapi spesifikasi RTD NFC Forum menyatakan bahwa bagian urn:nfc:ext: dari URN harus dihilangkan dari data NDEF. Jadi, Anda hanya perlu memberikan domain (example.com dalam contoh) dan jenis (externalType dalam contoh) yang dipisahkan dengan titik dua. Saat mengirimkan TNF_EXTERNAL_TYPE, Android mengonversi URN urn:nfc:ext:example.com:externalType menjadi URI vnd.android.nfc://ext/example.com:externalType, yang dideklarasikan oleh filter intent dalam contoh.

Data aplikasi Android

Diperkenalkan di Android 4.0 (level API 14), Android Application Record (AAR) memberikan kepastian yang lebih kuat bahwa aplikasi Android Anda dimulai saat tag NFC dipindai. AAR memiliki nama paket aplikasi yang disematkan di dalam data NDEF. Anda dapat menambahkan AAR ke data NDEF apa pun dari pesan NDEF, karena Android menelusuri seluruh pesan NDEF untuk menemukan AAR. Jika menemukan AAR, perangkat akan memulai aplikasi berdasarkan nama paket di dalam AAR. Jika aplikasi tidak ada di perangkat, Google Play akan diluncurkan untuk mendownload aplikasi.

AAR berguna jika Anda ingin mencegah aplikasi lain memfilter intent yang sama dan berpotensi menangani tag tertentu yang telah Anda deploy. AAR hanya didukung di tingkat aplikasi, karena batasan nama paket, dan bukan di tingkat Aktivitas seperti pemfilteran intent. Jika Anda ingin menangani intent di tingkat Aktivitas, gunakan filter intent.

Jika tag berisi AAR, sistem pengiriman tag akan melakukan pengiriman dengan cara berikut:

  1. Cobalah memulai Aktivitas menggunakan filter intent seperti biasa. Jika Aktivitas yang cocok dengan intent juga cocok dengan AAR, mulai Aktivitas.
  2. Jika Aktivitas yang memfilter intent tidak cocok dengan AAR, jika beberapa Aktivitas dapat menangani intent, atau jika tidak ada Aktivitas yang menangani intent, mulai aplikasi yang ditentukan oleh AAR.
  3. Jika tidak ada aplikasi yang dapat dimulai dengan AAR, buka Google Play untuk mendownload aplikasi berdasarkan AAR.

Catatan: Anda dapat mengganti AAR dan sistem pengiriman intent dengan sistem pengiriman latar depan, yang memungkinkan aktivitas latar depan memiliki prioritas saat tag NFC ditemukan. Dengan metode ini, aktivitas harus berada di latar depan untuk mengganti AAR dan sistem pengiriman intent.

Jika masih ingin memfilter tag yang dipindai yang tidak berisi AAR, Anda dapat mendeklarasikan filter intent seperti biasa. Hal ini berguna jika aplikasi Anda tertarik dengan tag lain yang tidak berisi AAR. Misalnya, Anda mungkin ingin memastikan bahwa aplikasi Anda menangani tag eksklusif yang Anda deploy serta tag umum yang di-deploy oleh pihak ketiga. Perlu diingat bahwa AAR khusus untuk perangkat Android 4.0 atau yang lebih baru, jadi saat men-deploy tag, Anda kemungkinan besar ingin menggunakan kombinasi AAR dan jenis MIME/URI untuk mendukung berbagai perangkat. Selain itu, saat men-deploy tag NFC, pikirkan cara menulis tag NFC untuk mengaktifkan dukungan bagi sebagian besar perangkat (perangkat yang didukung Android dan perangkat lainnya). Anda dapat melakukannya dengan menentukan jenis MIME atau URI yang relatif unik agar aplikasi lebih mudah membedakannya.

Android menyediakan API sederhana untuk membuat AAR, createApplicationRecord(). Anda hanya perlu menyematkan AAR di mana saja dalam NdefMessage. Anda tidak ingin menggunakan data pertama NdefMessage, kecuali jika AAR adalah satu-satunya data di NdefMessage. Hal ini karena sistem Android memeriksa data pertama NdefMessage untuk menentukan jenis MIME atau URI tag, yang digunakan untuk membuat intent yang akan difilter oleh aplikasi. Kode berikut menunjukkan cara membuat AAR:

Kotlin

val msg = NdefMessage(
        arrayOf(
                ...,
                NdefRecord.createApplicationRecord("com.example.android.beam")
        )
)

Java

NdefMessage msg = new NdefMessage(
        new NdefRecord[] {
            ...,
            NdefRecord.createApplicationRecord("com.example.android.beam")}
        );
)

Daftar aplikasi yang diizinkan untuk pemindaian tag NFC

Mulai Android 16, pengguna akan diberi tahu saat aplikasi menerima intent NFC pertamanya untuk memindai tag NFC. Pengguna diberi opsi untuk tidak mengizinkan aplikasi memindai tag NFC lagi di notifikasi.

Catatan: Daftar aplikasi yang diizinkan untuk memindai tag NFC dapat diakses di bagian Settings > Apps > Special app access > Launch via NFC.

Mekanisme ini ditambahkan untuk mengatasi kekhawatiran yang diajukan oleh pengguna bahwa beberapa aplikasi yang telah mendaftarkan filter intent untuk intent tag NFC berulang kali dibawa ke latar depan saat mereka meletakkan ponsel di samping tag NFC (kartu kredit, ponsel/smartwatch lain, dll.).