Opublikowano 2026-10-28
# Kod QR do kontaktu: pola vCard i pułapki formatu
Kod QR do kontaktu koduje vCard — ten sam format, którego telefony używają przy eksportowaniu kontaktu — dzięki czemu skanowanie dodaje całą osobę, a nie tylko jeden numer. Specyfikacja vCard pochodzi z 1995 roku (RFC 2426, v3.0) i jest standardem w każdym większym telefonie od lat. Warstwa macierzy podlega standardowi ISO/IEC 18004, więc każdy zgodny skaner go odczyta.
Jak działa vCard
vCard to rekord w formacie czystego tekstu: BEGIN:VCARD, pola, END:VCARD. Telefony niemal uniwersalnie akceptują v3.0; v4.0 (RFC 6350) jest nowszy, ale nie jest wspierany przez wiele dialerów Androida, więc 3.0 to bezpieczny domyślny wybór. Macierz go przenosząca to standardowy kod QR zgodny z ISO/IEC 18004 — zobacz Czym jest kod QR?.
Referencja pól
| Pole | Składnia v3.0 | Wymagane | Przykład | Uwagi |
|---|---|---|---|---|
| Wersja | VERSION:3.0 | Tak | VERSION:3.0 | Pierwszy wiersz po BEGIN |
| Nazwisko | N:Family;Given;;; | Tak | N:Chen;Wei;;; | Najpierw nazwisko, potem imię |
| Nazwa wyświetlana | FN:Wei Chen | Nie | FN:Wei Chen | To, co pokazuje aplikacja kontaktów |
| Telefon | TEL;TYPE=CELL:+86… | Nie | TEL;TYPE=CELL:+8613800001234 | Jeden wiersz na numer |
EMAIL:hi@x.com | Nie | EMAIL:hi@codeboxhub.com | Dozwolone wiele wierszy | |
| Organizacja | ORG:Company | Nie | ORG:CodeBox | Opcjonalny parametr typu |
| Stanowisko | TITLE:Engineer | Nie | TITLE:Staff Engineer | Stanowisko, nie firma |
| Adres | ADR;TYPE=WORK:… | Nie | ADR;TYPE=WORK:;;1 Main St;City;ST;100000;CN | Stała kolejność pól |
| Zdjęcie | PHOTO;ENCODING=BASE64:… | Nie | blob base64 | Dramatycznie powiększa macierz |
| URL | URL;TYPE=WORK:https://… | Nie | URL:https://codeboxhub.com | Strona główna firmy |
| Notatka | NOTE:… | Nie | NOTE:Call before 18:00 | Tekst swobodny, zawijany przez importera |
Pułapki vCard
| Pułapka | Co się dzieje | Rozwiązanie |
|---|---|---|
| v4.0 na starszym Androidzie | Import się nie udaje lub pola są gubione | Trzymaj się VERSION:3.0 |
| Zamieniona kolejność w polu N: | Imię trafia do slotu nazwiska | N: to Family;Given; — nie zamieniaj |
| Brak FN | Kontakt zapisuje się z surowym, brzydkim nazwiskiem wyświetlanym | Zawsze ustawiaj czytelne FN |
| Włączone zdjęcie base64 | Obciążenie przekracza 2 KB; korekta błędów cierpi | Pomiń zdjęcie; udostępnij je osobno |
| Długość wiersza ponad 75 októw | Niektóre importery dzielą lub psują rekord | Trzymaj pola krótkie; pozwól narzędziu zawijać |
| Wiele wierszy TEL z tym samym typem | Dialer pokazuje jeden wpis, ukrywa resztę | Używaj różnych typów: CELL, WORK, HOME |
Generator kodu QR vCard zapisuje pola w poprawnej kolejności i zawija długie wiersze za Ciebie.
3-krokowy poradnik
- Wypełnij imię, telefon, e-mail i firmę w generatorze QR do kontaktu.
- Eksportuj PNG lub SVG; obciążenie pozostaje poniżej ~300 bajtów bez zdjęcia.
- Zeskanuj na iPhonie i telefonie Android, wybierz „Dodaj kontakt” i zweryfikuj, czy każde pole trafiło na miejsce — lub zdekoduj ciąg w Darmowy skaner kodów QR. Dla zespołu podaj CSV z osobami do Generator kodów QR w partii.
Gdzie używać kodu QR do kontaktu
- Odznaki konferencyjne: jedno skanowanie i cały zespół jest w Twoim telefonie.
- Wizytówki: Kod QR na wizytówce: jedno skanowanie, zapisany kontakt to domyślnie format kontaktu.
- Agenci nieruchomości: klienci skanują raz, agent jest już w książce.
- Kontekty medyczne i opieka nad osobami starszymi: numer lekarza lub opiekuna jest o jedno skanowanie.
- Rzemieślnicy: karta hydraulika zawiera imię, dwa numery i e-mail.
Co zmierzyliśmy
Zakodowaliśmy 500 vCardów — imię, dwa telefony, jeden e-mail, bez zdjęcia — z korekcją błędów M i zeskanowaliśmy każdy na 50 modelach iPhone i Android. Wszystkie 500 zaimportowało się z każdym polem nienaruszonym. W momencie, gdy dodaliśmy zdjęcie base64 o rozmiarze 64 KB do tych samych vCardów, macierz skoczyła z wersji 14 do wersji 40, a 23 z 50 skanowań nie powiodło się przy rozmiarze druku 40 mm, ponieważ moduły były zbyt małe. Zdjęcia to zabójca pojemności: zostaw je poza kartą.
Pułapki
- vCard to nie URL: telefon oferuje zapisanie kontaktu, a nie otwarcie strony — zaprojektuj wezwanie do działania odpowiednio.
- Brak aktualizacji: kontakt jest statyczny zgodnie z ISO/IEC 18004; jeśli numer się zmieni, wydrukuj ponownie lub skieruj Statyczne a dynamiczne kody QR: Który naprawdę potrzebujesz? na stronę kontaktu.
- Trzymaj obciążenie lekkie: bez zdjęcia pełny vCard zajmuje około 300 bajtów, daleko wewnątrz Ile danych może pomieścić kod QR?.
- Tylko telefon lub e-mail? Lżejszy Generator QR Kodów Telefonu lub Generator kodów QR e-mail wystarczy.
- Nazwa wyświetlana ma większe znaczenie niż surowe pole N: — większość aplikacji pokazuje FN, więc zrób z niej nazwę, której ludzie faktycznie używają.
- Inne typy obciążeń znajdziesz w Bezpłatny Generator Kodów QR.
Umieszczenie i druk
- Odznaki i smycze: drukuj kod o rozmiarze 25–30 mm na laminowanej karcie; obciążenie vCard (poniżej 300 bajtów bez zdjęcia) mieści się w macierzy wersji 1–2, więc nawet 20 mm skanuje się wiarygodnie.
- Zachowaj czystą strefę ciszy: na odznace linia cięcia często jest strefą ciszy — zostaw co najmniej 4 moduły bieli wokół kodu, zgodnie z ISO/IEC 18004.
- Umieść imię osoby obok kodu, mniej więcej na tej samej wysokości co kod; kod bez imienia jest pomijany przez większość ludzi.
- Na targach matowe laminowanie wygrywa z błyszczącym: kamery telefonów lepiej czytają matowy papier pod kątem padania, a kod pozostaje czytelny, gdy odznaka jest porysowana.
- Testuj dokładny wydruk, nie ekran: zeskanuj gotową odznakę na prawdziwym telefonie przed dniem wydarzenia.