目录
1.介绍
vCard(也称为电子名片)是一种常用的文件格式,用于存储个人和业务联系信息,例如姓名、电话号码、电子邮件地址等。vCard通常使用.vcf文件扩展名,并且可以通过邮件、短信或其他方式共享给他人。vCard最早由Versit联盟于1995年提出,该联盟成员包括苹果公司、AT&T科技(后来的朗讯)、IBM及西门子。
2.基本定义
vCard
必须以 BEGIN:VCARD
开头,以 END:VCARD
结尾。定义第二行为版本号 VERSION:3.0
或 VERSION:2.1
。
vCard
每行数据的格式为: 类型[;参数]:值
例如:TEL;TYPE=work,voice,pref,msg:+1-213-555-1234
类型:TEL,电话号码
参数:Type=work,voice,pref,msg,可选项
值:+1-213-555-1234
3.字段信息
键 | 字段名 | 介绍 |
---|---|---|
FN | (Formatted Name) | 表示格式化的名称,通常是一个人的全名。例如:John Doe。 |
N | (Name) | 表示姓名,包括姓、名、中间名、前缀和后缀。 |
ORG | (Organization) | 表示组织或公司名称。例如:ABC Company。 |
TITLE | (Job Title) | 表示职务或头衔。例如:Software Engineer。 |
TEL | (Telephone Number) | 表示电话号码。可以使用TYPE属性指定号码类型,如WORK(工作电话)、HOME(家庭电话)、CELL(移动电话)等。 |
(Email Address) | 表示电子邮件地址。 | |
ADR | (Address) | 表示地址信息。可以使用TYPE属性指定地址类型,如WORK(工作地址)、HOME(家庭地址)等。 |
URL | (Website URL) | 表示网站的URL。 |
NOTE | (Note) | 表示附加备注。 |
BDAY | (Birthday) | 表示生日日期。 |
PHOTO | (Photograph) | 表示照片。可以是URL或BASE64编码的图像数据。 |
REV | (Revision Date) | 表示vCard的修订日期。 |
UID | (Unique Identifier) | 表示唯一标识符,用于区分不同的vCard。 |
GEO | (Geographic Coordinates) | 表示地理坐标,通常用于指定地点的经纬度。 |
IMPP | (Instant Messaging and Presence Protocol) | 表示即时消息和在线状态。例如:Skype、WhatsApp等。 |
X-SOCIALPROFILE | (Social Media Profiles) | 表示社交媒体账户的链接。 |
4,字段详解。
4.1,预定义类型的用法
BEGIN,END
vCard 必须以 BEGIN:VCARD 开头,以 END:VCARD 结尾。
SOURCE:
类型用途:其值提供如何查找vCard源的信息
其值类型:uri
类型使用情况:很少使用
NAME
类型用途:与vCard源关联的可显示演示文本
其值类型:text
类型使用情况:很少使用
PROFILE
类型用途:标识内容类型中的信息所属的目录实体的类型,其值必须使用 vCard
类型使用情况:很少使用
4.2,基本类型
FN
目的:vcard对象的名称,一个vcard对象必须包含FN类型。例子:FN:Mr. John Q. Public, Esq.
N
目的:表示姓名,包括姓、名、中间名、前缀和后缀。
例子:
N:Public;John;Quinlan;Mr.;Esq.
N:Stevenson;John;Philip,Paul;Dr.;Jr.,M.D.,A.C.P.
各个组成部分可以用分号分号,每个组成部分可以用逗号。
NICKNAME
目的:表示别名、昵称
例子:
NICKNAME:Robbie
NICKNAME:Jim,Jimmie
PHOTO
目的:vcard对象的图像信息
ENCODING:默认是 uri,可以显式指定为 b,表示编码为内联的二进制数据
VALUE:默认是二进制值,可以显式指定为 uri 的值
TYPE:指定图像格式(主要用于内联二进制使用)
例子:
PHOTO;VALUE=uri:http://www.abc.com/pub/photos/jqpublic.gif
PHOTO;ENCODING=b;TYPE=JPEG:MIICajCCAdOgAwIB