CodeBox Hub
ZA DARMO

Kod QR do kontaktu: pola vCard i pułapki formatu

Koduj kontakt w formacie vCard 3.0: tabela pól, pułapki FN/TEL/N i 3-krokowy poradnik.

# 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

PoleSkładnia v3.0WymaganePrzykładUwagi
WersjaVERSION:3.0TakVERSION:3.0Pierwszy wiersz po BEGIN
NazwiskoN:Family;Given;;;TakN:Chen;Wei;;;Najpierw nazwisko, potem imię
Nazwa wyświetlanaFN:Wei ChenNieFN:Wei ChenTo, co pokazuje aplikacja kontaktów
TelefonTEL;TYPE=CELL:+86…NieTEL;TYPE=CELL:+8613800001234Jeden wiersz na numer
E-mailEMAIL:hi@x.comNieEMAIL:hi@codeboxhub.comDozwolone wiele wierszy
OrganizacjaORG:CompanyNieORG:CodeBoxOpcjonalny parametr typu
StanowiskoTITLE:EngineerNieTITLE:Staff EngineerStanowisko, nie firma
AdresADR;TYPE=WORK:…NieADR;TYPE=WORK:;;1 Main St;City;ST;100000;CNStała kolejność pól
ZdjęciePHOTO;ENCODING=BASE64:…Nieblob base64Dramatycznie powiększa macierz
URLURL;TYPE=WORK:https://…NieURL:https://codeboxhub.comStrona główna firmy
NotatkaNOTE:…NieNOTE:Call before 18:00Tekst swobodny, zawijany przez importera

Pułapki vCard

PułapkaCo się dziejeRozwiązanie
v4.0 na starszym AndroidzieImport się nie udaje lub pola są gubioneTrzymaj się VERSION:3.0
Zamieniona kolejność w polu N:Imię trafia do slotu nazwiskaN: to Family;Given; — nie zamieniaj
Brak FNKontakt zapisuje się z surowym, brzydkim nazwiskiem wyświetlanymZawsze ustawiaj czytelne FN
Włączone zdjęcie base64Obciążenie przekracza 2 KB; korekta błędów cierpiPomiń zdjęcie; udostępnij je osobno
Długość wiersza ponad 75 októwNiektóre importery dzielą lub psują rekordTrzymaj pola krótkie; pozwól narzędziu zawijać
Wiele wierszy TEL z tym samym typemDialer 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

  1. Wypełnij imię, telefon, e-mail i firmę w generatorze QR do kontaktu.
  2. Eksportuj PNG lub SVG; obciążenie pozostaje poniżej ~300 bajtów bez zdjęcia.
  3. 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

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.

Najczęstsze pytania

Co robi kod QR do kontaktu?

Otwiera okno „Dodaj kontakt” z kompletnym vCardem — imieniem, numerami, e-mailem, firmą — gotowym do zapisania.

Czy powinienem używać vCard 3.0 czy 4.0?

3.0 (RFC 2426). Importuje się czysto na każdym większym telefonie; v4.0 psuje się na niektórych starszych dialerach Androida.

Czy kod QR do kontaktu może zawierać zdjęcie?

Technicznie tak, przez pole PHOTO base64, ale tak bardzo powiększa macierz, że małe druki nie działają; pomiń je.

Jak dodać dwa numery telefonów do jednego vCarda?

Napisz dwa wiersze TEL z różnymi typami, na przykład `TEL;TYPE=CELL` i `TEL;TYPE=WORK`.

Czy kody QR do kontaktu działają na Androidzie?

Tak. Android traktuje vCard jako import kontaktu i pokazuje standardowy przepływ dodawania kontaktu.

Jaka jest różnica między polami N: i FN:?

N: to strukturalne nazwisko/imię używane do sortowania; FN: to nazwa wyświetlana, którą pokazuje aplikacja kontaktów.

Czy kod QR do kontaktu jest taki sam jak kod QR wizytówki?

Zazwyczaj tak — domyślnym obciążeniem wizytówki jest vCard; różnica polega tylko na tym, co drukujesz wokół niego.

Czytaj dalej

Skontaktuj się z nami