ucweb_parameter_use

1、 UC瀏覽器開放參數(shù)使用說明目 錄1 UC瀏覽器客戶端公共參數(shù)概述21.1 客戶端公共參數(shù)的作用21.2 UC瀏覽器開放參數(shù)說明21.3 客戶端公共參數(shù)詳細(xì)說明32 開放參數(shù)獲取方式73 常見問題以及說明83.1 UC瀏覽器直連和中轉(zhuǎn)兩種訪問方式有何異同？83.2 直連/中轉(zhuǎn)方式對獲取公共參數(shù)的限制93.3 302跳轉(zhuǎn)不支持公共參數(shù)傳遞的處理方法91 UC瀏覽器客戶端公共參數(shù)概述1.1 客戶端公共參數(shù)的作用Web/Wap應(yīng)用通過URL傳遞參數(shù)的方式向UC瀏覽器按需獲取需要的信息。開放參數(shù)信息可以快捷的幫助Web/Wap應(yīng)用對UC瀏覽器適配。通過獲取分辨率、平臺、聯(lián)網(wǎng)方式等信息進(jìn)行優(yōu)化，給用戶提

2、供更好移動互聯(lián)網(wǎng)訪問體驗(yàn)。1.2 UC瀏覽器開放參數(shù)說明UC瀏覽器公共參數(shù)面向所有合法WEB/WAP應(yīng)用開放。合法WEB/WAP應(yīng)用可以根據(jù)UC瀏覽器公共參數(shù)獲取協(xié)議按需獲取公共參數(shù)。值得注意的是：有些開放參數(shù)只是在特定版本中可獲取，較低版本的UC瀏覽器可能存在不能獲取公參的情況。以下為公共參數(shù)的數(shù)據(jù)字典及與UC瀏覽器版本的對應(yīng)關(guān)系：序號客戶端參數(shù)參數(shù)描述適用UC瀏覽器版本1up手機(jī)品牌、系統(tǒng)參數(shù)7.8版本及以上2ss手機(jī)分辨率參數(shù)7.8版本及以上3nt客戶端聯(lián)網(wǎng)方式參數(shù)7.2版本及以上4dn客戶端序列號7.2版本及以上5ve客戶端版本號7.2版本及以上6la客戶端語言環(huán)境7.7版本及以上7m

3、i客戶端UA7.8版本及以上1.3 客戶端公共參數(shù)詳細(xì)說明1.3.1 up參數(shù)描述：up參數(shù)是指UC瀏覽器客戶端安裝手機(jī)的機(jī)型屬性。機(jī)型屬性包括：手機(jī)的品牌、手機(jī)機(jī)型、手機(jī)平臺、手機(jī)系列。參數(shù)傳輸時(shí)，進(jìn)行urlencode編碼。用途舉例：針對手機(jī)機(jī)型的軟件下載。格式：采用結(jié)構(gòu)化的字符串表示手機(jī)的品牌、手機(jī)機(jī)型、手機(jī)平臺、手機(jī)系列，字符串的采用Key:Value;Key:Value;的形式。如用戶使用的手機(jī)為Nokia5800，則具體結(jié)構(gòu)為：s:S60V5|f:sis|m:5800|b:Nokia其中：s：對應(yīng)的值是手機(jī)系列。如S60V3。f：對應(yīng)的值是手機(jī)平臺。如sis，表示Symbian平臺

4、。 m：對應(yīng)的值是手機(jī)機(jī)型。如5800。b：對應(yīng)的值是手機(jī)品牌。如Nokia。1.3.2 ss參數(shù)描述：ss是指安裝UC瀏覽器的手機(jī)的屏幕參數(shù)，即屏幕的寬和高，單位為像素。用途舉例：Web/Wap通過獲取ss參數(shù)拿到用戶手機(jī)分辨率信息后，可以根據(jù)用戶屏幕特點(diǎn)，進(jìn)行定制的網(wǎng)頁適配以獲得最佳的現(xiàn)實(shí)效果。游戲類網(wǎng)站也可以通過ss參數(shù)給用戶適配合適用戶手機(jī)屏幕分辨率的相應(yīng)游戲。格式：采用寬度x高度的方式，例如：320x2401.3.3 nt參數(shù)描述：nt指的是用戶使用UC瀏覽器訪問互聯(lián)網(wǎng)的聯(lián)網(wǎng)形式。包括wap訪問、net訪問、wifi訪問。用途舉例對于下載或耗費(fèi)流量較大的WEB/WAP應(yīng)用，通過獲取n

5、t參數(shù)，可以有針對性的給用戶提供最適應(yīng)資源。若收到nt值為2，表示用戶使用wifi上網(wǎng)，那么可以考慮適當(dāng)?shù)耐扑透哔|(zhì)量的資源給用戶。格式：采用數(shù)字代表聯(lián)網(wǎng)方式：代號聯(lián)網(wǎng)方式0 wap1 net2 wifi99 缺省1.3.4 dn參數(shù)描述：dn指的是客戶端安裝序列號，為用戶的手機(jī)安裝UC瀏覽器后由瀏覽器云端隨機(jī)生成的一個字符串。每一個手機(jī)上的UC瀏覽器客戶端都擁有唯一的dn值。當(dāng)用戶卸載UC瀏覽器后再執(zhí)行安裝UC瀏覽器的操作，dn值將再次隨機(jī)生成。用途舉例：在非強(qiáng)制注冊的Web/Wap應(yīng)用中，可以用dn做為用戶標(biāo)記參數(shù)。因?yàn)閐n具有唯一性，故閱讀類網(wǎng)站可以用于記錄用戶歷史閱讀記錄、視頻類網(wǎng)站可以

6、用于記錄觀看歷史。格式：例如1234567-abcdefg1.3.5 ve參數(shù)描述：ve指的是UC瀏覽器客戶端版本號。用于識別用戶使用UC瀏覽器的版本號信息。用途舉例：UC瀏覽器7.7及以上版本支持支付寶在線快捷支付。有移動互聯(lián)網(wǎng)支付需求的WEB/WAP應(yīng)用可以根據(jù)用戶的版本號進(jìn)行支付流程的個性化定制。格式：例如5。1.3.6 la參數(shù)描述： la是指UC瀏覽器的使用語言環(huán)境。用途舉例：有國際化需求的Web/Wap應(yīng)用可以根據(jù)從UC瀏覽器獲取的la的屬性，推送相應(yīng)國家語言的頁面給用戶。格式：采用國際標(biāo)準(zhǔn)的語言的英文縮寫形式，例如：zh-cn：Chinese - Peoples R

7、epublic of Chinazh-sg：Chinese Singaporezh-tw：Chinese - Taiwanzh-hk：Chinese - Hong Kong SARzh-mo：Chinese - Macao SARen-us：English - United Statesen-gb：English - United Kingdomen-au：English - Australiaen-bz：English - Belizeen-ca：English Canada1.3.7 mi參數(shù)描述：mi是手機(jī)的UA字符串信息，包含用戶手機(jī)完整的UA信息。參數(shù)傳輸時(shí)，使用urlencode編

8、碼用途舉例：mi包含用戶手機(jī)的原始UA信息，可供Web/Wap應(yīng)用獲取原始數(shù)據(jù)，做更深層次的用戶數(shù)據(jù)分析。格式：與標(biāo)準(zhǔn)的瀏覽器UA相同。2 開放參數(shù)獲取方式Web/Wap應(yīng)用在網(wǎng)頁URL中包含申請UC瀏覽器公參請求字符串：uc_param_str如：UC瀏覽器接收到公參申請請求后返回相應(yīng)數(shù)據(jù)如： s:S60V5|f:sis|m:5800|b:Nokia說明：1) uc_param_str字符串位于url的參數(shù)部分，uc_param_str的值指明了需要返回的開放參數(shù)。2) uc_param_str采用固定位的格式，每兩個字節(jié)表示一個參數(shù)，例如：uc_param_str=dnup表示要獲取dn（

9、瀏覽器安裝序列號）和up（手機(jī)機(jī)型信息）3) uc_param_str應(yīng)該是全小寫。具體的標(biāo)識串是“uc_param_str=”?？蛻舳酥粚rl查找“uc_param_str=”字符串作為是否進(jìn)行參數(shù)判的條件。值判斷是從=開始，遇到&或#結(jié)束（或者是整個url結(jié)束）。3 常見問題以及說明3.1 UC瀏覽器直連和中轉(zhuǎn)兩種訪問方式有何異同？3.1.1 直連訪問方式直連訪問方式的定義：UC瀏覽器客戶端直接訪問目標(biāo)網(wǎng)頁所在的服務(wù)器，讀取原始網(wǎng)頁代碼，在客戶端進(jìn)行解析。直連訪問的適用范圍：通常是一些WAP網(wǎng)站，這些WAP網(wǎng)站一般是面向手機(jī)客戶端而設(shè)計(jì)，其數(shù)據(jù)量以及格式方便客戶端直接解析，因此WAP網(wǎng)站

10、通常采用直連訪問方式。UC瀏覽器目前已支持XHTML網(wǎng)站。3.1.2 中轉(zhuǎn)訪問方式中轉(zhuǎn)訪問方式的定義：當(dāng)用戶使用UC瀏覽器訪問HTML格式的WEB應(yīng)用時(shí)，考慮到當(dāng)前終端處理能力、無線網(wǎng)絡(luò)帶寬、運(yùn)營商流量資費(fèi)等限制，有必要通過中間件進(jìn)行優(yōu)化處理，為手機(jī)終端提供更快、更好的瀏覽體驗(yàn)。中轉(zhuǎn)訪問方式的適用范圍：通常是一些WEB網(wǎng)站（一般稱WWW網(wǎng)站），這些WEB網(wǎng)站一般是面向PC客戶端而設(shè)計(jì)，數(shù)據(jù)量以及格式不方便客戶端直接解析給用戶使用，因此需要UC的中間件服務(wù)器機(jī)型處理，采用中轉(zhuǎn)訪問方式。3.2 直連/中轉(zhuǎn)方式對獲取公共參數(shù)的限制通過中轉(zhuǎn)方式訪問，在以下場景時(shí)不支持公共參數(shù)傳遞：n 通過圖片請求UC瀏覽器公共參數(shù)n 通過css請求請求UC瀏覽器公共參數(shù)n 通過302跳轉(zhuǎn)請求請求UC瀏覽器公共參數(shù)n 通過refresh請求請求UC瀏覽器公共參數(shù)通過直連方式不受以上限制。