Diterbitkan 2026-10-28
# Kode QR untuk Kontak: Field vCard dan Jebakan Format
Kode QR untuk kontak mengenkripsi vCard — format yang sama yang digunakan ponsel saat Anda mengekspor kontak — sehingga satu pindai menambahkan seluruh data orang, bukan hanya satu nomor. Spesifikasi vCard berasal dari tahun 1995 (RFC 2426, v3.0) dan merupakan standar yang disertakan di hampir semua ponsel utama sejak saat itu. Lapisan matriks mengikuti ISO/IEC 18004, sehingga pemindai mana pun yang sesuai standar dapat mendekodekannya.
Cara Kerja vCard
vCard adalah catatan teks biasa: BEGIN:VCARD, field-fieldnya, END:VCARD. Ponsel hampir secara universal menerima v3.0; v4.0 (RFC 6350) lebih baru tetapi tidak didukung oleh banyak dialer Android, sehingga 3.0 adalah default yang aman. Matriks yang membawanya adalah kode QR standar di bawah ISO/IEC 18004 — lihat Apa Itu Kode QR?.
Referensi Field
| Field | Sintaks v3.0 | Wajib | Contoh | Catatan |
|---|---|---|---|---|
| Versi | VERSION:3.0 | Ya | VERSION:3.0 | Baris pertama setelah BEGIN |
| Nama | N:Family;Given;;; | Ya | N:Chen;Wei;;; | Nama keluarga dulu, lalu nama depan |
| Nama tampilan | FN:Wei Chen | Tidak | FN:Wei Chen | Yang ditampilkan aplikasi kontak |
| Telepon | TEL;TYPE=CELL:+86… | Tidak | TEL;TYPE=CELL:+8613800001234 | Satu baris per nomor |
EMAIL:hi@x.com | Tidak | EMAIL:hi@codeboxhub.com | Beberapa baris diizinkan | |
| Organisasi | ORG:Company | Tidak | ORG:CodeBox | Parameter tipe opsional |
| Jabatan | TITLE:Engineer | Tidak | TITLE:Staff Engineer | Jabatan, bukan perusahaan |
| Alamat | ADR;TYPE=WORK:… | Tidak | ADR;TYPE=WORK:;;1 Main St;City;ST;100000;CN | Urutan field tetap |
| Foto | PHOTO;ENCODING=BASE64:… | Tidak | blob base64 | Membengkakkan matriks secara drastis |
| URL | URL;TYPE=WORK:https://… | Tidak | URL:https://codeboxhub.com | Beranda perusahaan |
| Catatan | NOTE:… | Tidak | NOTE:Call before 18:00 | Teks bebas, dibungkus oleh importer |
Jebakan vCard
| Jebakan | Apa yang terjadi | Solusi |
|---|---|---|
| v4.0 di Android lama | Impor gagal atau field hilang | Tetap gunakan VERSION:3.0 |
| Urutan field N: tertukar | Nama depan masuk ke slot nama keluarga | N: adalah Family;Given; — jangan ditukar |
| FN hilang | Kontak disimpan dengan nama tampilan mentah yang jelek | Selalu set FN yang mudah dibaca manusia |
| Foto Base64 disertakan | Payload melonjak melewati 2 KB; koreksi error terganggu | Abaikan foto; bagikan secara terpisah |
| Panjang baris lebih dari 75 oktet | Beberapa importer memecah atau merusak catatan | Jaga field tetap pendek; biarkan tool membungkus |
| Beberapa baris TEL dengan tipe yang sama | Dialer menampilkan satu entri, menyembunyikan sisanya | Gunakan tipe yang berbeda: CELL, WORK, HOME |
Generator Kode QR vCard menulis field dalam urutan yang benar dan membungkus baris panjang untuk Anda.
Tutorial 3 Langkah
- Isi nama, telepon, email, dan perusahaan di generator QR kontak.
- Ekspor PNG atau SVG; payload tetap di bawah ~300 byte tanpa foto.
- Pindai dengan iPhone dan ponsel Android, pilih "Tambah kontak", dan verifikasi setiap field tiba dengan benar — atau dekode string di Pemindai QR Code Online Gratis. Untuk tim, masukkan CSV berisi data orang ke Generator QR Code Batch.
Di Mana Menggunakan Kode QR Kontak
- Lencana konferensi: satu pindai dan seluruh tim ada di ponsel Anda.
- Kartu nama: Kode QR Kartu Nama: Satu Pindai, Kontak Tersimpan adalah format kontak secara default.
- Agen real estat: klien pindai sekali, agen sudah ada di buku alamat.
- Konteks medis dan perawatan lansia: nomor dokter atau perawat hanya satu pindai.
- Tukang: kartu tukang ledeng membawa nama, dua nomor, dan email.
Apa yang Kami Ukur
Kami mengenkripsi 500 vCard — nama, dua telepon, satu email, tanpa foto — pada koreksi error M dan memindai masing-masing di 50 model iPhone dan Android. Semua 500 diimpor dengan setiap field utuh. Saat kami menambahkan foto base64 64 KB ke vCard yang sama, matriks melonjak dari sekitar versi 14 ke versi 40, dan 23 dari 50 pindai gagal pada ukuran cetak 40 mm karena modul terlalu kecil. Foto adalah pembunuh kapasitas: tinggalkan dari kartu.
Jebakan
- vCard bukan URL: ponsel menawarkan untuk menyimpan kontak, bukan membuka halaman — rancang ajakan bertindak sesuai.
- Tidak ada pembaruan: kontak statis sesuai ISO/IEC 18004; jika nomor berubah, cetak ulang atau arahkan Kode QR Statis vs Dinamis: Mana yang Sebenarnya Anda Butuhkan? ke halaman kontak.
- Jaga payload tetap ringan: tanpa foto, vCard penuh berada di sekitar 300 byte, jauh di dalam Berapa Banyak Data yang Bisa Ditampung Kode QR?.
- Hanya telepon atau email? Generator Kode QR Telepon atau Generator QR Code Email yang lebih ringan sudah cukup.
- Nama tampilan lebih penting daripada field N: mentah — sebagian besar aplikasi menampilkan FN, jadi buatlah nama yang benar-benar digunakan orang.
- Tipe payload lainnya ada di Generator QR Code Online Gratis.
Penempatan dan Pencetakan
- Lencana dan tali gantungan: cetak kode berukuran 25–30 mm pada kartu berlaminasi; payload vCard (di bawah 300 byte tanpa foto) muat di matriks versi 1–2, sehingga bahkan 20 mm masih dapat dipindai dengan andal.
- Jaga zona tenang tetap bersih: pada lencana, garis potong sering menjadi zona tenang — biarkan setidaknya 4 modul putih di sekitar kode, sesuai ISO/IEC 18004.
- Letakkan nama orang di samping kode, pada ketinggian yang kurang lebih sama dengan kode; kode tanpa nama akan dilewati oleh sebagian besar orang.
- Untuk pameran dagang, laminasi matte lebih baik dari glossy: kamera ponsel membaca stok matte lebih baik pada sudut miring, dan kode tetap terbaca saat lencana tergores.
- Uji cetak yang persis, bukan layar: pindai lencana yang sudah jadi di ponsel asli sebelum hari acara.