手机开发实战124——VCARD介绍2

协议介绍

VCard 数据格式的标识符是VCARD

预定义的值类型：uri, date, date-time, float 

新增加的值类型：binary, phone-number, utc-offset and vcard value

预定义的类型：SOURCE, NAME, PROFILE, BEGIN, END.

新增加的类型：FN, N, NICKNAME, PHOTO, BDAY, ADR, LABEL, TEL, EMAIL,

MAILER, TZ, GEO, TITLE, ROLE, LOGO, AGENT, ORG, CATEGORIES, NOTE,

PRODID, REV, SORT-STRING, SOUND, URL, UID, VERSION, CLASS, KEY

预定义的参数：ENCODING, VALUE, CHARSET, LANGUAGE, CONTEXT.

新增加的参数：TYPE

vCard数据格式行是:  类型 [;参数]:值

    ADR;HOME;POSTAL;PARCEL:;;街道地址;深圳;广东;433330;中国

ADR：是一个类型，表示是一条地址信息

      “;”号是分隔符合

      HOME;POSTAL;PARCEL表示参数，表示ADR的用途或者是类别

      :;;街道地址;深圳;广东;433330;中国表示是一个ADR值，地址值

 

预定义类型的用法

BEGIN 和 END 类型

   Vcard内容必须以BEGIN:VCARD开头，以END:VCARD结尾

   参考一个vcard的例子1：

BEGIN:VCARD

VERSION:2.1

N:周;鹏

FN:周鹏

NICKNAME:nickName

ORG:深圳敖天;部门

TITLE:职位

NOTE;ENCODING=QUOTED-PRINTABLE:=C6=E4=CB=FB

TEL;WORK;VOICE:电话1

TEL;WORK;VOICE:电话2

TEL;HOME;VOICE:电话1

TEL;HOME;VOICE:电话2

TEL;CELL;VOICE:13590342862

TEL;PAGER;VOICE:0755

TEL;WORK;FAX:传真

TEL;HOME;FAX:传真

ADR;WORK:;;单位地址;深圳;广东;433000;国家

LABEL;WORK;ENCODING=QUOTED-PRINTABLE:=B5=A5=CE=BB=B5=D8=D6=B7

=C9=EE=DB=DA

=B9=E3=B6=AB

433000

=B9=FA=BC=D2

ADR;HOME;POSTAL;PARCEL:;;街道地址;深圳;广东;433330;中国

LABEL;HOME;ENCODING=QUOTED-PRINTABLE:=BD=D6=B5=C0=B5=D8=D6=B7

=C9=EE=DB=DA

=B9=E3=B6=AB

433330

=D6=D0=B9=FA

URL:http://

URL:单位主页

EMAIL;PREF;INTERNET:guodc@139.com

X-QQ:38394246

X-ICQ:icq

X-WAB-GENDER:2

REV:20060220T180305Z

END:VCARD

 

NAME 类型

如果在内容中出现NAME类型，那么它的值是一个可以显示的，描述vCard源的文本 

 

PROFILE类型

   如果出现PROFILE类型，那么它的值必须是“VCARD”  

 SOURCE 类型

 如果包含SOURCE类型，它的值提供一些怎样找到vCard源的信息

 

预定参数的用法

 LANGUAGE

 参考[MIME-DIR]文档

 ENCODING

参考[MIME-DIR]文档

 VALUE

参考[MIME-DIR]文档

预定义值类型的用法

   在[MIME-DIR]中预定类型的值一定不能包含用逗号分开的列表，除N，NICKNAME, ADR和 CATEGORIES值类型外。

  

 预定义值类型的扩展

BINARY

表明类型的值是二进制的，主要应用在类型PHOTO, LOGO, SOUND, and KEY中.

ENCODING参数的值必须指定为“B”

        二进制的内容的编码参考[RFC 2047]

VCARD

表示一个类型的值是一个vCard对象

PHONE-NUMBER

   表示类型的值是一个电话号码

UTC-OFFSET

   表示时间

结构类型的值

   复合类型值是用分号分开的字段的集合，复合类型值中避免使用分号，如何需要使用分号，需要用“\分号“替代

行的限定和分行

参考[MIME DIR]，如果行的长度超过了75个字符，那么必须分行。

 

 VCard 特征

标识类型

FN 类型定义

 目的：vcard对象的名称，一个vcard对象必须包含FN类型。

 例子：FN:Mr. John Q. Public\, Esq.

N类型定义

目的：FN表示一个vcard对象的名称，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对象的图像信息

例子：PHOTO;VALUE=uri:http://www.abc.com/pub/photos/jqpublic.gif

      PHOTO;ENCODING=b;TYPE=JPEG:MIICajCCAdOgAwIBAgICBEUwDQYJKoZIhvcN

         AQEEBQAwdzELMAkGA1UEBhMCVVMxLDAqBgNVBAoTI05ldHNjYXBlIENvbW11bm

         ljYXRpb25zIENvcnBvcmF0aW9uMRwwGgYDVQQLExNJbmZvcm1hdGlvbiBTeXN0

         <...remainder of "B" encoded binary data...>

   如果使用内联的二进制数据表示图片信息，那么;ENCODING=b

BDAY类型定义

目的：表示出生日期

例子：BDAY:1996-04-15

        BDAY:1953-10-15T23:10:00Z

        BDAY:1987-09-27T08:30:00-06:00

地址类型

ADR 类型定义

目的：是一个组合，用来表示一个地址信息，值类型是一个用分号分开的文本值

例子：ADR;TYPE=dom,home,postal,parcel:;;123 Main Street;Any Town;CA;91921-1234;A

ADR;HOME;POSTAL;PARCEL:;;街道地址;深圳;广东;433330;中国

        组合由一下部分顺序的组成：

the post office box;

the extended address;

the street address;

the locality (e.g., city);

the region (e.g., state or  province);

the postal code;

the country name

七个部分组成，如果，其他的一个部分没有，必须用分号分开

 type 参数的说明

"dom"  国内地址

"intl" 国际地址

"parcel"包裹递送地址

"home" 居住地址;

"work"工作地址;

"pref" 有多个地址的时候，优先的地址

缺省的"TYPE=intl,postal,parcel,work"，可以替换