Format del codi QR vCard: camps, versions i un exemple que funciona

    QR Cake TeamPublicat:

    Què conté realment un codi QR vCard: el format de text línia per línia, els camps que entenen els mòbils, vCard 3.0 vs 4.0 vs MECARD, i per què un contacte llarg dona un codi difícil d'escanejar.

    Un codi QR vCard és un codi QR que conté un contacte escrit en format vCard: text pla que comença amb BEGIN:VCARD, recull una dada per línia i acaba amb END:VCARD. Quan la càmera d'un mòbil llegeix aquest text, hi reconeix un contacte i ofereix afegir-lo a l'agenda. Un fitxer .vcf conté exactament el mateix format.

    Aquesta guia mostra el format línia per línia, quina versió fer servir, quantes dades hi caben i quan és millor deixar que un generador de codis QR vCard desi un enllaç curt en lloc del contacte en brut.

    Com és el format vCard dins d'un codi QR



    Aquí tens un contacte complet i vàlid. Cada línia és una propietat: el nom d'un camp, dos punts i un valor.

    BEGIN:VCARD
    VERSION:3.0
    N:Rivera;Alex;;;
    FN:Alex Rivera
    ORG:Example Studio
    TITLE:Account Manager
    TEL;TYPE=CELL:+12025550123
    EMAIL:[email protected]
    URL:https://example.com
    ADR;TYPE=WORK:;;100 Main Street;Springfield;IL;62701;USA
    END:VCARD


    Tres regles sostenen el format:

    • La vCard comença amb BEGIN:VCARD i acaba amb END:VCARD, i la línia VERSION va just després de la primera.
    • Cada propietat ocupa una línia pròpia. Els punts i comes separen les parts d'un valor estructurat, com ara els components d'un nom o d'una adreça.
    • Una coma, un punt i coma o una barra inversa que formin part del text mateix porten una barra inversa al davant, així que «Smith, Jones and Co» s'escriu «Smith\, Jones and Co».


    Els camps vCard que entenen els mòbils



    Un contacte pot incloure desenes de propietats, però aquestes són les que les aplicacions de contactes dels mòbils llegeixen de manera coherent:

    CampQuè contéExemple
    FNEl nom complet tal com s'ha de mostrar. Obligatori.FN:Alex Rivera
    NEl nom per parts: cognom, nom, noms intermedis, prefix i sufix. Obligatori a la versió 3.0.N:Rivera;Alex;;;
    ORGEmpresa o organitzacióORG:Example Studio
    TITLECàrrecTITLE:Account Manager
    TELNúmero de telèfon. TYPE el marca com a CELL, WORK o HOME.TEL;TYPE=CELL:+12025550123
    EMAILAdreça de correu electrònicEMAIL:[email protected]
    URLLloc webURL:https://example.com
    ADRAdreça postal en set parts: apartat de correus, despatx o pis, carrer, ciutat, estat o regió, codi postal i país.ADR;TYPE=WORK:;;100 Main Street;Springfield;IL;62701;USA
    NOTEUna nota de text lliureNOTE:Ens vam conèixer a la fira


    Escriu els números de telèfon en format internacional, amb el prefix del país (per exemple, +1 per als Estats Units), perquè el contacte desat marqui correctament des de qualsevol lloc.

    El format també té un camp PHOTO, però una foto no és pràctica dins d'un codi QR. Una imatge incrustada ocupa desenes de milers de caràcters, i un codi QR té un màxim de 2.953 bytes de dades. Deixa la foto fora d'un codi estàtic, o fes servir una targeta de contacte allotjada que la mostri a la pàgina.

    vCard 2.1, 3.0 o 4.0: quina versió fer servir



    Hi ha tres versions del format en circulació:

    • vCard 2.1 (1996) és la més antiga. La majoria de mòbils encara la llegeixen, però necessita marcatge addicional per als caràcters accentuats i no llatins.
    • vCard 3.0 (1998) és la versió que generen la majoria de generadors de codis QR i l'opció més segura per a un codi QR. Les càmeres dels iPhone i dels mòbils Android la llegeixen de manera fiable.
    • vCard 4.0 (2011) és l'estàndard actual, definit a l'RFC 6350. Sempre fa servir UTF-8 i té una sintaxi més neta, però les aplicacions de càmera la suporten de manera menys uniforme, i hi ha informes que alguns mòbils perden camps o mostren malament els caràcters especials.


    Fes servir la 3.0 tret que tinguis un motiu concret per no fer-ho, i desa el text en UTF-8 perquè els noms amb accents o en alfabets no llatins arribin intactes després de l'escaneig.

    MECARD: l'alternativa compacta



    MECARD és un format de contacte més curt que NTT DOCOMO va crear per als codis QR dels mòbils japonesos. Posa tot el contacte en una sola línia:

    MECARD:N:Rivera,Alex;TEL:+12025550123;EMAIL:[email protected];;


    Com que fa servir menys caràcters, el codi QR és menys dens i s'escaneja més fàcilment en mides petites. La contrapartida és que té menys camps: MECARD no té lloc per al nom de l'empresa ni per al càrrec, i la compatibilitat varia més d'una aplicació d'escaneig a una altra que en el cas de vCard. Tria'l només quan el codi hagi de ser molt petit i n'hi hagi prou amb un nom, un número i un correu electrònic.

    Quantes dades de contacte hi caben, i per què menys és millor



    Un codi QR pot contenir fins a 2.953 bytes, però aquest és el límit de la versió més gran i densa, no pas un objectiu. Cada caràcter que afegeixes fa el patró més gran: més mòduls, i cadascun més petit a la mateixa mida d'impressió.

    El contacte d'exemple de més amunt té 247 caràcters. Amb una correcció d'errors mitjana necessita un patró de 61 mòduls d'amplada, de manera que, imprès a 2,5 cm d'amplada en una targeta de visita, cada mòdul fa uns 0,4 mm. Un enllaç curt de 22 caràcters només necessita 25 mòduls, i a la mateixa mida cada mòdul fa 1 mm. Els mòduls més grans són els que permeten que un codi s'escanegi ràpidament amb poca llum, sobre paper amb textura o amb un mòbil antic.

    Perquè un codi vCard estàtic continuï sent llegible:

    • Inclou només el que algú necessita per contactar amb tu: un nom, un número de telèfon, un correu electrònic i un lloc web.
    • Deixa fora la foto, les notes llargues i l'adreça postal completa, tret que siguin importants.
    • Imprimeix-lo més gran del que imprimiries un codi per a un enllaç. La guia de mida del codi QR per a la impressió recull les mides mínimes.


    Codi vCard estàtic vs targeta de contacte dinàmica



    Hi ha dues maneres de posar un contacte darrere d'un codi QR.

    Un codi vCard estàtic escriu el text vCard dins del mateix patró. Funciona sense connexió a internet i sense cap servei al darrere, i no caduca mai. Tampoc no es pot canviar: un número de telèfon nou vol dir un codi nou i una reimpressió.

    Un codi vCard dinàmic desa un enllaç curt. L'escaneig obre una pàgina de targeta de contacte amb un botó «Desa el contacte», i aquest botó descarrega el fitxer .vcf. Com que les dades són en un servidor, les pots editar després d'imprimir, el patró es manté petit i la pàgina pot mostrar una foto i enllaços addicionals.

    PreguntaCodi vCard estàticCodi vCard dinàmic
    Què desa el patróEl text vCard completUn enllaç curt
    Funciona sense connexióSíNo, l'escaneig necessita connexió
    Es pot editar després d'imprimirNoSí
    Densitat del patróCreix amb cada campEs manté igual
    FotoNo és pràcticaEs mostra a la targeta de contacte
    Depèn d'un proveïdorNoSí


    Per a una targeta que repartiràs durant anys, o per a qualsevol cosa impresa en grans quantitats, el dinàmic és l'opció més segura. Codis QR dinàmics vs estàtics analitza els pros i els contres en general, i la guia del codi QR per a targetes de visita tracta la mida i la col·locació a la mateixa targeta.

    Com fer un codi QR vCard



    No cal que escriguis el format a mà. Un creador de vCard amb QR el genera a partir d'un formulari:

    1. Obre el generador de codis QR vCard de QR Cake.
    2. Introdueix el teu nom, l'empresa, el càrrec, el número de telèfon, el correu electrònic i el lloc web. Afegeix-hi una foto i els teus perfils socials si vols que surtin a la targeta.
    3. Personalitza el codi amb els teus colors, un logotip o un marc amb una etiqueta com ara «Escaneja per desar el meu contacte».
    4. Inicia la sessió amb un compte gratuït i desa el codi. Després, descarrega'l en PNG o SVG.
    5. Escaneja'l amb un iPhone i amb un mòbil Android, toca «Desa el contacte» a tots dos i revisa el contacte desat abans d'imprimir.


    Un codi vCard desat a QR Cake és dinàmic. El patró conté un enllaç curt, l'escaneig obre la teva targeta de contacte allotjada i «Desa el contacte» descarrega un fitxer vCard 3.0 estàndard. El pla gratuït inclou fins a 5 codis dinàmics amb escaneigs il·limitats, i els codis desats no caduquen. Amb el pla gratuït es mostra una pàgina breu amb un anunci abans que s'obri la targeta, i els plans de pagament la treuen.

    Com comprovar què conté un codi QR vCard



    Per veure què desa un codi existent, escaneja'l i fixa't en el que t'ofereix el mòbil. Si veus una previsualització d'un contacte amb l'opció d'afegir-lo als contactes, el text vCard és dins del patró i, per tant, el codi és estàtic. Si veus una adreça web, el codi és dinàmic. També pots pujar una foto o una captura de pantalla del codi al lector de codis QR, que en mostra el contingut descodificat.

    Errors habituals amb els codis QR vCard



    • Falta la línia VERSION o END:VCARD. En aquest cas, el mòbil pot mostrar el codi com a text pla en lloc d'un contacte.
    • Comes i punts i comes sense escapar. El nom d'una empresa com «Smith, Jones» es divideix en dos valors si la coma no porta una barra inversa al davant.
    • Massa dades. Diversos números de telèfon, una nota llarga i una adreça completa converteixen el codi d'una targeta de visita en un quadrat dens que les càmeres antigues no poden llegir.
    • Una foto incrustada. No hi cap. Si la foto és important, fes servir una targeta de contacte allotjada.
    • Números de telèfon locals. Un número sense el prefix del país falla per a qualsevol persona que el marqui des de l'estranger.
    • No provar-lo a les dues plataformes. Les aplicacions de contactes de l'iPhone i d'Android disposen els mateixos camps de manera diferent, així que revisa el contacte desat a cadascuna.


    En resum



    Un codi QR vCard és un contacte en un format de text pla: BEGIN:VCARD, una línia VERSION, un camp per línia i END:VCARD. Fes servir la versió 3.0, limita els camps als essencials i desa el text en UTF-8. Si les dades poden canviar, o el codi ha de ser petit, fes servir un codi vCard dinàmic que desi un enllaç curt i serveixi el contacte des d'una pàgina que pots editar.

    Generador de codis QR vCard

    Crea un codi QR vCard, també anomenat codi QR de targeta de contacte. Un sol escaneig mostra la teva foto, telèfon, correu i adreça amb un botó «Desa el contacte». Gratuït i dinàmic.

    QR Cake Team

    Sobre l'equip de QR Cake

    Escrit per l'equip de QR Cake: les persones que construeixen QR Cake, una plataforma de codis QR dinàmics que s'utilitza per a campanyes impreses editables, codis QR a Canva, analítica d'escanejos i redireccions QR de llarga durada que segueixen funcionant un cop finalitzada la subscripció.

    Saber-ne més sobre QR Cake

    Preguntes freqüents

    Quin format fa servir un codi QR vCard?
    Fa servir el format vCard, el mateix text pla que hi ha en un fitxer .vcf. Les dades comencen amb BEGIN:VCARD, continuen amb una línia VERSION i una propietat per línia, com ara FN per al nom, TEL per al número de telèfon i EMAIL per a l'adreça de correu electrònic, i acaben amb END:VCARD.
    Quina versió de vCard he de fer servir per a un codi QR?
    Fes servir vCard 3.0. És la versió que generen la majoria de generadors de codis QR i la que les càmeres dels iPhone i dels mòbils Android llegeixen de manera més coherent. vCard 4.0 és l'estàndard més recent, però les aplicacions de càmera la suporten de manera menys uniforme.
    Quina diferència hi ha entre vCard i MECARD?
    MECARD és un format de contacte compacte creat per NTT DOCOMO que posa tot el contacte en una sola línia. Fa servir menys caràcters, de manera que el codi QR és menys dens, però té menys camps (no té lloc per al nom de l'empresa ni per al càrrec), i la compatibilitat entre aplicacions d'escaneig varia més.
    Quanta informació pot contenir un codi QR vCard?
    Un codi QR pot contenir fins a 2.953 bytes, però un codi tan ple és massa dens per escanejar-se de manera fiable a la mida d'una targeta de visita. Limita un codi vCard estàtic a uns quants centenars de caràcters: un nom, un número de telèfon, un correu electrònic i un lloc web.
    Un codi QR vCard pot incloure una foto?
    En un codi estàtic, no. Una foto incrustada és molt més gran del que pot desar un codi QR. Un codi vCard dinàmic sí que pot mostrar una foto, perquè l'escaneig obre una pàgina de targeta de contacte allotjada en lloc de llegir el contacte del patró.
    Puc editar un codi QR vCard després d'imprimir-lo?
    Només si és dinàmic. Un codi vCard estàtic té les dades de contacte escrites dins del patró, així que qualsevol canvi exigeix un codi nou. Un codi vCard dinàmic desa un enllaç curt, i pots editar les dades que hi ha al darrere en qualsevol moment.
    Un codi QR vCard funciona sense connexió a internet?
    Un codi vCard estàtic, sí, perquè el mòbil llegeix el contacte directament del patró. Un codi vCard dinàmic necessita connexió, perquè l'escaneig obre una pàgina web que conté el contacte.
    Format del codi QR vCard: camps, versions i un exemple