UC浏览器开放参数使用说明.doc

1、 UC 浏览器开放参数使用说明目 录1 UC 浏览器客户端公共参数概述 .21.1 客户端公共参数的作用 -21.2 UC 浏览器开放参数说明 -21.3 客户端公共参数详细说明 -32 开放参数获取方式 .73 常见问题以及说明 .83.1 UC 浏览器直连和中转两种访问方式有何异同？ -83.2 直连/中转方式对获取公共参数的限制 -93.3 302 跳转不支持公共参数传递的处理方法 -91 UC 浏览器客户端公共参数概述1.1 客户端公共参数的作用Web/Wap 应用通过 URL 传递参数的方式向 UC 浏览器按需获取需要的信息。开放参数信息可以快捷的帮助 Web/Wap 应用对 UC

2、浏览器适配。通过获取分辨率、平台、联网方式等信息进行优化，给用户提供更好移动互联网访问体验。1.2 UC 浏览器开放参数说明UC 浏览器公共参数面向所有合法 WEB/WAP 应用开放。合法 WEB/WAP 应用可以根据 UC 浏览器公共参数获取协议按需获取公共参数。值得注意的是：有些开放参数只是在特定版本中可获取，较低版本的 UC 浏览器可能存在不能获取公参的情况。以下为公共参数的数据字典及与 UC 浏览器版本的对应关系：序号 客户端参数 参数描述 适用 UC 浏览器版本1 up 手机品牌、系统参数 7.8 版本及以上2 ss 手机分辨率参数 7.8 版本及以上3 nt 客户端联网方式参数 7

3、.2 版本及以上4 dn 客户端序列号 7.2 版本及以上5 ve 客户端版本号 7.2 版本及以上6 la 客户端语言环境 7.7 版本及以上7 mi 客户端 UA 7.8 版本及以上1.3 客户端公共参数详细说明1.3.1 up 参数描述：up 参数是指 UC 浏览器客户端安装手机的机型属性。机型属性包括：手机的品牌、手机机型、手机平台、手机系列。参数传输时，进行 urlencode 编码。用途举例：针对手机机型的软件下载。格式：采用结构化的字符串表示手机的品牌、手机机型、手机平台、手机系列，字符串的采用Key:Value;Key:Value;的形式。如用户使用的手机为 Nokia5800

4、，则具体结构为：s:S60V5|f:sis|m:5800|b:Nokia其中：s：对应的值是手机系列。如 S60V3。f：对应的值是手机平台。如 sis，表示 Symbian 平台。m：对应的值是手机机型。如 5800。b：对应的值是手机品牌。如 Nokia。1.3.2 ss 参数描述：ss 是指安装 UC 浏览器的手机的屏幕参数，即屏幕的宽和高，单位为像素。用途举例：Web/Wap 通过获取 ss 参数拿到用户手机分辨率信息后，可以根据用户屏幕特点，进行定制的网页适配以获得最佳的现实效果。游戏类网站也可以通过 ss 参数给用户适配合适用户手机屏幕分辨率的相应游戏。格式：采用宽度 x 高度的方

5、式，例如：320x2401.3.3 nt 参数描述：nt 指的是用户使用 UC 浏览器访问互联网的联网形式。包括 wap 访问、net 访问、wifi访问。用途举例对于下载或耗费流量较大的 WEB/WAP 应用，通过获取 nt 参数，可以有针对性的给用户提供最适应资源。若收到 nt 值为 2，表示用户使用 wifi 上网，那么可以考虑适当的推送高质量的资源给用户。格式：采用数字代表联网方式：代号 联网方式0 wap1 net2 wifi99 缺省1.3.4 dn 参数描述：dn 指的是客户端安装序列号，为用户的手机安装 UC 浏览器后由浏览器云端随机生成的一个字符串。每一个手机上的 UC 浏览

6、器客户端都拥有唯一的 dn 值。当用户卸载 UC 浏览器后再执行安装 UC 浏览器的操作，dn 值将再次随机生成。用途举例：在非强制注册的 Web/Wap 应用中，可以用 dn 做为用户标记参数。因为 dn 具有唯一性，故阅读类网站可以用于记录用户历史阅读记录、视频类网站可以用于记录观看历史。格式：例如 1234567-abcdefg1.3.5 ve 参数描述：ve 指的是 UC 浏览器客户端版本号。用于识别用户使用 UC 浏览器的版本号信息。用途举例：UC 浏览器 7.7 及以上版本支持支付宝在线快捷支付。有移动互联网支付需求的WEB/WAP 应用可以根据用户的版本号进行支付流程的个性化定制

7、。格式：例如 7.7.0.85。1.3.6 la 参数描述：la 是指 UC 浏览器的使用语言环境。用途举例：有国际化需求的 Web/Wap 应用可以根据从 UC 浏览器获取的 la 的属性，推送相应国家语言的页面给用户。格式：采用国际标准的语言的英文缩写形式，例如：zh-cn：Chinese - Peoples Republic of Chinazh-sg：Chinese Singaporezh-tw：Chinese - Taiwanzh-hk： Chinese - Hong Kong SARzh-mo：Chinese - Macao SARen-us： English - United S

8、tatesen-gb： English - United Kingdomen-au：English - Australiaen-bz：English - Belizeen-ca： English Canada1.3.7 mi 参数描述：mi 是手机的 UA 字符串信息，包含用户手机完整的 UA 信息。参数传输时，使用urlencode 编码用途举例：mi 包含用户手机的原始 UA 信息，可供 Web/Wap 应用获取原始数据，做更深层次的用户数据分析。格式：与标准的浏览器 UA 相同。2 开放参数获取方式Web/Wap 应用在网页 URL 中包含申请 UC 浏览器公参请求字符串：uc_para

9、m_str如：http:/ 浏览器接收到公参申请请求后返回相应数据如：http:/ s:S60V5|f:sis|m:5800|b:Nokia说明：1) uc_param_str 字符串位于 url 的参数部分，uc_param_str 的值指明了需要返回的开放参数。2) uc_param_str 采用固定位的格式，每两个字节表示一个参数，例如：uc_param_str=dnup 表示要获取 dn（浏览器安装序列号）和 up（手机机型信息）3) uc_param_str 应该是全小写。具体的标识串是“uc_param_str=”。客户端只对 url 查找“uc_param_str=”字符串作为是

10、否进行参数判的条件。值判断是从= 开始，遇到&或# 结束（或者是整个 url 结束）。3 常见问题以及说明3.1 UC 浏览器直连和中转两种访问方式有何异同？3.1.1 直连访问方式直连访问方式的定义：UC 浏览器客户端直接访问目标网页所在的服务器，读取原始网页代码，在客户端进行解析。直连访问的适用范围：通常是一些 WAP 网站，这些 WAP 网站一般是面向手机客户端而设计，其数据量以及格式方便客户端直接解析，因此 WAP 网站通常采用直连访问方式。UC 浏览器目前已支持 XHTML 网站。3.1.2 中转访问方式中转访问方式的定义：当用户使用 UC 浏览器访问 HTML 格式的 WEB 应用

11、时，考虑到当前终端处理能力、无线网络带宽、运营商流量资费等限制，有必要通过中间件进行优化处理，为手机终端提供更快、更好的浏览体验。中转访问方式的适用范围：通常是一些 WEB 网站（一般称 WWW 网站） ，这些 WEB网站一般是面向 PC 客户端而设计，数据量以及格式不方便客户端直接解析给用户使用，因此需要 UC 的中间件服务器机型处理，采用中转访问方式。3.2 直连/ 中转方式对获取公共参数的限制通过中转方式访问，在以下场景时不支持公共参数传递： 通过图片请求 UC 浏览器公共参数 通过 css 请求请求 UC 浏览器公共参数 通过 302 跳转请求请求 UC 浏览器公共参数 通过 refresh 请求请求 UC 浏览器公共参数通过直连方式不受以上限制。